@rozoai/checkout 0.1.20 → 0.1.22

package/README.md

@@ -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,35 @@ 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.
+ZEC on Zcash (Beta): use https://checkout.rozo.ai/zec, this CLI does not create ZEC orders.
 
 ## Which wallet do I need?
 
@@ -88,8 +112,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 +192,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 +462,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 +512,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

@@ -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,18 @@ 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.
+ZEC en Zcash (Beta): usa https://checkout.rozo.ai/zec, esta CLI no crea órdenes en ZEC.
 
 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 +64,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

@@ -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,16 @@ 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 には対応していません。
+Zcash の ZEC（Beta）は https://checkout.rozo.ai/zec を使ってください。この CLI では ZEC の注文は作れません。
+
 既定では、任意のウォレットから支払うためのアドレスを表示するだけです — 鍵も設定も
 不要です。CLI にホットウォレットから署名させたい場合にだけ `--send` を、機械可読な
 出力が必要な場合は `--json` を追加してください。
@@ -52,7 +58,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

@@ -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,17 @@ 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.
+ZEC on Zcash (Beta): use https://checkout.rozo.ai/zec, this CLI does not create ZEC orders.
 
 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 +61,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

@@ -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 不支持。Zcash 上的 ZEC（Beta）：请用 https://checkout.rozo.ai/zec，本 CLI 不创建 ZEC 订单。
 
 默认情况下它只是打印一个地址，让你用任意钱包去付 —— 不需要私钥，也不需要任何配置。只有当你想让 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

@@ -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,27 @@ 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.
+ZEC en Zcash (Beta): usa https://checkout.rozo.ai/zec, esta CLI no crea órdenes en ZEC.
 
 ## ¿Qué wallet necesito?
 

package/docs/README.ja.md

@@ -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,27 @@ 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 には対応していません。
+Zcash の ZEC（Beta）は https://checkout.rozo.ai/zec を使ってください。この CLI では ZEC の注文は作れません。
 
 ## どのウォレットが必要ですか？
 

package/docs/README.zh.md

@@ -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,27 @@ 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 不支持。
+Zcash 上的 ZEC（Beta）：请用 https://checkout.rozo.ai/zec，本 CLI 不创建 ZEC 订单。
 
 ## 我需要什么钱包？
 

package/llms.txt

@@ -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,24 @@ 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.
+ZEC on Zcash (Beta): use https://checkout.rozo.ai/zec, this CLI does not create ZEC orders.
+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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@rozoai/checkout",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "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",