npm - @rozoai/checkout - Versions diffs - 0.1.19 → 0.1.21 - Mend

@rozoai/checkout 0.1.19 → 0.1.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/README.md +37 -9
package/docs/QUICKSTART.es.md +14 -6
package/docs/QUICKSTART.ja.md +8 -3
package/docs/QUICKSTART.md +13 -5
package/docs/QUICKSTART.zh.md +6 -4
package/docs/README.es.md +19 -4
package/docs/README.ja.md +18 -4
package/docs/README.zh.md +18 -4
package/llms.txt +126 -13
package/package.json +7 -2
package/scripts/dist/cli.js +1312 -563
package/scripts/dist/create-order.js +209 -22
package/scripts/dist/quote.js +107 -5
package/scripts/dist/receipt.js +84 -13
package/scripts/dist/resume.js +103 -18
package/scripts/dist/send-evm.js +31852 -211
package/scripts/dist/send-sol.js +468 -248
package/scripts/dist/status.js +87 -13

package/README.md CHANGED Viewed

@@ -9,7 +9,8 @@ Base. This skill pays them from whatever you hold instead, and it does three
 things the official path cannot:
 - **Pay from the chain you are already on.** USDT or USDC on Solana, BNB Chain,
-  Ethereum or Polygon, USDC on Base or Stellar, or BTC over Lightning. Coinbase's
+  Ethereum, Polygon or Arbitrum, USDC on Base or Stellar, BTC over Lightning, or
+  a native coin: ETH on Ethereum, Base or Arbitrum, BNB, SOL or POL. Coinbase's
   own direct pay takes USDC on Base.
 - **No Coinbase account.** Pay the deposit address from any wallet or straight
   from an exchange withdrawal. No sign-up, no API key, no browser.
@@ -61,12 +62,34 @@ npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
 | Ethereum | `usdt-ethereum` `usdc-ethereum` | `1` | 6 decimals |
 | BNB Chain | `usdt-bnb` `usdc-bnb` | `56` | 18 decimals |
 | Polygon | `usdt-polygon` `usdc-polygon` | `137` | 6 decimals |
+| Arbitrum | `usdt-arbitrum` `usdc-arbitrum` | `42161` | 6 decimals |
 | Base | `usdc-base` | `8453` | 6 decimals |
-| Solana | `usdt-solana` `usdc-solana` | `900` | SPL; native SOL not supported |
+| Solana | `usdt-solana` `usdc-solana` | `900` | SPL |
 | Stellar | `usdc-stellar` | `1500` | `MEMO_TEXT` memo required — shown in the deposit block |
 | Bitcoin Lightning | `btc-lightning` | `lightning` | BOLT11; amounts in satoshis. Any wallet that can pay an invoice works, including Cashu/ecash wallets — the mint melts your ecash into the Lightning payment. |
-Native gas coins (SOL, BNB, ETH, MATIC) and on-chain BTC are not accepted.
+**Native coins**, each on its own chain:
+| Coin | `--with` | Chain id | Notes |
+|---|---|---|---|
+| ETH on Ethereum | `eth-ethereum` | `1` | 18 decimals (wei); $1 minimum |
+| ETH on Base | `eth-base` | `8453` | 18 decimals (wei) |
+| ETH on Arbitrum | `eth-arbitrum` | `42161` | 18 decimals (wei) |
+| BNB | `bnb-bnb` or `bnb` | `56` | 18 decimals |
+| SOL | `sol-solana` or `sol` | `900` | 9 decimals (lamports) |
+| POL | `pol-polygon` or `pol` | `137` | 18 decimals |
+A native coin is offered only when the invoice's quote lists it (`quote` shows
+which), and only for invoices up to $2,000. The order is **exact-out**, like
+Lightning: send exactly the coin amount in the deposit block. Its price is
+locked only until the time shown (about an hour); after that, do not send it,
+let the order expire and start a new one. The coin amount includes an FX spread
+on top of the service fee, and your wallet needs a little more of the same coin
+for the network fee. If you pay from an exchange, the amount that arrives must
+be the full amount: check that the withdrawal fee is not taken out of it.
+`--send` pays native coins too, as a plain transfer of the exact amount.
+On-chain BTC and Tron are not supported.
 ## Which wallet do I need?
@@ -88,8 +111,8 @@ already hold and pay from wherever it already lives.
   route settles against ROZO's own Lightning node rather than a third-party
   swap, so no special handling is needed on our side.
 - **Only `--send` needs a private key**, read from `ROZO_CHECKOUT_EVM_KEY` or
-  `ROZO_CHECKOUT_SOL_KEY`, and it covers EVM chains and Solana only. Everything
-  else is keyless.
+  `ROZO_CHECKOUT_SOL_KEY`, and it covers EVM chains and Solana only (their
+  native coins included). Everything else is keyless.
 ## Use it from your agent
@@ -168,7 +191,8 @@ ROZO_CHECKOUT_EVM_KEYSTORE=/replace/me/keystores/my-hot-wallet
 # are prompted instead, and nothing is stored.
 ROZO_CHECKOUT_KEYSTORE_PASSPHRASE=REPLACE_ME_not_a_real_passphrase
-# Optional RPC overrides, one per chain id. 8453 = Base, 900 = Solana.
+# Optional RPC overrides, one per chain id. 8453 = Base, 42161 = Arbitrum,
+# 900 = Solana.
 ROZO_CHECKOUT_RPC_8453=https://mainnet.base.org
 ROZO_CHECKOUT_RPC_900=https://api.mainnet-beta.solana.com
 ```
@@ -437,10 +461,12 @@ done < links.txt
   Lightning: `deposit.lnInvoice` (the BOLT11) for `deposit.amount` sats. Other
   coins: `deposit.receiverAddress` and `deposit.amount`, plus
   `deposit.receiverMemo` on Stellar. `--send` cannot pay Lightning or Stellar.
+  A native coin order has `deposit.native: true` and `deposit.exactOut: true`.
 - The deadline to watch is `order.expiry.effectiveDeadlineIso`, not
   `deposit.expiresAt`: it is the earlier of our order expiry and the Coinbase
-  link expiry. Stop paying at least `order.expiry.marginMinutes` before it,
-  since settlement needs that much time.
+  link expiry, and for a native coin also its price lock
+  (`deposit.quoteExpiresAt`). Stop paying at least `order.expiry.marginMinutes`
+  before it, since settlement needs that much time.
 - If time has passed since you created the order, do not pay saved deposit
   details blindly. Re-run the same `pay` command (same `--with`): while the
   order is still payable it re-checks the link and the deadline and hands back
@@ -485,7 +511,9 @@ layers. Delivery is always `unknown`: Rozo cannot see your OpenRouter credits.
 With `--send`, the wallet must also hold the chain's fee coin (ETH, BNB, POL or
 SOL). If it does not, the CLI stops with `INSUFFICIENT_GAS` before signing and
-tells you how much is missing; the order is left untouched.
+tells you how much is missing; the order is left untouched. Paying with a native
+coin spends that same coin, so the wallet needs the order amount plus the fee.
+A native order is never sent after its price lock (`QUOTE_EXPIRED`).
 **Retrying without paying twice.** Running `pay` again on the same link does
 not create a second order while its order is open: you get the same order

package/docs/QUICKSTART.es.md CHANGED Viewed

@@ -3,8 +3,8 @@
 [English](QUICKSTART.md) | [简体中文](QUICKSTART.zh.md) | [日本語](QUICKSTART.ja.md) | **Español**
 Pagar un enlace de pago de Coinbase (Coinbase Payment Link) de OpenRouter con
-USDT/USDC en Solana, BNB Chain, Ethereum, Polygon, Base o Stellar, o con BTC por
-Lightning. Cinco minutos. Para saber cómo funciona y por qué, ver
+USDT/USDC en Solana, BNB Chain, Ethereum, Polygon, Arbitrum, Base o Stellar, con BTC por
+Lightning, o con una moneda nativa (ETH en Ethereum, Base o Arbitrum, BNB, SOL, POL). Cinco minutos. Para saber cómo funciona y por qué, ver
 [README.md](../README.md).
 ## El comando de una sola línea
@@ -26,9 +26,17 @@ npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLI
 ```
 Monedas para `--with`: `usdt-solana`, `usdc-solana`, `usdt-bnb`, `usdc-bnb`, `usdt-ethereum`,
-`usdc-ethereum`, `usdt-polygon`, `usdc-polygon`, `usdc-base`, `usdc-stellar`,
-`btc-lightning`. Los scripts y los agentes deben pasar siempre `--with`: el
-selector solo aparece en una terminal y no hay moneda por defecto.
+`usdc-ethereum`, `usdt-polygon`, `usdc-polygon`, `usdt-arbitrum`, `usdc-arbitrum`,
+`usdc-base`, `usdc-stellar`, `btc-lightning`, y las monedas nativas `eth-ethereum`,
+`eth-base`, `eth-arbitrum`, `bnb-bnb`, `sol-solana`, `pol-polygon`. Los scripts y
+los agentes deben pasar siempre `--with`: el selector solo aparece en una
+terminal y no hay moneda por defecto.
+Una moneda nativa solo se ofrece cuando la cotización de la factura la incluye,
+para facturas de hasta $2,000 (ETH nativo en Ethereum: mínimo $1). Es exact-out:
+envía exactamente la cantidad indicada antes de que termine el precio fijado
+(alrededor de una hora), y guarda un poco de la misma moneda para el gas. El BTC
+on-chain y Tron no están soportados.
 Por defecto solo imprime una dirección para pagar desde cualquier billetera: sin
 clave privada y sin configuración. Añadir `--send` únicamente si se quiere que la
@@ -55,7 +63,7 @@ LINK="https://payments.coinbase.com/payment-links/pl_01YOURLINKID"
 ```
 Ids de cadena: `1` Ethereum · `56` BNB Chain · `137` Polygon · `8453` Base ·
-`900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning.
+`42161` Arbitrum · `900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning.
 ## ¿Qué wallet necesito?

package/docs/QUICKSTART.ja.md CHANGED Viewed

@@ -3,7 +3,7 @@
 [English](QUICKSTART.md) | [简体中文](QUICKSTART.zh.md) | **日本語** | [Español](QUICKSTART.es.md)
 OpenRouter の Coinbase 決済リンク (Payment Link) を、Solana、BNB Chain、
-Ethereum、Polygon、Base、Stellar 上の USDT/USDC、または Lightning 経由の BTC で支払います。所要 5 分。
+Ethereum、Polygon、Arbitrum、Base、Stellar 上の USDT/USDC、Lightning 経由の BTC、またはネイティブコイン（Ethereum・Base・Arbitrum の ETH、BNB、SOL、POL）で支払います。所要 5 分。
 仕組みと設計意図については [README.md](../README.md) を参照してください。
 ## ワンライナー
@@ -25,10 +25,15 @@ npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLI
 `--with` に指定できる通貨: `usdt-solana`、
 `usdc-solana`、`usdt-bnb`、`usdc-bnb`、`usdt-ethereum`、`usdc-ethereum`、
-`usdt-polygon`、`usdc-polygon`、`usdc-base`、`usdc-stellar`、`btc-lightning`。
+`usdt-polygon`、`usdc-polygon`、`usdt-arbitrum`、`usdc-arbitrum`、`usdc-base`、`usdc-stellar`、`btc-lightning`、
+ネイティブコインの `eth-ethereum`、`eth-base`、`eth-arbitrum`、`bnb-bnb`、`sol-solana`、`pol-polygon`。
 スクリプトやエージェントでは必ず `--with` を渡してください。対話式の選択は端末でのみ
 表示され、既定の通貨はありません。
+ネイティブコインは、インボイスの見積もりに含まれている場合のみ使えます（上限 $2,000、Ethereum の ETH は最低 $1）。
+受取額固定（exact-out）なので、表示された数量を価格固定の期限（約 1 時間）までに正確に送り、ガス代として同じコインを少し残してください。
+オンチェーンの BTC と Tron には対応していません。
 既定では、任意のウォレットから支払うためのアドレスを表示するだけです — 鍵も設定も
 不要です。CLI にホットウォレットから署名させたい場合にだけ `--send` を、機械可読な
 出力が必要な場合は `--json` を追加してください。
@@ -52,7 +57,7 @@ LINK="https://payments.coinbase.com/payment-links/pl_01YOURLINKID"
 ```
 チェーン id: `1` Ethereum · `56` BNB Chain · `137` Polygon · `8453` Base ·
-`900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning。
+`42161` Arbitrum · `900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning。
 ## どのウォレットが必要ですか？

package/docs/QUICKSTART.md CHANGED Viewed

@@ -3,7 +3,8 @@
 **English** | [简体中文](QUICKSTART.zh.md) | [日本語](QUICKSTART.ja.md) | [Español](QUICKSTART.es.md)
 Pay an OpenRouter Coinbase Payment Link with USDT/USDC on Solana, BNB Chain,
-Ethereum, Polygon, Base or Stellar, or with BTC over Lightning. Five minutes.
+Ethereum, Polygon, Arbitrum, Base or Stellar, with BTC over Lightning, or with a
+native coin (ETH on Ethereum, Base or Arbitrum, BNB, SOL, POL). Five minutes.
 For how it works and why, see [README.md](../README.md).
 ## The one-liner
@@ -25,9 +26,16 @@ npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLI
 ```
 Coins for `--with`: `usdt-solana`, `usdc-solana`, `usdt-bnb`, `usdc-bnb`,
-`usdt-ethereum`, `usdc-ethereum`, `usdt-polygon`, `usdc-polygon`, `usdc-base`,
-`usdc-stellar`, `btc-lightning`. Scripts and agents must pass `--with`: the
-picker only appears on a terminal, and there is no default coin.
+`usdt-ethereum`, `usdc-ethereum`, `usdt-polygon`, `usdc-polygon`,
+`usdt-arbitrum`, `usdc-arbitrum`, `usdc-base`, `usdc-stellar`, `btc-lightning`,
+and the native coins `eth-ethereum`, `eth-base`, `eth-arbitrum`, `bnb-bnb`,
+`sol-solana`, `pol-polygon`. Scripts and agents must pass `--with`: the picker
+only appears on a terminal, and there is no default coin.
+A native coin is offered only when the invoice's quote lists it, for invoices up
+to $2,000 (native ETH on Ethereum: $1 minimum). It is exact-out: send exactly
+the coin amount shown, before its price lock ends (about an hour), and keep a
+little of the same coin for gas. On-chain BTC and Tron are not supported.
 By default it just prints an address for you to pay from any wallet — no key
 and no configuration needed. Add `--send` only if you want the CLI to sign
@@ -52,7 +60,7 @@ LINK="https://payments.coinbase.com/payment-links/pl_01YOURLINKID"
 ```
 Chain ids: `1` Ethereum · `56` BNB Chain · `137` Polygon · `8453` Base ·
-`900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning.
+`42161` Arbitrum · `900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning.
 ## Which wallet do I need?

package/docs/QUICKSTART.zh.md CHANGED Viewed

@@ -2,8 +2,8 @@
 [English](QUICKSTART.md) | **简体中文** | [日本語](QUICKSTART.ja.md) | [Español](QUICKSTART.es.md)
-用 Solana、BNB Chain、Ethereum、Polygon、Base 或 Stellar 上的 USDT/USDC，或者用走
-Lightning 的 BTC，去支付一个 OpenRouter Coinbase 收款链接 (Payment Link)。五分钟搞定。
+用 Solana、BNB Chain、Ethereum、Polygon、Arbitrum、Base 或 Stellar 上的 USDT/USDC，用走
+Lightning 的 BTC，或者用原生币（Ethereum、Base、Arbitrum 上的 ETH，BNB、SOL、POL），去支付一个 OpenRouter Coinbase 收款链接 (Payment Link)。五分钟搞定。
 工作原理与设计理由见 [README.md](../README.md)。
 ## 一行命令搞定
@@ -20,7 +20,9 @@ npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLI
 npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLINKID --with usdt-solana
 ```
-`--with` 可选的币种有：`usdt-solana`、`usdc-solana`、`usdt-bnb`、`usdc-bnb`、`usdt-ethereum`、`usdc-ethereum`、`usdt-polygon`、`usdc-polygon`、`usdc-base`、`usdc-stellar`、`btc-lightning`。脚本和 agent 必须显式传 `--with`：交互式选择只在终端里出现，而且没有默认币种。
+`--with` 可选的币种有：`usdt-solana`、`usdc-solana`、`usdt-bnb`、`usdc-bnb`、`usdt-ethereum`、`usdc-ethereum`、`usdt-polygon`、`usdc-polygon`、`usdt-arbitrum`、`usdc-arbitrum`、`usdc-base`、`usdc-stellar`、`btc-lightning`，以及原生币 `eth-ethereum`、`eth-base`、`eth-arbitrum`、`bnb-bnb`、`sol-solana`、`pol-polygon`。脚本和 agent 必须显式传 `--with`：交互式选择只在终端里出现，而且没有默认币种。
+原生币只有在这张账单的报价列出时才能用，账单上限 $2,000（Ethereum 上的 ETH 最低 $1）。原生币是精确到账（exact-out）：在币价锁定结束前（约 1 小时）按显示的币数精确发送，并留一点同一种币付 gas。链上 BTC 和 Tron 不支持。
 默认情况下它只是打印一个地址，让你用任意钱包去付 —— 不需要私钥，也不需要任何配置。只有当你想让 CLI 改从热钱包签名时才加 `--send`；加 `--json` 输出机器可读格式。
@@ -42,7 +44,7 @@ LINK="https://payments.coinbase.com/payment-links/pl_01YOURLINKID"
 ```
 链 id：`1` Ethereum · `56` BNB Chain · `137` Polygon · `8453` Base ·
-`900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning。
+`42161` Arbitrum · `900` Solana · `1500` Stellar · `lightning` Bitcoin Lightning。
 ## 我需要什么钱包？

package/docs/README.es.md CHANGED Viewed

@@ -3,8 +3,9 @@
 [English](../README.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | **Español**
 Pagar un **enlace de pago de Coinbase (Payment Link) de OpenRouter** con una
-moneda que ese enlace no puede aceptar directamente: BTC por Lightning, o
-USDT/USDC en Solana, BNB Chain, Ethereum, Polygon, Base o Stellar. Un enlace de
+moneda que ese enlace no puede aceptar directamente: BTC por Lightning,
+USDT/USDC en Solana, BNB Chain, Ethereum, Polygon, Arbitrum, Base o Stellar, o
+una moneda nativa: ETH en Ethereum, Base o Arbitrum, BNB, SOL o POL. Un enlace de
 pago de Coinbase solo acepta USDC en Base; esto enruta la moneda que realmente
 se posee a través de un puente, y una billetera fondeadora liquida la factura en
 nombre del usuario. Sin cuenta, sin clave de API, sin navegador.
@@ -32,12 +33,26 @@ npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
 | Ethereum | `usdt-ethereum` `usdc-ethereum` | `1` | 6 decimales |
 | BNB Chain | `usdt-bnb` `usdc-bnb` | `56` | 18 decimales |
 | Polygon | `usdt-polygon` `usdc-polygon` | `137` | 6 decimales |
+| Arbitrum | `usdt-arbitrum` `usdc-arbitrum` | `42161` | 6 decimales |
 | Base | `usdc-base` | `8453` | 6 decimales |
-| Solana | `usdt-solana` `usdc-solana` | `900` | SPL; SOL nativo no admitido |
+| Solana | `usdt-solana` `usdc-solana` | `900` | SPL |
 | Stellar | `usdc-stellar` | `1500` | memo `MEMO_TEXT` obligatorio — se muestra en el bloque de depósito |
 | Bitcoin Lightning | `btc-lightning` | `lightning` | BOLT11; importes en satoshis |
-Las monedas de gas nativas (SOL, BNB, ETH, MATIC) y el BTC on-chain no se aceptan.
+**Monedas nativas**, cada una en su propia cadena:
+| Moneda | `--with` | Id de cadena | Notas |
+|---|---|---|---|
+| ETH en Ethereum | `eth-ethereum` | `1` | 18 decimales (wei); mínimo $1 |
+| ETH en Base | `eth-base` | `8453` | 18 decimales (wei) |
+| ETH en Arbitrum | `eth-arbitrum` | `42161` | 18 decimales (wei) |
+| BNB | `bnb-bnb` o `bnb` | `56` | 18 decimales |
+| SOL | `sol-solana` o `sol` | `900` | 9 decimales (lamports) |
+| POL | `pol-polygon` o `pol` | `137` | 18 decimales |
+Una moneda nativa solo se ofrece cuando la cotización de la factura la incluye (`quote` lo muestra), y solo para facturas de hasta $2,000. La orden es **exact-out**, como Lightning: envía exactamente la cantidad de moneda del bloque de depósito. Su precio queda fijado solo hasta la hora indicada (alrededor de una hora); pasada esa hora, no la envíes: deja que la orden expire y crea una nueva. La cantidad incluye un diferencial cambiario además de la comisión de servicio, y la billetera necesita un poco más de la misma moneda para la comisión de red. Si pagas desde un exchange, debe llegar la cantidad completa: comprueba que la comisión de retiro no se descuente de ella. `--send` también paga monedas nativas, como una transferencia normal de la cantidad exacta.
+El BTC on-chain y Tron no están soportados.
 ## ¿Qué wallet necesito?

package/docs/README.ja.md CHANGED Viewed

@@ -3,8 +3,8 @@
 [English](../README.md) | [简体中文](README.zh.md) | **日本語** | [Español](README.es.md)
 **OpenRouter の Coinbase 決済リンク (Payment Link)** を、そのリンクが直接受け取れない
-通貨で支払います — Lightning 経由の BTC、または Solana、BNB Chain、Ethereum、
-Polygon、Base、Stellar 上の USDT/USDC です。Coinbase の決済リンクは Base 上の USDC しか
+通貨で支払います：Lightning 経由の BTC、Solana、BNB Chain、Ethereum、
+Polygon、Arbitrum、Base、Stellar 上の USDT/USDC、またはネイティブコイン（Ethereum・Base・Arbitrum の ETH、BNB、SOL、POL）です。Coinbase の決済リンクは Base 上の USDC しか
 受け付けません。本ツールは、あなたが実際に保有している通貨をブリッジ経由で中継し、
 資金提供ウォレット (funder wallet) があなたに代わってインボイスを決済します。
 アカウントも API キーもブラウザーも不要です。
@@ -31,12 +31,26 @@ npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
 | Ethereum | `usdt-ethereum` `usdc-ethereum` | `1` | 小数点以下 6 桁 |
 | BNB Chain | `usdt-bnb` `usdc-bnb` | `56` | 小数点以下 18 桁 |
 | Polygon | `usdt-polygon` `usdc-polygon` | `137` | 小数点以下 6 桁 |
+| Arbitrum | `usdt-arbitrum` `usdc-arbitrum` | `42161` | 小数点以下 6 桁 |
 | Base | `usdc-base` | `8453` | 小数点以下 6 桁 |
-| Solana | `usdt-solana` `usdc-solana` | `900` | SPL。ネイティブの SOL は非対応 |
+| Solana | `usdt-solana` `usdc-solana` | `900` | SPL |
 | Stellar | `usdc-stellar` | `1500` | `MEMO_TEXT` のメモが必須 — 入金ブロックに表示されます |
 | Bitcoin Lightning | `btc-lightning` | `lightning` | BOLT11。金額は satoshi 単位 |
-ネイティブのガス通貨（SOL、BNB、ETH、MATIC）およびオンチェーンの BTC は受け付けません。
+**ネイティブコイン**（それぞれ自分のチェーン上のみ）：
+| コイン | `--with` | チェーン id | 備考 |
+|---|---|---|---|
+| Ethereum の ETH | `eth-ethereum` | `1` | 小数点以下 18 桁（wei）。最低 $1 |
+| Base の ETH | `eth-base` | `8453` | 小数点以下 18 桁（wei） |
+| Arbitrum の ETH | `eth-arbitrum` | `42161` | 小数点以下 18 桁（wei） |
+| BNB | `bnb-bnb` または `bnb` | `56` | 小数点以下 18 桁 |
+| SOL | `sol-solana` または `sol` | `900` | 小数点以下 9 桁（lamports） |
+| POL | `pol-polygon` または `pol` | `137` | 小数点以下 18 桁 |
+ネイティブコインは、そのインボイスの見積もりに含まれている場合にのみ使えます（`quote` で確認できます）。上限は 1 件 $2,000 です。注文は Lightning と同じく**exact-out（受取額固定）**で、入金ブロックのコイン数量をそのまま正確に送ってください。価格は表示された時刻（約 1 時間）までしか固定されません。それを過ぎたら送らず、注文の期限切れを待って新しく作り直してください。コイン数量にはサービス手数料に加えて為替スプレッドが含まれます。ウォレットにはネットワーク手数料用に同じコインが少し余分に必要です。取引所から出金する場合は、着金額が全額になるよう、出金手数料が差し引かれないことを確認してください。`--send` もネイティブコインに対応しており、正確な数量の通常送金として送ります。
+オンチェーンの BTC と Tron には対応していません。
 ## どのウォレットが必要ですか？

package/docs/README.zh.md CHANGED Viewed

@@ -3,8 +3,8 @@
 [English](../README.md) | **简体中文** | [日本語](README.ja.md) | [Español](README.es.md)
 用一种 **OpenRouter Coinbase 收款链接 (Payment Link)** 本身收不了的币去付款 —— 走
-闪电网络的 BTC，或者 Solana、BNB Chain、Ethereum、Polygon、Base、Stellar 上的
-USDT/USDC。Coinbase 收款链接只接受 Base 上的 USDC；本工具把你实际持有的币通过
+闪电网络的 BTC，Solana、BNB Chain、Ethereum、Polygon、Arbitrum、Base、Stellar 上的
+USDT/USDC，或者原生币：Ethereum、Base、Arbitrum 上的 ETH，以及 BNB、SOL、POL。Coinbase 收款链接只接受 Base 上的 USDC；本工具把你实际持有的币通过
 一座桥路由过去，再由一个出资钱包代你结清账单。无需账号、无需 API key、无需浏览器。
 ```bash
@@ -28,12 +28,26 @@ npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
 | Ethereum | `usdt-ethereum` `usdc-ethereum` | `1` | 6 位小数 |
 | BNB Chain | `usdt-bnb` `usdc-bnb` | `56` | 18 位小数 |
 | Polygon | `usdt-polygon` `usdc-polygon` | `137` | 6 位小数 |
+| Arbitrum | `usdt-arbitrum` `usdc-arbitrum` | `42161` | 6 位小数 |
 | Base | `usdc-base` | `8453` | 6 位小数 |
-| Solana | `usdt-solana` `usdc-solana` | `900` | SPL；不支持原生 SOL |
+| Solana | `usdt-solana` `usdc-solana` | `900` | SPL |
 | Stellar | `usdc-stellar` | `1500` | 必须带 `MEMO_TEXT` memo —— 会在充值信息块里给出 |
 | Bitcoin Lightning | `btc-lightning` | `lightning` | BOLT11；金额单位为聪 |
-原生 gas 币（SOL、BNB、ETH、MATIC）以及链上 BTC 均不接受。
+**原生币**，各自只在自己的链上：
+| 币 | `--with` | 链 id | 备注 |
+|---|---|---|---|
+| Ethereum 上的 ETH | `eth-ethereum` | `1` | 18 位小数（wei）；最低 $1 |
+| Base 上的 ETH | `eth-base` | `8453` | 18 位小数（wei） |
+| Arbitrum 上的 ETH | `eth-arbitrum` | `42161` | 18 位小数（wei） |
+| BNB | `bnb-bnb` 或 `bnb` | `56` | 18 位小数 |
+| SOL | `sol-solana` 或 `sol` | `900` | 9 位小数（lamports） |
+| POL | `pol-polygon` 或 `pol` | `137` | 18 位小数 |
+只有当这张账单的报价列出某个原生币时才能用它（`quote` 会显示），且账单不超过 $2,000。原生币订单是**精确到账（exact-out）**，和闪电网络一样：按充值信息块里的币数一分不差地发送。币价只锁定到显示的时间（约 1 小时）；过了这个时间就不要再发，让订单过期后重新下单。币数里在服务费之外还含汇率价差，钱包里还需要多留一点同一种币付网络费。从交易所提币时，到账金额必须是完整金额：确认提币手续费没有从中扣除。`--send` 也能付原生币，按精确金额做一笔普通转账。
+链上 BTC 和 Tron 不支持。
 ## 我需要什么钱包？

package/llms.txt CHANGED Viewed

@@ -3,7 +3,8 @@
 > When your agent needs to pay OpenRouter (or any Coinbase invoice) with the crypto you
 > already hold. Pays a Coinbase Payment Link (payments.coinbase.com/payment-links/pl_* or
 > /payment-sessions/paymentSession_*) with BTC over Lightning, USDT/USDC on Solana,
-> BNB Chain, Ethereum or Polygon, or USDC on Base or Stellar. No Coinbase account, public HTTP
+> BNB Chain, Ethereum, Polygon or Arbitrum, USDC on Base or Stellar, or a native coin
+> (ETH on Ethereum, Base or Arbitrum, BNB, SOL, POL). No Coinbase account, public HTTP
 > endpoints, no API key. Crypto payments to OpenRouter are never refundable.
 > The payer funds a one-time deposit address; a bridge and a funder wallet settle the
 > Coinbase link automatically. No discount: you pay the invoice amount, plus the
@@ -22,8 +23,10 @@ calls with every safety rule already enforced:
   npx @rozoai/checkout status <rozoPaymentId | coinbase-link>
 --with accepts usdt-solana, usdc-solana, usdt-bnb, usdc-bnb, usdt-ethereum,
-usdc-ethereum, usdt-polygon, usdc-polygon, usdc-base, usdc-stellar, btc-lightning
-(or raw: --chain 900 --token USDT).
+usdc-ethereum, usdt-polygon, usdc-polygon, usdt-arbitrum, usdc-arbitrum, usdc-base,
+usdc-stellar, btc-lightning, and the native coins eth-ethereum, eth-base,
+eth-arbitrum, bnb-bnb (or bnb), sol-solana (or sol), pol-polygon (or pol)
+(or raw: --chain 900 --token USDT, --chain 8453 --token ETH).
 Optional: --email <addr> stores a contact email with the order so ROZO can reach
 the user if the payment needs attention. Ask the user once if they are present;
@@ -95,11 +98,23 @@ copy-pastable block. Creating an order moves no money; an unfunded order expires
 ## Supported sources
-chainId "1" Ethereum (USDC, USDT) · "56" BNB Chain (USDC, USDT; 18-decimals) ·
-"137" Polygon (USDC, USDT) · "8453" Base (USDC) · "900" Solana (USDC, USDT) ·
-"1500" Stellar (USDC; deposit memo REQUIRED) · "lightning" (BTC; BOLT11 invoice,
-amounts in integer satoshis via source.amountUnit=="sats").
-Native SOL/ETH/BNB are NOT supported — stablecoins (or Lightning BTC) only.
+chainId "1" Ethereum (USDC, USDT, native ETH) · "56" BNB Chain (USDC, USDT;
+18-decimals; native BNB) · "137" Polygon (USDC, USDT, native POL) · "42161" Arbitrum
+(USDC, USDT, native ETH) · "8453" Base (USDC, native ETH) · "900" Solana (USDC, USDT,
+native SOL) · "1500" Stellar (USDC; deposit memo REQUIRED) · "lightning" (BTC;
+BOLT11 invoice, amounts in integer satoshis via source.amountUnit=="sats").
+USDT is not accepted on Base or Stellar. On-chain BTC and Tron are NOT supported.
+Native coins (tokenSymbol "ETH", "BNB", "SOL" or "POL" on the chains above; ETH, BNB
+and POL have 18 decimals, SOL 9): offer one only when quote-invoice lists it in
+supportedSources for that invoice ({"<chainId>": ["USDC", "ETH", ...]}). A native
+order is exact-out like Lightning: source.amount is the exact coin amount to send,
+and the price is locked only until quoteExpiresAt (returned by create-invoice and by
+the payments GET; the order's own expiresAt is later). Never send after
+quoteExpiresAt. The coin amount includes an FX spread on top of the service fee, and
+the payer also needs some of the same coin for gas. Native orders are limited to
+$2,000 per invoice (native ETH on Ethereum: $1 minimum; quote-invoice may report
+per-coin minimums in nativeMinUsd). The CLI enforces all of this, and --send pays a
+native coin as a plain transfer of the exact amount.
 WALLET: one wallet on one of these chains is enough — not one per chain. Any
 wallet, or an exchange withdrawal, can fund the deposit address; nothing
@@ -158,9 +173,12 @@ balance once with the coin you hold, then pay many small x402 calls from it.
   npx @rozoai/checkout x402 balance
 Payment leg (what the seller receives): USDC on Base (eip155:8453) only,
-scheme "exact". Solana payment leg is coming later. Topup leg: every --with coin above, plus native
-ETH (Ethereum, Base, Arbitrum), BNB and SOL in beta. Native coins never pay a
-seller directly.
+scheme "exact". Solana payment leg is coming later. Topup leg: USDT on Solana,
+BNB Chain, Ethereum, Polygon, Arbitrum; USDC on Solana, BNB Chain, Ethereum,
+Polygon, Arbitrum, Base, Stellar. x402 balance top ups accept USDC and USDT only; any other coin
+is answered with 400 X402_TOPUP_SOURCE_UNSUPPORTED. USDT only funds the balance;
+sellers are paid in USDC. Holding a native coin or sats? Use them to top up
+OpenRouter with ROZO Checkout (https://checkout.rozo.ai).
 Raw HTTP (Authorization: Bearer <agent key ak_...>):
   POST https://apiserver.mpprouter.dev/v1/x402/topup  {"amount":"20","token":"USDT","chain":"900"}
@@ -177,10 +195,105 @@ x402 safety rules:
 - Refuse a payment above what the user approved; refuse a payTo on a
   compromised-wallet list.
 - 503 X402_RETRY, X402_PAYER_MODE_CHANGED or X402_LEDGER_UNAVAILABLE: retry
-  with the same idempotencyKey. Any other 503 from /v1/x402 = "x402 payer not
-  enabled" for this key. Nothing was charged; stop.
+  with the same idempotencyKey. Any other 503 from /v1/x402 means x402 is not
+  available for this key right now. Nothing new was charged; stop. Every server
+  code is listed below.
 - The agent key owns the balance. Store it 0600, never print or log it.
+x402 server error codes (returned by https://apiserver.mpprouter.dev/v1/x402/*):
+Every error body looks like
+{"ok":false,"code":"X402_...","error":{"code":"X402_...","message":"..."}},
+sometimes with extra top level fields (limitUsd, balanceUsd, ...).
+These are separate from the codes the CLI raises on its own (X402_UNSUPPORTED,
+X402_OVER_BUDGET, X402_BAD_CHALLENGE, X402_PAYMENT_REJECTED and others). The balance is
+debited only by the ledger commit inside /sign, after signing; every error
+raised before that commit charges nothing. If /sign answers
+X402_LEDGER_UNAVAILABLE or X402_INTERNAL the commit may have landed: retry
+with the same idempotencyKey, and a payment that did land comes back as the
+stored signature (replay:true), never as a second charge.
+The CLI reports every 503 except X402_RETRY, X402_PAYER_MODE_CHANGED and
+X402_LEDGER_UNAVAILABLE as X402_PAYER_DISABLED, with the server code in
+error.details.serverCode. On /sign it retries 429, 500, 502, 504 and those
+three 503 codes itself, with the same idempotencyKey.
+balance, topup and sign (keys does not read a key):
+- 401 X402_KEY_INVALID: agent key missing, malformed or unknown. Send
+  "Authorization: Bearer ak_...". Do not mint a new key to get around it: the
+  balance belongs to the old key.
+- 403 X402_KEY_SUSPENDED: the key is not active. Stop; email hi@rozo.ai.
+Any route:
+- 503 X402_PAYER_DISABLED: the payer is switched off. Stop, tell the user.
+- 503 X402_PAYER_NOT_CONFIGURED: payer not set up on this deployment. Stop.
+- 503 X402_LEDGER_UNAVAILABLE: ledger unreachable. Retry shortly with the same
+  idempotencyKey.
+- 500 X402_INTERNAL: unexpected error. Retry with the same idempotencyKey a few
+  times, then stop and report it.
+- 405 METHOD_NOT_ALLOWED: wrong HTTP method (keys/topup/sign are POST, balance is GET).
+POST /v1/x402/keys:
+- 429 X402_KEY_RATE_LIMITED: too many keys created from this IP this hour.
+  Reuse the key you have, or retry later.
+- 503 X402_RETRY: key collision. Retry.
+POST /v1/x402/topup (no deposit address is shown on any error, so nothing can
+be sent to it; only pay an address from a 200 response):
+- 400 X402_INVALID_REQUEST: body is not JSON, or amount is not a USD amount
+  with at most 2 decimals.
+- 400 X402_TOPUP_AMOUNT_OUT_OF_RANGE: top up must be between $5 and $500.
+- 400 X402_TOPUP_SOURCE_REQUIRED: say which coin you pay with: chain and
+  token. The response lists accepted chains.
+- 400 X402_UNSUPPORTED_CHAIN: unknown chain. Use a CAIP-2 id or a name such as
+  solana, base, ethereum, bsc, polygon, arbitrum, stellar.
+- 400 X402_TOPUP_SOURCE_UNSUPPORTED: that coin is not accepted for top ups.
+  Use USDC or USDT. May carry a "supported" list.
+- 502 INTENTS_API_FAILED: the top up order could not be created. Retry later.
+- 503 X402_TOPUP_MISCONFIGURED or X402_TOPUP_NOT_REGISTERED: the order was not
+  usable, the address was withheld. Retry later; email hi@rozo.ai if it repeats.
+- 503 X402_PAYER_SHADOW, X402_TOPUP_NOT_CONFIGURED or X402_SIGNER_NOT_CONFIGURED:
+  top ups are closed right now. Stop.
+POST /v1/x402/sign:
+- 400 X402_INVALID_REQUEST: body is not JSON, or budget is not a positive USD amount.
+- 400 X402_IDEMPOTENCY_KEY_REQUIRED: send idempotencyKey, 8 to 128 chars of
+  [A-Za-z0-9_.:-], one per 402 challenge.
+- 400 X402_UNSUPPORTED_VERSION: only x402Version 2 is accepted.
+- 400 X402_UNSUPPORTED_NETWORK, X402_UNSUPPORTED_SCHEME, X402_UNSUPPORTED_ASSET,
+  X402_INVALID_REQUIREMENT or X402_SIGN_UNSUPPORTED: the accepts entry is
+  malformed or asks for something not covered (only exact USDC is signed).
+  Do not retry the same entry; tell the user.
+- 402 X402_BUDGET_EXCEEDED: the challenge asks more than your budget. Stop and
+  ask the user.
+- 402 X402_PER_TX_LIMIT_EXCEEDED: above this key's single-payment limit
+  (limitUsd). Stop and ask the user.
+- 402 X402_INSUFFICIENT_BALANCE: balance too low (balanceUsd). Top up, wait
+  for the credit, then pay again.
+- 403 X402_PAYTO_NOT_ALLOWED: payTo is not on this key's allowlist. Stop.
+- 403 X402_PAYTO_BLOCKED: this payTo is blocked. Stop, do not retry.
+- 409 X402_IDEMPOTENCY_CONFLICT: this idempotencyKey was already used for a
+  different requirement. Nothing new was charged. Use a new key only for a new
+  402 challenge.
+- 410 X402_CREDENTIAL_REFUNDED: the stored signature expired unused and its
+  amount went back to the balance. Fetch a new 402 and sign it with a new key.
+- 429 X402_DAILY_LIMIT_EXCEEDED: this key's daily limit would be exceeded
+  (limitUsd, spentTodayUsd). Wait for the daily
+  window to reset, or ask hi@rozo.ai for a higher limit.
+- 429 X402_GLOBAL_DAILY_CAP_REACHED or X402_SIGNER_DAILY_CAP_REACHED: a
+  platform-wide daily cap was reached. Retry after 00:00 UTC.
+- 429 X402_SIGNER_CAP_REACHED: the signing service refused this amount. Try a
+  smaller payment or later.
+- 503 X402_RETRY or X402_PAYER_MODE_CHANGED: transient. Retry with the same
+  idempotencyKey.
+- 503 X402_PAYER_SHADOW: the payer is not live for this key. A fresh request
+  was checked and recorded but not signed, and nothing was charged. With
+  "replay":true it refers to an earlier payment under this idempotencyKey,
+  which may have been charged: check /balance, never pay again with a new key.
+  Stop.
+- 503 X402_SIGNER_NOT_CONFIGURED or X402_SIGNER_DISABLED: signing for this
+  network is off right now. Stop.
+A 200 with "replay":true is the stored signature for an idempotencyKey that
+was already paid; it is not a second charge.
 ## Safety rules (encode these, they prevent fund loss)
 - Before paying, require: status == "payment_unpaid" AND source.txHash == null AND

package/package.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "@rozoai/checkout",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
-  "description": "Pay OpenRouter, or any Coinbase invoice, with the crypto you already hold: USDT/USDC on Solana, BNB Chain, Ethereum or Polygon, USDC on Base or Stellar, or BTC over Lightning. No Coinbase account.",
+  "description": "Pay OpenRouter, or any Coinbase invoice, with the crypto you already hold: USDT/USDC on Solana, BNB Chain, Ethereum, Polygon or Arbitrum, USDC on Base or Stellar, BTC over Lightning, or native ETH, BNB, SOL or POL. No Coinbase account.",
   "license": "MIT",
   "author": "Rozo AI",
   "homepage": "https://github.com/RozoAI/rozo-checkout-skill#readme",
@@ -24,10 +24,15 @@
     "bnb-chain",
     "ethereum",
     "polygon",
+    "arbitrum",
     "base",
     "stellar",
     "lightning",
     "bitcoin",
+    "eth",
+    "bnb",
+    "sol",
+    "pol",
     "crypto-payments",
     "agent",
     "ai-agent",