@antseed/cli 0.1.156 → 0.1.158

package/README.md

@@ -13,9 +13,27 @@ Command-line interface and web dashboard for the AntSeed Network — a P2P netwo
 | **Providing** | |
 | `antseed seller start` | Start providing AI services on the P2P network |
 | `antseed seller register` | Register peer identity on-chain (ERC-8004) |
-| `antseed seller stake <amount>` | Stake USDC as a provider (min $10) |
-| `antseed seller unstake` | Withdraw staked USDC |
-| `antseed seller emissions claim` | Claim accumulated seller payouts |
+| `antseed seller stake <ants> --epochs <n>` | Stake ANTS into your seller pool; never stakes USDC |
+| `antseed seller legacy stake <amount>` | Stake USDC as a provider before cutover (min $10) |
+| `antseed seller legacy unstake` | Withdraw legacy USDC stake |
+| `antseed seller legacy claim-starter` | Claim the legacy-seller starter ANTS position after the recognized-usage upgrade |
+| `antseed seller pool positions` | List seller-pool positions and lifecycle state |
+| `antseed seller pool withdraw <id...> [--accept-slashing]` | Withdraw positions, with a slashing estimate and confirmation for early exits |
+| `antseed seller rewards [claim]` | View or claim all seller rewards |
+| **ANTS staking** | |
+| `antseed ants` | Open the local ANTS staking dashboard (wallet-signed, `--port`, `--no-open`) |
+| `antseed ants status` | Protocol phase, epoch countdown, balances, stake, claimable rewards |
+| `antseed ants stake <ants> --agent <id> --epochs <n>` | Stake ANTS into any registered seller pool |
+| `antseed ants positions` | List open lANTS positions with state, pending rewards, and exit slash |
+| `antseed ants move <id...> --to <agent>` | Move positions to another pool (terms preserved, effective next epoch) |
+| `antseed ants split <id> <ants>` / `merge <id...>` | Split a position or merge same-pool positions |
+| `antseed ants extend <id> --epochs <n>` / `max-lock <id> [--off]` | Extend a lock or toggle max lock |
+| `antseed ants withdraw <id...> [--preview] [--accept-slashing]` | Withdraw with a slashing estimate and explicit consent for early exits |
+| `antseed ants rewards [claim\|compound\|restake\|stake-usage]` | View, claim, or restake rewards; `compound` restakes every restakable bucket in one go |
+| `antseed ants pools` / `pool <agent>` | Compare pools: power and share of network, settled volume per epoch, staker ANTS per 1k power (last and projected), your power and share; explorer names via Antscan |
+| `antseed ants usage` / `emissions` / `addresses` | Usage points per epoch, emission schedule and buckets, contract addresses |
+| `antseed ants seller [register\|claim-starter]` | Seller binding, eligibility, and starter grant |
+| `antseed ants verify [seller]` / `verify submit <artifact.json>` / `verify proof <id>` | Wash-trading status, resumable proof submission, proof progress |
 | **Buying** | |
 | `antseed buyer start` | Start the buyer proxy and connect to sellers |
 | `antseed buyer start --router <name>` | Start the buyer proxy with a non-default router |
@@ -40,7 +58,6 @@ Command-line interface and web dashboard for the AntSeed Network — a P2P netwo
 | `antseed dashboard` | Start the web dashboard |
 | `antseed metrics serve` | Serve Prometheus metrics for buyers and sellers |
 | `antseed buyer channels` | List payment channels |
-| `antseed seller emissions info` | View ANTS emissions and epoch info |
 | `antseed dev` | Run seller + buyer locally for testing |
 | `antseed network bootstrap` | Run a dedicated DHT bootstrap node |
 
@@ -329,7 +346,56 @@ For tools that can only set a model name, use `<peerId>@<model>` as the model. T
 
 Payments run on **Base Mainnet** by default. Contract addresses are resolved automatically — no manual configuration needed.
 
-### Provider Setup (Selling)
+**Protocol start: September 10, 2026 at 09:54:21 UTC (epoch 22).**
+See [Recognized Usage and ANTS Rewards](../website/docs/protocol/recognized-usage.md)
+for ANTS pool positions, seller eligibility, and usage rewards. The SDK exposes
+the contract inventory as `getChainConfig('base-mainnet').recognizedUsage`.
+See [Reward Policies](../website/docs/protocol/reward-policies.md) for how usage
+points are adjusted and historical wash-trading evidence affects rewards.
+
+Looking for pre-migration USDC staking or rewards? See
+[Legacy emissions and claims](../website/docs/protocol/legacy-emissions.md).
+The setup commands below use that legacy USDC interface; they do not create
+ANTS pool positions.
+
+### ANTS Staking Dashboard and Commands
+
+`antseed ants` starts a local dashboard on `http://127.0.0.1:3119` and opens it
+in your browser. It signs with the node wallet in `--data-dir`, binds to
+localhost only, and requires the one-time session token embedded in the URL
+it prints, so no other page can act with your wallet. Pass `--no-open` to
+print the URL only, or `--port` to change the port.
+
+Pool statistics, volume history, and closed positions come from the Antscan
+indexer (`payments.crypto.explorerApiUrl`); the chain is read only for your
+wallet's live state and when sending transactions.
+
+Everything the dashboard does is also a command under `antseed ants`, so the
+dashboard is optional:
+
+```bash
+antseed ants status                                   # phase, epoch countdown, balances, claimable rewards
+antseed ants stake 250 --agent 84990 --epochs 12      # stake into a registered seller pool
+antseed ants positions --json                         # positions, pending rewards, exit slash
+antseed ants split 7 100 && antseed ants merge 8 9    # restructure (effective next epoch)
+antseed ants move 7 --to 84991                        # move stake to another pool
+antseed ants withdraw 7 --preview                     # slashing estimate before an early exit
+antseed ants rewards && antseed ants rewards claim    # all buckets: staker, seller, buyer, legacy, locked
+antseed ants rewards compound --epochs 8 --to 59096   # restake all rewards (bonus kept), move them into pool 59096
+antseed ants verify submit seller-proof.json          # stage → authenticate chunks → finalize
+```
+
+Before the cutover (phase `deployed`) the commands read the deployed contracts
+and can stake once ANTS transfers are enabled for your wallet; reward accounting
+starts at the effective epoch. Buyer usage rewards are paid to the deposits
+operator, so they are claimable here only when the node wallet is its own
+operator. Loop-proof artifacts come from the `antseed-loop-proof` host
+(`kind: antseed-wash-trading-seller-proof`); submission is resumable, so a
+partially authenticated proof can be re-submitted with the same file.
+The [staking guide](../website/docs/guides/staking.md) walks through the
+dashboard tabs and how to read the pool table.
+
+### Legacy USDC Provider Setup (Pre-Migration)
 
 ```bash
 # 1. Set your identity (secp256k1 private key)
@@ -341,12 +407,69 @@ export ANTSEED_IDENTITY_HEX=<your-private-key-hex>
 antseed seller register
 
 # 4. Stake USDC (minimum $10)
-antseed seller stake 10
+antseed seller legacy stake 10
 
 # 6. Start providing
 antseed seller start
 ```
 
+After the M001 recognized-usage cutover, new seller stake moves from legacy USDC staking to ANTS seller pools:
+
+```bash
+antseed seller register
+antseed seller legacy claim-starter
+antseed seller stake 100 --epochs 4
+antseed seller pool positions
+antseed seller rewards
+antseed seller rewards claim
+```
+
+`antseed seller stake <ants> --epochs <n>` always stakes ANTS and requires the recognized-usage upgrade. On older networks it stops without sending a transaction and directs you to `antseed seller legacy stake <usdc>`. New legacy USDC stakes are rejected after the upgrade. `antseed seller legacy unstake` withdraws legacy stake and warns that doing so can remove temporary eligibility before an ANTS position becomes active. `antseed seller legacy claim-starter` claims the starter position for an eligible legacy seller. `antseed seller rewards` combines legacy emissions, recognized-use emissions, and pool-staking rewards.
+
+`seller register` explicitly binds your existing agent identity to the current seller registry, independently of legacy stake. Repeating it when already bound sends no transaction. If registration needs updating, `seller stake` stops and asks you to run `antseed seller register`; staking never registers you silently.
+
+`seller rewards` is read-only: it calculates unclaimed rewards from completed epochs using existing contract getters, including pool earnings that have not yet been indexed. It does not sign transactions or spend gas. Pool previews use the same reward-index and position-segment rounding as the payout calculation. The pool contribution is read at a single block; amounts can change before a claim confirms. Historical position discovery includes withdrawn and closed positions using receipt burn events and may require an archive-capable RPC with historical log support. Read failures are reported rather than treated as zero rewards.
+
+`seller rewards claim` prepares pool accounting in bounded transactions when necessary, then claims all eligible seller rewards to the current wallet. Preparation and claims require gas. Confirmed transaction hashes are printed immediately, and received amounts are read from ANTS transfer receipts. If a later step fails, the CLI reports partial completion; rerun the command to collect remaining rewards. Position-specific claims and alternate reward recipients are not exposed by this minimal command.
+
+#### Command migration
+
+These are intentional command-surface breaks, not hidden aliases:
+
+| Removed command or behavior | Replacement |
+|---|---|
+| `seller stake <amount>` staking USDC | `seller legacy stake <usdc>` |
+| `seller stake --agent-id <id>` | Bind the identity with `seller register --agent-id <id>` first, then stake ANTS without an identity override |
+| `seller unstake` | `seller legacy unstake` |
+| `seller pool claim-starter`, `seller pool bootstrap`, `seller pool init` | `seller legacy claim-starter` |
+| `seller emissions info`, `seller pool rewards` | `seller rewards` |
+| `seller emissions claim`, `seller pool rewards claim` | `seller rewards claim` (all eligible rewards to the current wallet; no era, position, or recipient flags) |
+| `network contracts` | No replacement command; registry/address validation remains automatic inside payment commands |
+
+Buyer emissions commands and their `--legacy-only` / `--new-only` filters are unchanged.
+
+Early withdrawal requires `--accept-slashing` and interactive confirmation; add `--yes` for automation. The CLI rechecks the estimate before submitting. Existing contracts determine slashing at execution and do not accept a maximum-loss bound, so the displayed estimate is not a guaranteed cap if rates change before confirmation.
+
+### M001 Anvil rehearsal
+
+The repository includes a persistent Base-mainnet fork sandbox for exercising the exact pre-cutover and post-cutover CLI paths. It requires an archive-capable `BASE_MAINNET_RPC_URL` and an `ANTS_HOLDER` address with ANTS at the pinned fork block. Seller USDC is sourced from the forked legacy staking contract.
+
+```bash
+export BASE_MAINNET_RPC_URL=https://your-archive-base-rpc.example
+export ANTS_HOLDER=0x...
+
+pnpm m001:sandbox up
+pnpm m001:sandbox status
+
+# Use .m001-sandbox/cli-config.json with CLI commands before cutover.
+pnpm m001:sandbox cutover
+pnpm m001:sandbox advance-epoch 2
+pnpm m001:sandbox fund-ants 0xYourCliWallet 100
+pnpm m001:sandbox down
+```
+
+Use `--port <port>` and `--out <dir>` on each sandbox command to override the defaults (`8545` and `.m001-sandbox/`).
+
 ### Buyer Setup (Consuming)
 
 ```bash
@@ -419,6 +542,12 @@ See [Metrics](../../apps/website/docs/guides/metrics.md) for metric names, label
 
 ## Development
 
+Blockchain access and reward calculations live in `@antseed/node/payments`.
+The CLI uses those SDK clients for registration, position discovery, reward
+previews/claims, slashing estimates, and confirmed token receipts. Command
+parsing, output, actionable instructions, and withdrawal confirmation stay in
+the CLI; it has no direct `ethers` dependency.
+
 ```bash
 npm install
 npm run build

package/dist/cli/commands/ants/addresses.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerAntsAddressesCommand(antsCmd: Command): void;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/cli/commands/ants/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAanE"}

package/dist/cli/commands/ants/addresses.js

@@ -0,0 +1,20 @@
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { printJson, runRead } from './shared.js';
+export function registerAntsAddressesCommand(antsCmd) {
+    antsCmd
+        .command('addresses')
+        .description('Contract addresses in use')
+        .option('--json', 'output as JSON', false)
+        .action(async (options) => runRead(antsCmd, 'Loading addresses...', async ({ ctx, chain }) => {
+        const addresses = ctx.addresses();
+        if (options.json)
+            return printJson({ chainId: chain.chainId, evmChainId: chain.evmChainId, rpcUrl: chain.rpcUrl, addresses });
+        const table = new Table({ head: ['Contract', 'Address'] });
+        for (const [name, address] of Object.entries(addresses))
+            table.push([name, String(address)]);
+        console.log(table.toString());
+        console.log(chalk.dim(`${chain.chainId} via ${chain.rpcUrl}`));
+    }));
+}
+//# sourceMappingURL=addresses.js.map

package/dist/cli/commands/ants/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/addresses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;QAC9G,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9H,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/cli/commands/ants/addresses.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=addresses.test.d.ts.map

package/dist/cli/commands/ants/addresses.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/addresses.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/ants/addresses.test.js

@@ -0,0 +1,12 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Command } from 'commander';
+import { registerAntsAddressesCommand } from './addresses.js';
+test('addresses offers JSON output', () => {
+    const ants = new Command('ants');
+    registerAntsAddressesCommand(ants);
+    const addresses = ants.commands.find((command) => command.name() === 'addresses');
+    assert.ok(addresses);
+    assert.ok(addresses.options.some((option) => option.long === '--json'));
+});
+//# sourceMappingURL=addresses.test.js.map

package/dist/cli/commands/ants/addresses.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.test.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/addresses.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAE9D,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;IACxC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,WAAW,CAAC,CAAC;IAClF,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC"}

package/dist/cli/commands/ants/arguments.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=arguments.test.d.ts.map

package/dist/cli/commands/ants/arguments.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/arguments.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/ants/arguments.test.js

@@ -0,0 +1,51 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Command } from 'commander';
+import { parsePositiveInteger } from '../parse-positive-integer.js';
+import { registerAntsCommands } from './index.js';
+async function parse(args) {
+    const program = new Command().exitOverride().configureOutput({ writeErr: () => { } });
+    registerAntsCommands(program);
+    let options = {};
+    const capture = (command) => {
+        command.action(() => { options = command.opts(); });
+        for (const child of command.commands)
+            capture(child);
+    };
+    capture(program);
+    await program.parseAsync(['ants', ...args], { from: 'user' });
+    return options;
+}
+test('usage epochs are decimal regardless of the default or previous value', async () => {
+    assert.equal((await parse(['usage'])).epochs, 8);
+    assert.equal((await parse(['usage', '--epochs', '10'])).epochs, 10);
+    assert.equal((await parse(['usage', '--epochs', '8'])).epochs, 8);
+    assert.equal((await parse(['usage', '--epochs', '7', '--epochs', '10'])).epochs, 10);
+});
+test('repeated destination and epoch options use the last decimal value', async () => {
+    assert.deepEqual(await parse(['stake', '1', '--agent', '7', '--agent', '10', '--epochs', '4', '--epochs', '12']), { agent: 10, epochs: 12 });
+    assert.equal((await parse(['move', '1', '--to', '7', '--to', '10'])).to, 10);
+    assert.equal((await parse(['rewards', 'compound', '--epochs', '4', '--to', '7', '--to', '10'])).to, 10);
+});
+test('integer parsing rejects malformed, fractional, zero, negative, and unsafe values', () => {
+    for (const value of ['12garbage', '4.8', '1e2', '0x10', '0', '-1', '', ' ', '9007199254740992']) {
+        assert.throws(() => parsePositiveInteger(value), /positive safe integer/);
+    }
+    assert.equal(parsePositiveInteger('10'), 10);
+});
+test('invalid numeric flags fail during parsing before a command action runs', async () => {
+    for (const args of [
+        ['stake', '1', '--agent', '12garbage', '--epochs', '4'],
+        ['stake', '1', '--agent', '7', '--epochs', '4.8'],
+        ['move', '1', '--to', '12garbage'],
+        ['extend', '1', '--epochs', '4.8'],
+        ['usage', '--epochs', '0'],
+        ['rewards', 'restake', '--epochs', '4.8'],
+        ['rewards', 'compound', '--epochs', '4', '--to', '12garbage'],
+        ['rewards', 'stake-usage', '--side', 'buyer', '--epochs', '4', '--agent', '12garbage'],
+        ['seller', 'register', '--agent-id', '12garbage'],
+    ]) {
+        await assert.rejects(parse(args), { code: 'commander.invalidArgument' });
+    }
+});
+//# sourceMappingURL=arguments.test.js.map

package/dist/cli/commands/ants/arguments.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.test.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/arguments.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ants/dashboard.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare const DEFAULT_ANTS_PORT = 3119;
+export declare function registerAntsDashboardAction(antsCmd: Command): void;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/cli/commands/ants/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqClE"}

package/dist/cli/commands/ants/dashboard.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+import { createAntsServer } from '@antseed/ants';
+import { loadAntsContext } from './shared.js';
+export const DEFAULT_ANTS_PORT = 3119;
+export function registerAntsDashboardAction(antsCmd) {
+    antsCmd
+        .option('-p, --port <port>', 'dashboard port', String(DEFAULT_ANTS_PORT))
+        .option('--no-open', 'do not open the browser automatically')
+        .action(async (options) => {
+        const port = Number(options.port) || DEFAULT_ANTS_PORT;
+        try {
+            const { ctx, chain, dataDir, configPath } = await loadAntsContext(antsCmd);
+            const server = await createAntsServer({ port, dataDir, configPath, chain, signer: ctx.signer, address: ctx.address });
+            const url = await server.listen();
+            console.log('');
+            console.log(chalk.bold('ANTS staking dashboard'));
+            console.log(`  Wallet:  ${ctx.address}`);
+            console.log(`  Chain:   ${chain.chainId} (${chain.rpcUrl})`);
+            console.log(`  URL:     ${chalk.cyan(url)}`);
+            console.log(chalk.dim('  The URL carries a one-time session token; only this browser session can act with your wallet.'));
+            console.log(chalk.dim('  Every dashboard action has a CLI equivalent: antseed ants --help. Press Ctrl+C to stop.'));
+            console.log('');
+            if (options.open) {
+                try {
+                    const { default: open } = await import('open');
+                    await open(url);
+                }
+                catch {
+                    console.log(chalk.yellow('Could not open a browser automatically; open the URL above manually.'));
+                }
+            }
+            const shutdown = async () => {
+                await server.close();
+                process.exit(0);
+            };
+            process.on('SIGINT', () => { void shutdown(); });
+            process.on('SIGTERM', () => { void shutdown(); });
+        }
+        catch (error) {
+            console.error(chalk.red(`Failed to start the ANTS dashboard: ${error.message}`));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/cli/commands/ants/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/dashboard.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ants/dashboard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dashboard.test.d.ts.map

package/dist/cli/commands/ants/dashboard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/dashboard.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/ants/dashboard.test.js

@@ -0,0 +1,14 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Command } from 'commander';
+import { DEFAULT_ANTS_PORT, registerAntsDashboardAction } from './dashboard.js';
+test('antseed ants defaults to the dashboard with a port and --no-open switch', () => {
+    const ants = new Command('ants');
+    registerAntsDashboardAction(ants);
+    const port = ants.options.find((option) => option.long === '--port');
+    assert.ok(port);
+    assert.equal(port.defaultValue, String(DEFAULT_ANTS_PORT));
+    assert.equal(DEFAULT_ANTS_PORT, 3119);
+    assert.ok(ants.options.some((option) => option.long === '--no-open'));
+});
+//# sourceMappingURL=dashboard.test.js.map

package/dist/cli/commands/ants/dashboard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.test.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/dashboard.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAEhF,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACrE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAChB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC"}

package/dist/cli/commands/ants/emissions.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from 'commander';
+/** Share of the epoch emission as a percentage, e.g. 2000/100000 → "2%". */
+export declare function sharePercent(value: number, denominator: number): string;
+export declare function registerAntsEmissionsCommand(antsCmd: Command): void;
+//# sourceMappingURL=emissions.d.ts.map

package/dist/cli/commands/ants/emissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emissions.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/emissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiCnE"}

package/dist/cli/commands/ants/emissions.js

@@ -0,0 +1,44 @@
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { emissions, formatAnts } from '@antseed/ants';
+import { ants, epochDate, printJson, runRead } from './shared.js';
+/** Share of the epoch emission as a percentage, e.g. 2000/100000 → "2%". */
+export function sharePercent(value, denominator) {
+    return `${(value * 100 / denominator).toFixed(1).replace(/\.0$/, '')}%`;
+}
+export function registerAntsEmissionsCommand(antsCmd) {
+    antsCmd
+        .command('emissions')
+        .description('Emission schedule, gate buckets, and dynamic reward shares')
+        .option('--json', 'output as JSON', false)
+        .action(async (options) => runRead(antsCmd, 'Loading emissions...', async ({ ctx }) => {
+        const view = await emissions(ctx);
+        if (options.json)
+            return printJson(view);
+        const share = (value) => sharePercent(value, view.shareDenominator);
+        console.log(chalk.bold('Emissions\n'));
+        console.log(`  Genesis           ${epochDate(view.genesis, view.epochDuration, 0)}`);
+        console.log(`  Epoch length      ${view.epochDuration / 86_400} days`);
+        console.log(`  Current epoch     ${view.currentEpoch}${view.effectiveEpoch !== null ? ` (recognized usage from epoch ${view.effectiveEpoch})` : ''}`);
+        console.log(`  Initial emission  ${ants(view.initialEmission, 0)} per epoch, halving every ${view.halvingInterval} epochs`);
+        console.log(`  Current rate      ${formatAnts(view.currentRate)} ANTS per second`);
+        console.log(`  Emitted so far    ${ants(view.cumulativeThroughCurrent, 0)} (through the current epoch)`);
+        if (view.minters.length > 0) {
+            const table = new Table({ head: ['Bucket', 'Share', 'Controller', 'Editable', 'Budget this epoch'] });
+            for (const minter of view.minters) {
+                table.push([minter.name, `${(minter.shareBps * 100 / view.shareDenominator).toFixed(1)}%`, minter.controller, minter.editable ? 'yes' : 'no', ants(minter.epochBudget, 0)]);
+            }
+            console.log(table.toString());
+        }
+        if (view.dynamicStaker) {
+            console.log(chalk.dim(`  Staker rewards scale from ${share(view.dynamicStaker.minShareBps)} to ${share(view.dynamicStaker.maxShareBps)} of the epoch emission as active stake approaches ${formatAnts(view.dynamicStaker.stakeShareTarget, 0)} ANTS`));
+        }
+        if (view.dynamicUsage) {
+            console.log(chalk.dim(`  Usage rewards scale with volume (target ${(Number(view.dynamicUsage.volumeShareTarget) / 1e6).toLocaleString()} USDC/epoch): buyers ${share(view.dynamicUsage.buyerMinShareBps)}–${share(view.dynamicUsage.buyerMaxShareBps)}, sellers ${share(view.dynamicUsage.sellerMinShareBps)}–${share(view.dynamicUsage.sellerMaxShareBps)} of the epoch emission`));
+        }
+        if (view.legacy) {
+            console.log(chalk.dim(`  Legacy V2 ${view.legacy.contract}: sellers ${view.legacy.sellerPct}% / buyers ${view.legacy.buyerPct}% / reserve ${view.legacy.reservePct}% / team ${view.legacy.teamPct}%`));
+        }
+    }));
+}
+//# sourceMappingURL=emissions.js.map

package/dist/cli/commands/ants/emissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emissions.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/emissions.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ants/emissions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=emissions.test.d.ts.map

package/dist/cli/commands/ants/emissions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emissions.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/emissions.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/ants/emissions.test.js

@@ -0,0 +1,17 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Command } from 'commander';
+import { registerAntsEmissionsCommand, sharePercent } from './emissions.js';
+test('emissions offers JSON output', () => {
+    const ants = new Command('ants');
+    registerAntsEmissionsCommand(ants);
+    const emissions = ants.commands.find((command) => command.name() === 'emissions');
+    assert.ok(emissions);
+    assert.ok(emissions.options.some((option) => option.long === '--json'));
+});
+test('sharePercent renders 1/100000 shares as percentages', () => {
+    assert.equal(sharePercent(2000, 100_000), '2%');
+    assert.equal(sharePercent(12_500, 100_000), '12.5%');
+    assert.equal(sharePercent(5000, 10_000), '50%');
+});
+//# sourceMappingURL=emissions.test.js.map

package/dist/cli/commands/ants/emissions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emissions.test.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/emissions.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE5E,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;IACxC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,WAAW,CAAC,CAAC;IAClF,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAC/D,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC"}

package/dist/cli/commands/ants/extend.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerAntsExtendCommand(antsCmd: Command): void;
+//# sourceMappingURL=extend.d.ts.map

package/dist/cli/commands/ants/extend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/extend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAShE"}

package/dist/cli/commands/ants/extend.js

@@ -0,0 +1,14 @@
+import { parsePositiveInteger } from '../parse-positive-integer.js';
+import { extend } from '@antseed/ants';
+import { runAction } from './shared.js';
+export function registerAntsExtendCommand(antsCmd) {
+    antsCmd
+        .command('extend <id>')
+        .description('Extend a position lock by additional epochs')
+        .requiredOption('--epochs <n>', 'additional epochs', parsePositiveInteger)
+        .action(async (id, options) => runAction(antsCmd, 'Extending lock...', async ({ ctx }, report) => {
+        await extend(ctx, { positionId: Number(id), epochs: options.epochs }, report);
+        return `Extended position ${id} by ${options.epochs} epoch(s)`;
+    }));
+}
+//# sourceMappingURL=extend.js.map

package/dist/cli/commands/ants/extend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/extend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,cAAc,CAAC,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAA2B,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE;QAC3H,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9E,OAAO,qBAAqB,EAAE,OAAO,OAAO,CAAC,MAAM,WAAW,CAAC;IACjE,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/cli/commands/ants/extend.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extend.test.d.ts.map

package/dist/cli/commands/ants/extend.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/extend.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/ants/extend.test.js

@@ -0,0 +1,13 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Command } from 'commander';
+import { registerAntsExtendCommand } from './extend.js';
+test('extend takes one position id and requires the number of extra epochs', () => {
+    const ants = new Command('ants');
+    registerAntsExtendCommand(ants);
+    const extend = ants.commands.find((command) => command.name() === 'extend');
+    assert.ok(extend);
+    assert.deepEqual(extend.registeredArguments.map((argument) => argument.name()), ['id']);
+    assert.ok(extend.options.find((option) => option.long === '--epochs')?.mandatory, '--epochs is required');
+});
+//# sourceMappingURL=extend.test.js.map

package/dist/cli/commands/ants/extend.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.test.js","sourceRoot":"","sources":["../../../../src/cli/commands/ants/extend.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,IAAI,CAAC,sEAAsE,EAAE,GAAG,EAAE;IAChF,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAClB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACxF,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;AAC5G,CAAC,CAAC,CAAC"}

package/dist/cli/commands/ants/index.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from 'commander';
+/**
+ * `antseed ants` opens the local ANTS staking dashboard; every dashboard
+ * action is also a subcommand so the dashboard stays optional.
+ */
+export declare function registerAntsCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/ants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ants/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB3D"}

package/dist/cli/commands/ants/index.js

@@ -0,0 +1,46 @@
+import { registerAntsDashboardAction } from './dashboard.js';
+import { registerAntsStatusCommand } from './status.js';
+import { registerAntsPositionsCommand } from './positions.js';
+import { registerAntsStakeCommand } from './stake.js';
+import { registerAntsMoveCommand } from './move.js';
+import { registerAntsSplitCommand } from './split.js';
+import { registerAntsMergeCommand } from './merge.js';
+import { registerAntsExtendCommand } from './extend.js';
+import { registerAntsMaxLockCommand } from './max-lock.js';
+import { registerAntsWithdrawCommand } from './withdraw.js';
+import { registerAntsRewardsCommand } from './rewards.js';
+import { registerAntsPoolsCommand } from './pools.js';
+import { registerAntsPoolCommand } from './pool.js';
+import { registerAntsUsageCommand } from './usage.js';
+import { registerAntsEmissionsCommand } from './emissions.js';
+import { registerAntsAddressesCommand } from './addresses.js';
+import { registerAntsSellerCommand } from './seller.js';
+import { registerAntsVerifyCommand } from './verify.js';
+/**
+ * `antseed ants` opens the local ANTS staking dashboard; every dashboard
+ * action is also a subcommand so the dashboard stays optional.
+ */
+export function registerAntsCommands(program) {
+    const antsCmd = program
+        .command('ants')
+        .description('ANTS staking: local dashboard (default) or CLI commands for positions, rewards, pools, verification');
+    registerAntsDashboardAction(antsCmd);
+    registerAntsStatusCommand(antsCmd);
+    registerAntsPositionsCommand(antsCmd);
+    registerAntsStakeCommand(antsCmd);
+    registerAntsMoveCommand(antsCmd);
+    registerAntsSplitCommand(antsCmd);
+    registerAntsMergeCommand(antsCmd);
+    registerAntsExtendCommand(antsCmd);
+    registerAntsMaxLockCommand(antsCmd);
+    registerAntsWithdrawCommand(antsCmd);
+    registerAntsRewardsCommand(antsCmd);
+    registerAntsPoolsCommand(antsCmd);
+    registerAntsPoolCommand(antsCmd);
+    registerAntsUsageCommand(antsCmd);
+    registerAntsEmissionsCommand(antsCmd);
+    registerAntsAddressesCommand(antsCmd);
+    registerAntsSellerCommand(antsCmd);
+    registerAntsVerifyCommand(antsCmd);
+}
+//# sourceMappingURL=index.js.map