nat-cli 0.0.3 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bNAT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,52 @@
 # nat-cli
 
-Reserved for the bNAT command-line tool. Not released yet; see https://bnat.live.
+Command-line tool and agent skill for [bNAT](https://bnat.live) on BSC: mint NAT (one NFT per BSC block, valued by the BNB that block burned under BEP-95), wrap / unwrap it into the ERC-20 BNAT, and trade BNAT on its bid market. Every transaction is signed by the Binance Agentic Wallet (`baw`); this tool never handles private keys.
+
+```sh
+npm install -g nat-cli
+bnat
+```
+
+Run `bnat` on its own in a terminal for the interactive screen (sign in by scanning the QR code with the Binance App). `bnat help` lists the subcommands.
+
+## Commands
+
+```sh
+bnat status
+bnat wallet
+bnat blocks
+bnat top
+bnat block --block <N>
+bnat holdings [--address <addr>]
+bnat vault
+bnat bids [--mine]
+bnat mint --block <N> | --best [--to <addr>]
+bnat wrap --block <N[,N2,…]>
+bnat unwrap --block <N[,N2,…]>
+bnat bid --price <BNB> --amount <BNAT>
+bnat sell --bid <id> --amount <BNAT> | --all
+bnat cancel --bid <id>
+bnat resume --hash 0x…
+```
+
+Write commands only check and simulate unless `--yes` is given. With `--yes`, each one runs: local checks → on-chain simulation → item-by-item check of the wallet preview → journal entry → execute once → receipt event check. An interrupted transaction is never resent; settle it with `bnat resume`.
+
+`bnat help` lists every command and option, including `history`, `lang`, `config` and `resume --abandon`.
+
+Options: `--json` for machine-readable output, `--lang zh|en`, `--preview-only`. Environment: `BNAT_SITE`, `BNAT_RPC`, `BNAT_LANG`.
+
+Local files: settings in `~/.config/bnat/config.json`; the journal of writes in `~/.local/state/bnat/journal.jsonl`; logs of the interactive screen in `~/.local/state/bnat/logs/`.
+
+## AI agents
+
+The package ships `SKILL.md` (usage rules for agents: always run without `--yes` first, show the plan, and execute only after the user agrees) and `llms.txt`.
+
+## Requirements
+
+Node.js 22 or later. Minting requires a .ai Agent ID on the wallet; wrap, unwrap and the market do not.
+
+bNAT is an experiment. The contracts may have bugs and the tokens may go to zero. Not investment advice.
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: bnat
+description: Mint, wrap / unwrap and trade NAT (one NFT per BSC block, valued by the BNB that block burned) and its ERC-20 BNAT on BSC through the Binance Agentic Wallet with the bnat CLI. Use when the user asks to mint a NAT block, wrap a NAT into BNAT, unwrap a NAT out of the BNAT vault, place / fill / cancel a BNAT bid, or check bNAT wallet status.
+---
+
+# bNAT Skill
+
+**Talk to the user in the user's own language** (e.g. reply in Chinese if they write Chinese). This skill text is English; the CLI prints in Chinese or English (see `--lang` below).
+
+## What bNAT is
+
+- One NFT per BSC block (tokenId = block number), recording the BNB that block burned under BEP-95 (in gwei).
+- Only an address holding a .ai (SPACE ID Agent ID) can mint.
+- An NFT can be wrapped into the ERC-20 BNAT (1 BNAT = 1 BNB burned): the NFT goes into the BNAT vault, the wrapping wallet receives 99%, and the 1% fee stays in the BNAT contract.
+- Wrapping is reversible: anyone can pay the block's burn + 1% in BNAT to unwrap any block from the vault (the NFT goes to the payer, not necessarily the original wrapper).
+- BNAT has a bid-only market: buyers lock BNB at a bid price, holders sell into bids, and 1% of the BNB paid on each fill goes to the developer.
+
+Every transaction is signed by the user's **Binance Agentic Wallet**. The `bnat` CLI does: local checks → on-chain simulation → item-by-item wallet-preview check → journal entry → execute exactly once → receipt verification. You never touch private keys.
+
+## Setup
+
+```sh
+npm install -g nat-cli   # installs baw 1.12.0 (@binance/agentic-wallet) as a dependency; a global copy is optional (same login)
+bnat                     # the user runs this in a terminal and scans the QR with the Binance App
+                         # (without a terminal UI: baw auth signin)
+bnat wallet              # address, Agent ID, BNB, NAT, BNAT
+```
+
+- **Agent ID**: if `bnat wallet` shows none (the Agent ID line reads `没有`, "none"), the contract will reject minting. Have the user claim one in the Binance App (Web3 Wallet → Agent ID); check status with `baw wallet agent-id`. Wrap, unwrap and the market do not need an Agent ID.
+- A little BNB is needed for gas (the CLI estimates gas and checks the balance before sending, and says how much is missing). Placing a bid also locks price × amount in BNB.
+- The site URL comes from `BNAT_SITE` (if the package does not bundle one). Override the RPC with `BNAT_RPC`. **Never print the user's full RPC URL in output**; it may contain a key.
+
+## Commands
+
+Always call a subcommand. Bare `bnat` opens an interactive terminal UI for people (without a terminal it only prints the help).
+
+```sh
+bnat status                               # deployed addresses, mint progress, market overview
+bnat wallet
+bnat blocks --size 20                     # recent finalized, unminted blocks, highest burn first
+bnat top --size 20                        # all-time highest-burn unminted blocks (--filter minted|all, --offset; up to 100 a call, ranked 10,000 deep)
+bnat block --block <N>                    # one block: burn, finalized, minted, holder, in the vault or not
+bnat holdings [--address <address>]       # NAT held by an address (default: this wallet); --size, --offset
+bnat vault [--sort burn|recent]           # NAT in the BNAT vault with each one's unwrap price; --size, --offset
+bnat bids [--mine]                        # bid book, best price first; --mine: this wallet's open bids; --size, --offset
+bnat history                              # transactions sent from this machine
+
+bnat mint --block <N> [--to <address>]    # mint a specific block to --to, else the saved mintTo setting, else this wallet
+bnat mint --best [--to <address>]         # mint the unminted block with the highest burn among recent finalized blocks
+bnat wrap --block <N>[,<N2>,…]            # wrap into BNAT for yourself; comma-separate several, one transaction, max 50
+bnat unwrap --block <N>[,<N2>,…]          # pay burn + 1% in BNAT to unwrap these blocks from the vault to yourself; max 50
+bnat bid --price <BNB/BNAT> --amount <BNAT>
+bnat sell --bid <id> --amount <BNAT>     # or --all: sell until the bid's remainder or your balance runs out
+bnat cancel --bid <id>
+bnat resume --hash 0x…                    # settle an interrupted transaction
+bnat resume --abandon <record-id>         # void a record after confirming it was never sent
+```
+
+- Write commands **without `--yes` only run checks and on-chain simulation; nothing is sent** (the CLI prints `没有加 --yes：只做了检查，没有发交易。` / `Without --yes: only checked, nothing was sent.`).
+- `--preview-only` goes as far as the wallet preview.
+- `--json` prints a machine-readable result (`ok`, `stopped`, `error`, `result`, `log`); `log` holds the lines the plain output would print.
+- Output is Chinese or English: `--lang zh|en`, else `BNAT_LANG`, else the saved `lang` setting, else the system locale (Chinese locale → zh, anything else → en). Only a person's first run in a terminal asks for the language; without a terminal it never asks. Pass `--lang en` if you parse the text.
+- Settings live in `~/.config/bnat/config.json`: `lang` (`bnat lang zh|en`) and `mintTo` (`bnat config mintTo <address|self>`). The journal of writes is `~/.local/state/bnat/journal.jsonl`; the interactive screen also logs each session to `~/.local/state/bnat/logs/`.
+
+Exit codes:
+- `0` success.
+- `2` precondition not met, nothing sent (tell the user what is missing, per the message). Plain output goes to stderr and starts with `已停止：` / `Stopped: `.
+- `1` any other error. Plain output goes to stderr and starts with `出错：` / `Error: `.
+- With `--json`, success and failure both print one JSON object to stdout.
+
+## Rules you must follow
+
+1. **Run first without `--yes` and show the user the plan verbatim** (block, burn, wrap proceeds, unwrap cost, price, amount, locked BNB, amount received, fee, gas). **Only after the user explicitly agrees**, run the same command with `--yes`. Consent covers that one command only.
+2. **When selling with insufficient allowance, the CLI first sends an approve for the exact amount (not unlimited), then the sell.** When asking for consent, say clearly that it is two transactions.
+3. **After a wrap the NFT sits in the vault and anyone can unwrap it**: anyone paying burn + 1% can take that block out; the original wrapper has no priority. A round trip (wrap then unwrap) costs about 2% in fees. Tell the user this before executing.
+4. **Never resend.** When an outcome is unknown, the CLI refuses further transactions (output contains `执行结果未知` / `Outcome unknown`, or `笔交易结果未知` / `transaction(s) with an unknown outcome`). Follow the prompt: find the hash with `baw wallet tx-history`, then settle with `bnat resume --hash 0x…`. Use `--abandon` only if the user confirms the transaction really was not sent.
+5. **Do not bypass the CLI by calling the bNAT contracts directly with `baw contract-call`**, and do not edit `~/.local/state/bnat/journal.jsonl`.
+6. If any step errors or says stopped (`已停止` / `Stopped`), stop and relay the exact message to the user. Do not retry on your own with changed parameters (especially never raise the amount or change the price).
+7. Minting is first-come-first-served: the signature is public in the mempool and someone may land it first. `AlreadyMinted` is not a bug; ask the user about another block.
+8. When minting, if the user gives a recipient address, add `--to <address>` (wrap / unwrap have no `--to`; BNAT or the NFT only goes to the initiating wallet — to give it to someone else, transfer afterwards). Without `--to`, a recipient saved with `bnat config mintTo <address>` is used (check with `bnat config`; `bnat config mintTo self` resets it). The plan always shows `→ <address>`; have the user check the full address (do not read out only the first and last few characters). After minting to another address the NFT is not in the Agentic Wallet; later wraps and trades are done by that address itself.
+9. The `bnat blocks` / `bnat top` / `bnat block` / `bnat holdings` / `bnat vault` output comes from the site index and may lag; a block may have just been minted by someone else. The on-chain check in `bnat mint` is authoritative.
+
+## What the CLI checks
+
+- Mint: the wallet holds an Agent ID; block ≥ 13,082,000, not yet minted in the contract. The burn comes from the signing service (the site's burn index), which answers 503 for blocks past its burn index (the CLI says the index is syncing; `bnat mint --best` only picks indexed blocks) and 422 for blocks that burned < 1 gwei. The signature must be for this contract and recover to the contract's current signer.
+- Wrap: every block is minted, not in the vault, and owned by this wallet (or approved to it).
+- Unwrap: every block is currently in the BNAT vault; Σ(burn + 1%) is computed with the contract's `quote`, and the wallet's BNAT balance must cover it (if not, it says how much you have and how much is missing). No approval needed.
+- On-chain simulation passes and BNB covers gas.
+- Wallet preview: the target contract and attached BNB match the plan (the wallet's reply normally has no calldata, so calldata and the function selector are compared only when the reply includes them); only the planned asset changes are allowed (mint: only NAT in; wrap: only these NATs out, BNAT in; unwrap: only Σ(burn + 1%) BNAT out, NAT in; bid: only the locked BNB out; sell: only the specified BNAT out, BNB in); no risk warnings, no permission changes, no App confirmation required.
+- After inclusion, verify the receipt events (Minted / Wrapped / Unwrapped / BidPlaced / BidFilled / BidCancelled).
+
+## Example flows
+
+- User: "Mint a NAT for me, to 0xAbC… (full address)" → `bnat mint --best --to 0xAbC…` → check the recipient address in the plan → after consent, add `--yes`.
+- User: "Mint a NAT for me" → `bnat wallet` (confirm Agent ID and BNB) → `bnat mint --best` → show the plan → after consent, `bnat mint --best --yes`. Note `--best` may pick different blocks on the two runs; to lock the same block, use `--block <block number from the plan>` the second time.
+- User: "Get #50000123 back" → `bnat unwrap --block 50000123` → state how much BNAT it costs (including the 1%) → after consent, add `--yes`.
+- User: "Bid for 10 BNAT at 0.05 BNB" → `bnat bid --price 0.05 --amount 10` → state that 0.5 BNB will be locked → after consent, add `--yes`.
+- User: "Sell my BNAT to the highest bid" → `bnat bids`, take the first row's id → `bnat sell --bid <id> --all` → state the amount received, the fee, and whether an approve is needed first → after consent, add `--yes`.
+
+bNAT is an experiment. The contracts may have bugs and the tokens may go to zero. None of this is investment advice.

package/assets/deployment.json

@@ -0,0 +1,8 @@
+{
+  "chainId": 56,
+  "nat": "0x45bDcb3774a1027E492f1B0cd3EdE7e9FFb58353",
+  "bnat": "0x5473B4D8caED7ef06cb8D4eFCa58C302DFedCBE5",
+  "market": "0xd255231bF062Ad179A10a932C4FB9b0618ca703B",
+  "agentId": "0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F",
+  "site": "https://bnat.live"
+}

package/i18n/en.json

@@ -0,0 +1,283 @@
+{
+  "chain.aDevDeploymentMockagentidNeeds": "A dev deployment (mockAgentId) needs BNAT_RPC pointing at the local chain",
+  "chain.bidDoesnTExistIn": "Bid #{id} doesn't exist ({n} in total)",
+  "chain.cannotReadTheDeploymentFile": "Cannot read the deployment file {path}: ",
+  "chain.noDefaultRpcForChainid": "No default RPC for chainId {chainId}; set BNAT_RPC",
+  "chain.noSiteAddressSetBnat": "No site address: set BNAT_SITE (e.g. https://bnat.live)",
+  "chain.revertNameSuffix": " ({name})",
+  "chain.theDeploymentFileLacks": "The deployment file lacks {k}",
+  "chain.theSignatureIsNotFor": "The signature is not for this contract",
+  "chain.theSignerDiffersFromThe": "The signer differs from the one in the contract; this signature would be refused",
+  "chain.unexpectedReplyFromTheSigning": "Unexpected reply from the signing service",
+  "cli.addressMustBeAFull": "--address must be a full 0x address",
+  "cli.amountTooSmallWorthLess": "Amount too small: worth less than 1 wei at this price",
+  "cli.approveTheMarketToUse": "approve the market to use {amount} BNAT (exact, not unlimited)",
+  "cli.atMostPerSplitIt": "At most {BATCH_MAX} per {verb}; split it up",
+  "cli.belongsToNotThisWallet": "#{blk} belongs to {owner}, not this wallet",
+  "cli.bid": "Bid #{id}",
+  "cli.bidHasOnlyBnatLeft": "Bid #{id} has only {remaining} BNAT left; you want to sell {amount}",
+  "cli.bidIsAlreadyFilledOr": "Bid #{id} is already filled or cancelled",
+  "cli.bidWasPlacedByNot": "Bid #{id} was placed by {buyer}, not this wallet",
+  "cli.bidBnatAtBnbLocking": "bid: {amount} BNAT at {price} BNB, locking {cost}",
+  "cli.bidsShowing": "{total} bids, showing {v0}–{v1}",
+  "cli.block": "Block    ",
+  "cli.blockBurnGwei": "Block           burn gwei",
+  "cli.blockBurnGweiUnwrapCost": "Block           burn gwei           unwrap cost BNAT",
+  "cli.blockListsABlockTwice": "--block lists a block twice",
+  "cli.natInTheVault": "{total} NAT in the vault{range}",
+  "cli.bscRecomputesWhichDiffersFrom": " (the burn index has {bscBurnGwei}, which differs from the minted record)",
+  "cli.burn": "Burn     ",
+  "cli.cancelBidRefunding": "cancel bid #{id}, refunding {escrow}",
+  "cli.chainNatBnatMarket": "Chain {chainId} · NAT {nat}\nBNAT {bnat} · market {market}",
+  "cli.configSaved": "Saved: {key} = {value} ({file})",
+  "cli.configShow": "language {lang} · mint recipient {mintTo} ({file})",
+  "cli.configUsage": "Usage: bnat config [mintTo <address|self>]",
+  "cli.contractSendsGasAbout": "  contract {address} · {functionName} · sends {value} · gas about {v0}",
+  "cli.countUnit": "",
+  "cli.doneBlock": "Done: {hash} (block {blockNumber})",
+  "cli.error": "Error",
+  "cli.executeErrorPrefix": "({message}) ",
+  "cli.filterMustBeUnmintedMinted": "--filter must be unminted, minted or all",
+  "cli.final": "Final    ",
+  "cli.fromTheSiteIndexChecked": "(from the site index; checked on chain again before minting)",
+  "cli.giveTheAmountWithAmount": "Give the amount with --amount <BNAT>, or --all to sell until the bid or your balance runs out",
+  "cli.giveTheTransactionHashWith": "Give the transaction hash with --hash 0x…",
+  "cli.hasNoHolderNotMinted": "#{blk} has no holder (not minted yet): ",
+  "cli.heldBy": " (held by {value})",
+  "cli.help": "bnat {VERSION} — mint NAT, wrap / unwrap it into BNAT and trade BNAT through the Binance Agentic Wallet\n\nRun bnat on its own (in a terminal) for the interactive screen; bnat help shows this help.\n\nRead-only\n  bnat status                          deployment, minting progress, market overview\n  bnat wallet                          wallet address, .ai (Agent ID), BNB, NAT, BNAT\n  bnat blocks [--size 20]              recent finalized blocks not minted yet, highest burn first\n  bnat top [--size 20] [--filter unminted|minted|all] [--offset 0]\n                                       highest-burn blocks of all time (unminted by default; up to 100 per call, ranked 10,000 deep)\n  bnat block --block <N>               one block: burn, finalized, minted, holder\n  bnat holdings [--address <addr>] [--size 100] [--offset 0]\n                                       NAT held by an address (this wallet by default)\n  bnat vault [--sort burn|recent] [--size 20] [--offset 0]\n                                       NAT in the BNAT vault and the unwrap price of each\n  bnat bids [--mine] [--size 100] [--offset 0]\n                                       the bid book (highest price first); --mine only this wallet's open bids\n  bnat history                         transactions sent from this machine\n  bnat lang [zh|en]                    show or save the language (asked on the first run in a terminal)\n  bnat config [mintTo <addr|self>]     show the settings; set the default mint recipient (self = this wallet)\n\nWrites (without --yes: checks and simulation only, nothing is sent)\n  bnat mint --block <N> | --best [--to <addr>]   mint one block (one per transaction) to --to, else the mintTo setting, else this wallet\n  bnat wrap --block <N[,N2,…]>    wrap NAT into BNAT for this wallet, up to {BATCH_MAX} at once (the 1% fee stays in the BNAT contract)\n  bnat unwrap --block <N[,N2,…]>  pay burn + 1% in BNAT to unwrap these NAT from the vault to this wallet (anyone can), up to {BATCH_MAX} at once\n  bnat bid --price <BNB> --amount <BNAT>   place a bid, locking price × amount in BNB\n  bnat sell --bid <id> --amount <BNAT> | --all   sell BNAT into a bid (with an exact approval first if needed)\n  bnat cancel --bid <id>               cancel your own bid and get the remaining BNB back\n  bnat resume --hash 0x…               settle an interrupted transaction (never resends)\n  bnat resume --abandon <entry id>     void an interrupted entry once you are sure it was not sent\n\nOptions\n  --yes            really execute (get the user's consent first)\n  --preview-only   stop after the wallet preview, do not execute\n  --json           machine-readable output\n  --lang zh|en     this run only (saved setting: ~/.config/bnat/config.json; BNAT_LANG overrides it)\n\nEnvironment: BNAT_SITE (site), BNAT_RPC (contract chain RPC)",
+  "cli.holdsNat": "{who} holds {heldTotal} NAT{range}",
+  "cli.idPriceBnbBnatLeft": "id     price BNB / BNAT  remaining BNAT   locked BNB    buyer",
+  "cli.inTheBnatVaultCan": " (in the BNAT vault, can be unwrapped)",
+  "cli.isAlreadyInTheBnat": "#{blk} is already in the BNAT vault (take it out with bnat unwrap)",
+  "cli.isAlreadyMintedFirstCome": "#{blk} has already been minted; pick another",
+  "cli.isBeforeTheBep95": "#{blk} is before the BEP-95 activation block {ELEMENT_ACTIVATION_BLOCK}; it has no burn record",
+  "cli.langMustBeZhOr": "--lang must be zh or en",
+  "cli.langSaved": "Saved: English from now on ({file})",
+  "cli.languageEnglishSettingsFile": "Language: English (settings file {v0})",
+  "cli.marketBidsCurrentPriceBnb": "Market: {openBids} bids, current price {price} BNB / BNAT (highest bid), total volume {vol} BNB",
+  "cli.mintSummary": "mint #{blk} (burn {burn} gwei) → {dest}",
+  "cli.mintToBad": "mintTo in the settings is not a valid address: {v} (bnat config mintTo self resets it)",
+  "cli.minted": "minted",
+  "cli.minted2": "Minted   ",
+  "cli.mintedHeldBy": "yes, held by {owner}{where}",
+  "cli.mintedOfThemInThe": "{minted} minted ({wrapped} of them in the BNAT vault), sealed burn {sealed} BNB, {holders} holders",
+  "cli.mustBeAnIntegerFrom": "--{name} must be an integer from {lo} to {hi}",
+  "cli.nameTheBidToCancel": "Name the bid to cancel with --bid <id>",
+  "cli.nameTheBidWithBid": "Name the bid with --bid <id> (see `bnat bids`)",
+  "cli.nameTheBlockWithBlock": "Name the block with --block <number>",
+  "cli.nameTheBlockWithBlock2": "Name the block with --block <number>, or --best for the recent block with the highest burn",
+  "cli.nameTheNatToWith": "Name the NAT to {verb} with --block <number>, several separated by commas: --block 1,2,3",
+  "cli.no": "no",
+  "cli.no2": "no",
+  "cli.noEntriesYet": "No entries yet.",
+  "cli.noHash": "no hash",
+  "cli.noMatchingBlocks": "No matching blocks.",
+  "cli.noOpenEntries": "No open entries",
+  "cli.noOpenEntry": "No open entry {abandon}",
+  "cli.noneClaimOneInThe": "none — claim one in the Binance App before minting (check with `baw wallet agent-id`)",
+  "cli.notEnoughBnbNeedIncluding": "Not enough BNB: need {need} (including about {v0} gas), have {bal}, short by {short}",
+  "cli.notEnoughBnatNeedHave": "Not enough BNAT: need {amount}, have {bal}, short by {short}",
+  "cli.notEnoughBnatNeedIncluding": "Not enough BNAT: need {total} (including {fee} fee), have {bal}, short by {v0}",
+  "cli.notMintedYet": " (not minted yet: {reason})",
+  "cli.nothingLeftToMintIn": "Nothing left to mint in the last 96 finalized blocks; try again later.",
+  "cli.onChainSimulationFailed": "On-chain simulation failed: ",
+  "cli.onChainSimulationPassed": "  on-chain simulation: passed",
+  "cli.openEntriesPickOneWith": "{length} open entries; pick one with --id: ",
+  "cli.outcomeUnknownDoNotResend": "Outcome unknown. Do not resend; find the hash with `baw wallet tx-history`, then run bnat resume --hash 0x…",
+  "cli.plan": "Plan: ",
+  "cli.priceAndAmountMustBoth": "Price and amount must both be above 0",
+  "cli.priceBnbPerBnatAnd": "--price (BNB per BNAT) and --amount (BNAT) must both be numbers with at most 18 decimals",
+  "cli.rankBlockBurnGweiStatus": "Rank    Block           burn gwei           status",
+  "cli.sellBnatToBidReceive": "sell {amount} BNAT to bid #{id}: receive {v0} (fee {fee})",
+  "cli.sentWaitingForTheReceipt": "  sent {hash}, waiting for the receipt…",
+  "cli.showing": " (showing {v0}–{v1})",
+  "cli.sortMustBeBurnOr": "--sort must be burn or recent",
+  "cli.stopped": "Stopped",
+  "cli.theApprovalHasNotRun": "(The approval has not run yet; the sale can only be simulated once it is on chain.)",
+  "cli.theInteractiveScreenNeedsA": "The interactive screen needs a terminal",
+  "cli.theLast96FinalizedBlocks": "The last 96 finalized blocks are all minted or burned nothing.",
+  "cli.theMarketSBnatAllowance": "The market's BNAT allowance is {allowance}; approving exactly {amount} first (a separate transaction).",
+  "cli.theReceiptLacksTheExpected": "The receipt lacks the expected {name} event; check it by hand",
+  "cli.theSellAmountMustBe": "The sell amount must be above 0",
+  "cli.theWalletAcceptedItBut": "The wallet accepted it but gave no hash (order {v0}, {status}). ",
+  "cli.thereAreNoBidsRight": "There are no bids right now.",
+  "cli.thisEntryHasAHash": "This entry has a hash: settle it with --hash, it can't be voided",
+  "cli.thisIsADevDeployment": "This is a dev deployment (local chain): the real Binance wallet would send to BSC mainnet, so stopped. Sending on the dev chain needs the fake baw (BNAT_BAW_BIN) with both BNAT_RPC and FAKE_BAW_RPC on this machine",
+  "cli.thisTransactionDoesNotMatch": "This transaction does not match the recorded call (sender / contract / calldata / BNB sent); not settled",
+  "cli.thisWallet": "this wallet",
+  "cli.thisWalletHasNoOpen": "This wallet has no open bids.",
+  "cli.toIsNotAValid": "--to is not a valid address",
+  "cli.transactionIsOnChainBut": "Transaction {hash} is on chain but reverted (block {blockNumber})",
+  "cli.transactionSWithAnUnknown": "{length} transaction(s) with an unknown outcome ({list}). Settle with `bnat resume --hash 0x…` first; only if you are sure it was not sent, `bnat resume --abandon <id>`.",
+  "cli.transactionWasSentButHas": "Transaction {hash} was sent but has no receipt yet ({why}); outcome unknown. Do not resend; later run bnat resume --hash {hash}",
+  "cli.unexpectedReplyFromAddr": "Unexpected reply from /addr",
+  "cli.unexpectedReplyFromMarket": "Unexpected reply from /market",
+  "cli.unexpectedReplyFromMints": "Unexpected reply from /mints",
+  "cli.unexpectedReplyFromRecent": "Unexpected reply from /recent",
+  "cli.unexpectedReplyFromTop": "Unexpected reply from /top",
+  "cli.unknownCommand": "Unknown command",
+  "cli.unminted": "unminted",
+  "cli.unwrapHasNoToThe": "unwrap has no --to: the NFTs only go to the unwrapping wallet; to give them to someone, unwrap first and then transfer",
+  "cli.unwrapPayBnatBurnFee": "unwrap {names}: pay {total} BNAT (burn {amount} + fee {fee} that stays in the BNAT contract) → {length} NAT to this wallet",
+  "cli.usageBnatLangZhEn": "Usage: bnat lang zh|en",
+  "cli.voided": "Voided {action} [{id}]",
+  "cli.wallet": "Wallet    ",
+  "cli.walletHasNoAiAgent": "Wallet {from} has no .ai (Agent ID); the contract would refuse. Claim one in the Binance App first (check with `baw wallet agent-id`).",
+  "cli.walletPreviewEveryFieldChecked": "  wallet preview: every field checked",
+  "cli.withoutYesOnlyCheckedNothing": "Without --yes: only checked, nothing was sent.",
+  "cli.wrapHasNoToBnat": "wrap has no --to: BNAT only goes to the wrapping wallet; to give it to someone, wrap first and then transfer",
+  "cli.wrapBnatToThisWallet": "wrap {names} → {toHolder} BNAT to this wallet (fee {fee} stays in the BNAT contract; anyone can unwrap for burn + 1%)",
+  "cli.yes": "yes",
+  "cli.yes2": "yes",
+  "common.colon": ": ",
+  "common.listSep": "; ",
+  "tui.16TabsMoveR": "1–5 tabs · ↑↓ move · {v0} · r refresh",
+  "tui.aTransactionIsExecutingCannot": "A transaction is executing: cannot quit until it finishes",
+  "tui.abandon": "Abandon {action}",
+  "tui.action": "Action",
+  "tui.amountBnatEscCancels": "Amount (BNAT, Esc cancels): ",
+  "tui.atMostPerTransaction": "At most {BATCH} per transaction",
+  "tui.atMostPerTransactionPicked": "At most {BATCH} per transaction: picked the first {BATCH}",
+  "tui.badAddress": "Not a valid address: {v}",
+  "tui.batchTitle": "{verb} {length}",
+  "tui.bawAuthSigninReturnedAn": "baw auth signin returned an unexpected shape",
+  "tui.bawCheckingLogin": "baw checking login…",
+  "tui.bawIsCreatingTheWallet": "baw is creating the wallet: scan with the Binance App to continue",
+  "tui.bawIsNotLoggedIn": "baw not logged in: scan with the Binance App",
+  "tui.bawLoggedIn": "baw logged in",
+  "tui.bawLoggedIn2": "baw logged in",
+  "tui.bawLogin": "baw login",
+  "tui.bawNotLoggedInL": "baw not logged in · L to scan",
+  "tui.bawUnavailable": "baw unavailable",
+  "tui.bidBnat": "Bid {amount} BNAT @ {price}",
+  "tui.block": "Block",
+  "tui.bnatStarted": "bnat started",
+  "tui.burnGwei": "Burn gwei",
+  "tui.buyer": "Buyer",
+  "tui.byBurn": "by burn",
+  "tui.cancel": " cancel",
+  "tui.cancelBid": "Cancel bid #{id}",
+  "tui.cancelledNothingSent": "cancelled, nothing sent",
+  "tui.cannotQuitUntilItFinishes": " (cannot quit until it finishes)",
+  "tui.checking": "Checking {title}…",
+  "tui.checkingAndSimulatingOnChain": "checking and simulating on chain…",
+  "tui.checksAndSimulationPassedNothing": "  checks and simulation passed, nothing sent yet · ",
+  "tui.confirmedHandedToBawTo": "confirmed, handed to baw to sign and send",
+  "tui.couldNotCreateTheLogin": "Could not create the login QR code",
+  "tui.creatingTheLoginQrCode": "Creating the login QR code…",
+  "tui.done": "Done",
+  "tui.done2": "done",
+  "tui.enterMintTMintTo2": "Enter mint · t set recipient · n/p page",
+  "tui.enterSellBPlaceBid": "Enter sell · b place bid · c cancel · m mine only · n/p page",
+  "tui.errorsCountReason": "Errors (count · reason)",
+  "tui.executing": "Executing {title}…",
+  "tui.expiresInLNewCode": "Expires in {mmss} · L new code · Esc skip for now",
+  "tui.hSettleByHashX": "h settle by hash · x abandon",
+  "tui.history": "History",
+  "tui.holdings": "Holdings",
+  "tui.howMuchBnatToSell": "How much BNAT to sell to #{id} (Enter alone = until the bid or your balance runs out, Esc cancels): ",
+  "tui.id": "ID",
+  "tui.lLogIn": "L log in · ",
+  "tui.lNewQrCodeEsc": "L new QR code · Esc skip for now",
+  "tui.langSwitched": "Switched to English (saved in {file})",
+  "tui.leftBnat": "Remaining BNAT",
+  "tui.lockedBnb": "Locked BNB",
+  "tui.log": "Log",
+  "tui.loginFailed": "Login failed",
+  "tui.loginQrCodeReadyWaiting": "Login QR code ready, waiting for the scan…",
+  "tui.market": "Market",
+  "tui.mine": " mine",
+  "tui.mineOnly": "mine only",
+  "tui.mint": "Mint #{blk}",
+  "tui.mint2": "Mint #{blk} → {to}",
+  "tui.mintToCleared": "Mint recipient is this wallet again (saved in {file})",
+  "tui.mintToHeader": "mints to {to}",
+  "tui.mintToSet": "Mint recipient set to {to} (saved in {file})",
+  "tui.mintToWhichAddress0x": "Mint recipient (0x…; empty = this wallet; Esc cancels): ",
+  "tui.mintable": "Mintable",
+  "tui.newest": "newest",
+  "tui.noOutput": "no output",
+  "tui.none": "✗ none",
+  "tui.notLoggedInPressL": "baw not logged in: press L to log in with a QR code",
+  "tui.nothingHere": "(nothing here)",
+  "tui.pageRange": "{range}",
+  "tui.pairingCodeCheckItMatches": "Pairing code {v0} (check it matches the App)",
+  "tui.pgupPgdnScrollLogQ": "PgUp/PgDn scroll log · {loginKey}i 中文 · q quit",
+  "tui.pickedGetBnat": "{size} picked · get ≈ {amt} BNAT",
+  "tui.pickedPayBnat": "{size} picked · pay ≈ {amt} BNAT",
+  "tui.priceBnbBnat": "Price BNB / BNAT",
+  "tui.priceBnbBnatEscCancels": "Price (BNB / BNAT, Esc cancels): ",
+  "tui.qrCodeExpiredPressL": "QR code expired: press L for a new one",
+  "tui.rank": "Rank",
+  "tui.rankRange": "ranks {from}–{to}",
+  "tui.readFailed": "Read failed",
+  "tui.readingBids": "Reading bids…",
+  "tui.readingHistory": "Reading history…",
+  "tui.readingHoldings": "Reading holdings…",
+  "tui.readingMintableBlocks": "Reading mintable blocks…",
+  "tui.readingVault": "Reading vault…",
+  "tui.readingWallet": "Reading wallet…",
+  "tui.ready": "Ready",
+  "tui.scanResult": "scan result {status}",
+  "tui.scanWithTheBinanceApp": "Scan with the Binance App to log in to the Agentic Wallet",
+  "tui.sellToBid": "Sell to bid #{id}",
+  "tui.send": " send  ",
+  "tui.settle": "Settle {action}",
+  "tui.skippedLoginYouCanBrowse": "Skipped login: you can browse; press L to log in before sending",
+  "tui.spacePickAPickPage": "Space pick · a pick page · Enter wrap · Esc clear · n/p page",
+  "tui.spacePickAPickPage2": "Space pick · a pick page · Enter unwrap · s sort · Esc clear · n/p page",
+  "tui.status": "Status",
+  "tui.summary": "Summary",
+  "tui.sureItWasNeverSent": "Sure it was never sent and should be abandoned? Type yes: ",
+  "tui.thisEntryIsAlreadySettled": "This entry is already settled",
+  "tui.time": "Time",
+  "tui.toConfirm": "To confirm ▸ ",
+  "tui.transactionHash0xFindIt": "Transaction hash (0x…, find it with baw wallet tx-history, Esc cancels): ",
+  "tui.unexpectedReply": "Unexpected reply shape from the bnat command",
+  "tui.unwrapCostsBnat": "unwrap costs BNAT",
+  "tui.vault": "Vault",
+  "tui.walletReadFailed": "Wallet read failed",
+  "tui.windowTooSmallForThe": "Window too small for the QR code: enlarge the terminal, or open this link on your phone",
+  "tui.withoutYes": "Without --yes",
+  "tui.wrapGetsBnat": "wrap gets BNAT",
+  "tui.youCanOnlyCancelYour": "You can only cancel your own bids (m: mine only)",
+  "wallet.balanceChange": "balance change",
+  "wallet.bawDidNotReturnJson": "baw did not return JSON: ",
+  "wallet.bawIsNotLoggedIn": ": baw not logged in or the session expired. Run bnat and scan the QR code (or baw auth signin)",
+  "wallet.bawIsNotLoggedIn2": "baw not logged in: run bnat and scan the QR code (or baw auth signin)",
+  "wallet.binanceRiskControlRefusedThis": "Binance risk control refused this call (at preview: nothing on chain, no gas spent)",
+  "wallet.cannotStartBawRunNpm": "Cannot start baw (reinstall with npm install -g nat-cli): ",
+  "wallet.contractCallsNeedDeveloperMode": "contract calls need developer mode: turn it on in the Agentic Wallet settings in the Binance App, then run again",
+  "wallet.failed": " failed: ",
+  "wallet.heldByATemporaryBinance": "held by a temporary Binance security check and not sent; run again in a few minutes",
+  "wallet.messageSuffix": " ({message})",
+  "wallet.theBinanceAgenticWalletHas": "The Binance Agentic Wallet has no BSC address",
+  "wallet.thePreviewApprovesADifferent": "The preview approves a different spender",
+  "wallet.thePreviewApprovesMoreThan": "The preview approves more than planned",
+  "wallet.thePreviewCalldataDiffersFrom": "The preview calldata differs from the plan",
+  "wallet.thePreviewChangesAnAllowance": "The preview changes an allowance the plan does not",
+  "wallet.thePreviewChangesAnotherAccount": "The preview changes another account's balance",
+  "wallet.thePreviewChangesAnotherToken": "The preview changes another token's allowance",
+  "wallet.thePreviewFunctionSelectorDiffers": "The preview function selector differs from the plan",
+  "wallet.thePreviewHasExpired": "The preview has expired",
+  "wallet.thePreviewHasNoValid": "The preview has no valid requestId",
+  "wallet.thePreviewMovesAnUnplanned": "The preview moves an unplanned asset {contractAddress}",
+  "wallet.thePreviewSendsFromA": "The preview sends from a different address than planned",
+  "wallet.thePreviewSendsWeiThe": "The preview sends {value} wei; the plan is {value2}",
+  "wallet.thePreviewShowsAnAuthority": "The preview shows an authority change; stopped",
+  "wallet.thePreviewSpendsMoreThan": "The preview spends {v0} ({token}), more than the planned {max}",
+  "wallet.thePreviewTargetsADifferent": "The preview targets a different contract than planned",
+  "wallet.theWalletReportsRisks": "The wallet reports risks: ",
+  "wallet.theWalletWantsThisCall": "The wallet wants this call confirmed in the Binance App; stopped (change the setting in the App and run again)",
+  "wallet.unexpectedDecreaseOfInThe": "Unexpected decrease of {v0} in the preview",
+  "wallet.unexpectedIncreaseOfInThe": "Unexpected increase of {v0} in the preview",
+  "wallet.unexpectedShapeFromBawWallet": "Unexpected shape from baw wallet address: ",
+  "wallet.unrecognizedInTheWalletPreview": "Unrecognized {what} in the wallet preview: ",
+  "wallet.walletSimulationFailed": "Wallet simulation failed: ",
+  "wallet.unexpectedPreviewShape": "Unexpected wallet preview: {field} is missing or not recognized, so stopped",
+  "wallet.bawTimedOut": "baw {cmd} gave no reply within {s} s, gave up",
+  "cli.stillWaitingForTheWallet": "Still waiting for the wallet to execute (entry {id}). Do not resend; if interrupted, check with bnat resume",
+  "tui.drawFailed": "Drawing the screen failed",
+  "chain.indexSyncing": "index syncing",
+  "journal.corruptLine": "The journal {path} is corrupt at line {n}; no write will run until it is fixed. Keep a copy of the file and check the wallet's transaction history (baw wallet tx-history) before changing anything."
+}

package/i18n/revert.json

@@ -0,0 +1,98 @@
+{
+  "NoAgentId": {
+    "zh": "钱包没有 .ai（Agent ID），合约拒绝铸造",
+    "en": "The wallet has no .ai (Agent ID); the contract refuses to mint"
+  },
+  "BeforeActivation": {
+    "zh": "区块早于 BEP-95 生效块",
+    "en": "The block is before the BEP-95 activation block"
+  },
+  "FutureBlock": {
+    "zh": "区块还没出（区块号要小于当前块）",
+    "en": "The block doesn't exist yet (it must be below the current block)"
+  },
+  "ZeroBurn": {
+    "zh": "该块销毁量为 0",
+    "en": "This block burned 0"
+  },
+  "AlreadyMinted": {
+    "zh": "该块已被铸造",
+    "en": "This block has already been minted"
+  },
+  "BadSignature": {
+    "zh": "签名无效（签名者已更换，或数值不符）",
+    "en": "Invalid signature (the signer changed, or the values differ)"
+  },
+  "NotAuthorized": {
+    "zh": "你不是这张 NFT 的持有人或被授权人（或它已在 BNAT 金库里）",
+    "en": "You are not the holder or an approved operator of this NFT (or it is in the BNAT vault)"
+  },
+  "EmptyBatch": {
+    "zh": "没有指定区块",
+    "en": "No blocks given"
+  },
+  "ZeroAddress": {
+    "zh": "接收地址不能为空",
+    "en": "The recipient address can't be empty"
+  },
+  "ERC721NonexistentToken": {
+    "zh": "这张 NFT 不存在（还没铸造）",
+    "en": "This NFT doesn't exist (not minted yet)"
+  },
+  "NotInVault": {
+    "zh": "这块不在 BNAT 金库里",
+    "en": "This block isn't in the BNAT vault"
+  },
+  "CannotWithdrawNft": {
+    "zh": "金库里的 NFT 不能被取出，只能 unwrap",
+    "en": "NFTs in the vault can't be withdrawn, only unwrapped"
+  },
+  "OnlyDev": {
+    "zh": "只有开发者能从 BNAT 金库提取手续费",
+    "en": "Only the developer can withdraw fees from the BNAT vault"
+  },
+  "OnlyNft": {
+    "zh": "只有 NAT 合约能调用",
+    "en": "Only the NAT contract can call this"
+  },
+  "RenounceDisabled": {
+    "zh": "合约所有权不能放弃",
+    "en": "Ownership can't be renounced"
+  },
+  "TransferFailed": {
+    "zh": "BNB 转账失败（收款方不接受 BNB）",
+    "en": "BNB transfer failed (the recipient doesn't accept BNB)"
+  },
+  "WrongValue": {
+    "zh": "锁定的 BNB 和买单金额不符",
+    "en": "The locked BNB doesn't match the bid amount"
+  },
+  "ZeroAmount": {
+    "zh": "数量和价格都要大于 0",
+    "en": "Amount and price must both be above 0"
+  },
+  "NotBuyer": {
+    "zh": "只有挂单人能撤这个买单",
+    "en": "Only the bidder can cancel this bid"
+  },
+  "BidClosed": {
+    "zh": "这个买单已经成交完或撤销了",
+    "en": "This bid is already filled or cancelled"
+  },
+  "TooMuch": {
+    "zh": "卖出数量超过了买单剩余",
+    "en": "The sell amount is more than the bid has left"
+  },
+  "NothingToPay": {
+    "zh": "卖出数量太小，按这个价格换不到 1 wei",
+    "en": "Sell amount too small: worth less than 1 wei at this price"
+  },
+  "ERC20InsufficientBalance": {
+    "zh": "BNAT 不足",
+    "en": "Not enough BNAT"
+  },
+  "ERC20InsufficientAllowance": {
+    "zh": "市场合约的 BNAT 授权不足",
+    "en": "The market's BNAT allowance is too low"
+  }
+}