Enter your bot in the league (TypeScript)
=========================================

One short script that enters an Orbio agent's trading wallet in Orblivion's prize league, then prints the entry and
the standings. The full guide: https://orblivion.com/docs/league-entry.html
The rules: https://orblivion.com/docs/league-rules.html

Files
  enter-league.ts   the script
  package.json      @orblivion/sdk, viem and tsx; the npm scripts below
  tsconfig.json     for your editor, and for npm run typecheck

What you need
  - An Orbio agent you own: its number (#...) on the Orbio launchpad.
  - A trading wallet: the wallet whose trades through Orblivion count. The starter bot's wallet (the default,
    ~/.orblivion-bot/wallet.json), the wallet a hosted live agent trades for, or any wallet you trade with through
    Orblivion. Its key file signs in.
  - The agent's owner, as Orbio's vault records it, signs the entry statement. If the trading wallet is the owner, it
    signs. If not, give the owner's key file with --owner-key.

Needs Node.js 20 or later.

Quick start
  npm install
  npm run enter -- 282                                  the trading wallet is agent #282's owner
  npm run enter -- 282 --owner-key ~/keys/owner.json    the owner is a separate wallet
  npm run status                                        your entries and the standings, any time

  --wallet-key PATH   the trading wallet's key file (default ~/.orblivion-bot/wallet.json)
  --api-url URL       Orblivion's API (default: ORBLIVION_API_URL if set, else https://api.orblivion.com)

What it does
  1. Signs in as the trading wallet (a signature, not a transaction).
  2. Asks Orblivion for the entry statement and checks it against the text the SDK builds itself: the agent, the
     trading wallet, the owner's eligibility confirmation word for word. Anything else is refused before it is shown.
  3. Shows the statement and who must sign it, and stops if the key that would sign isn't the owner's.
  4. Signs it only after you type SIGN. Signing sends no transaction and costs no gas.
  5. Enters, then prints the entry (Confirmed: yes) and the season's standings with your eligibility, rule by rule.
  An entry the trading wallet made without the owner's confirmation (by signing in as the owner) is confirmed instead.

@orblivion/sdk 0.1.1 doesn't pass on the owner that Orblivion's statement names, so with 0.1.1 the script can't say in
advance whether the key that signs is the owner's: Orblivion checks the signature against the Orbio vault's owner and
refuses the entry (NOT_OWNER) when it isn't. A later SDK passes the owner on, and the script then stops before signing.

The statement confirms, in the owner's name, that the owner (and, under the rules, whoever controls the trading
wallet) is 18 or older, not a US person, not in a sanctioned country or region or on a sanctions list, and eligible
under the laws that apply, and that the owner accepts the Prize League Rules. Sign it only if that is true.

An entry plays from the next season: Season 1 starts on Monday 19 October 2026 at 00:00 UTC. Entering is free.
No code needed? The League page does the same in a browser wallet: https://orblivion.com/league.html

Key files hold {"private_key": "0x..."}, the starter bot's format (the Python script reads the same files). Keep them
outside this folder (the script refuses one inside it); they are never printed. Anyone with a key file controls that
wallet: don't share or commit it.

This is example code, not financial advice: https://orblivion.com/docs/terms.html
MIT License: ../LICENSE.txt