@rozoai/checkout 0.1.0 → 0.1.1

package/{QUICKSTART.ja.md → docs/QUICKSTART.ja.md}

@@ -4,21 +4,34 @@
 
 OpenRouter の Coinbase 決済リンク (Payment Link) を、Solana、BNB Chain、
 Ethereum、Polygon、Base、Stellar 上の USDT/USDC、または Lightning 経由の BTC で支払います。所要 5 分。
-仕組みと設計意図については [README.md](README.md) を参照してください。
+仕組みと設計意図については [README.md](../README.md) を参照してください。
 
 ## ワンライナー
 
+```bash
+npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLINKID
+```
+
+これ 1 つで、以下の全ステップを実行します。通貨の選択、見積もり、注文作成、確認、承認、
+入金手順の表示、そして決済完了までのポーリングです。通貨を選ぶ場面でウォレットアドレスを
+貼り付けると、残高を調べてどの通貨なら支払えるかを表示します。これは任意で、実際に署名
+される内容は一切変わりません。
+
+使う通貨が決まっている場合は、指定すればこの質問を省略できます:
+
 ```bash
 npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLINKID --with usdt-solana
 ```
 
-これ 1 つで、以下の全ステップを実行します。見積もり、注文作成、確認、承認、入金手順の
-表示、そして決済完了までのポーリングです。`--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`。
+スクリプトやエージェントでは必ず `--with` を渡してください。対話式の選択は端末でのみ
+表示され、既定の通貨はありません。
 
-自分のウォレットではなくホットウォレットから支払う場合は `--send` を、機械可読な出力が
-必要な場合は `--json` を追加してください。
+既定では、任意のウォレットから支払うためのアドレスを表示するだけです — 鍵も設定も
+不要です。CLI にホットウォレットから署名させたい場合にだけ `--send` を、機械可読な
+出力が必要な場合は `--json` を追加してください。
 
 このページの残りは、同じフローを 1 ステップずつ実行するものです。うまくいかないときや、
 自分でスクリプトを書くときは、こちらが必要になります。
@@ -51,8 +64,8 @@ node scripts/dist/quote.js --url "$LINK"
 {
   "success": true,
   "merchant": "OpenRouter, Inc.",
-  "invoice": { "amount": "5.00", "fiat": { "amount": "5.00", "currency": "USD" } },
-  "callerPays": "5.00",
+  "invoice": { "amount": "1050.00", "fiat": { "amount": "1050.00", "currency": "USD" } },
+  "callerPays": "1050.00",
   "coinbaseExpiryIso": "2026-08-09T10:00:00.000Z"
 }
 ```
@@ -73,19 +86,21 @@ node scripts/dist/create-order.js --url "$LINK" --chain 900 --token USDT
 {
   "success": true,
   "rozoPaymentId": "11111111-2222-4333-8444-555555555555",
-  "invoice": { "amount": "5.000000", "currency": "USD" },
+  "invoice": { "amount": "1050.000000", "currency": "USD" },
   "deposit": null,
   "depositWithheld": true,
   "display": {
     "chain": "Solana",
-    "amount": "5.021000 USDT",
-    "payToMasked": "9WzDXw...AWWM",
-    "memoRequirement": "This deposit REQUIRES the memo/tag below. ..."
+    "amount": "1054.410000 USDT",
+    "payToMasked": "9WzDXw...AWWM"
   },
   "expiry": { "effectiveDeadlineIso": "2026-08-08T11:00:00.000Z", "minutesOfSlack": 55 }
 }
 ```
 
+この例は代表的なケースです。$1,000 分の OpenRouter クレジットに対する **$1,050.00**
+のインボイスです。**$1,100** までのインボイスであれば同じ方法で支払えます。
+
 **先へ進む前に必ず `display.amount` を確認してください。** 通常はインボイス金額より
 大きくなります — ブリッジ (bridge) 手数料とネットワーク手数料が含まれるためです。`rozoPaymentId` を
 控えておいてください。以降のコマンドはすべてこれを使います。
@@ -109,23 +124,37 @@ node scripts/dist/create-order.js --url "$LINK" --chain 900 --token USDT --confi
     "tokenSymbol": "USDT",
     "receiverAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
     "receiverMemo": "rozo-901",
-    "amount": "5.021000",
+    "amount": "1054.410000",
     "payTo": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
   }
 }
 ```
 
-Lightning の場合、`deposit.lnInvoice` にスキャン用の BOLT11 文字列が入り、
-`deposit.amount` は satoshi 単位になります。
+このブロックが示すフィールドを、そのとおりに送金してください。Lightning の場合、
+`deposit.lnInvoice` にスキャン用の BOLT11 文字列が入り、`deposit.amount` は
+satoshi 単位になります。
 
 ## 4. 支払う
 
-どちらか一方を選びます。**モード A** — 自分のウォレットから支払う: `deposit.chain` 上で、
-`deposit.tokenSymbol` をちょうど `deposit.amount` だけ `deposit.receiverAddress` へ送金します。
-`deposit.receiverMemo` がある場合はそれも付けてください。アドレスは JSON から
-コピーしてください。決して手入力し直さないでください。
+### 簡単な方法: 自分のウォレットから
+
+**秘密鍵も環境変数も設定も一切不要です。** 好きなウォレットを開き、上の `deposit`
+ブロックが示すとおりに送金してください:
+
+- `tokenSymbol` を `amount` だけ、
+- `chain` の上で、
+- `receiverAddress` へ — JSON からコピーし、決して手入力し直さないでください。
+
+ブロックに `receiverMemo` などそれ以外のフィールドが含まれている場合は、示されたとおりに
+そのまま付けてください。それはそのチェーンにおけるアドレスの一部です。Lightning の場合は
+代わりに `deposit.lnInvoice` をスキャンするか貼り付けてください。
+
+モード A はこれで全部です。ステップ 5 へ進んでください。
+
+### 任意の方法: スクリプトに支払わせる（モード B）
 
-**モード B** — スクリプトにホットウォレットから支払わせる（EVM と Solana のみ）:
+このマシンに署名させたい場合にだけ、そして EVM チェーンと Solana でのみ使えます。
+秘密鍵が必要なのはこの部分だけです:
 
 ```bash
 # 署名される内容を正確にプレビューします — 署名は一切行いません
@@ -138,7 +167,8 @@ ROZO_CHECKOUT_SOL_KEY=<base58 secret key> \
 ```
 
 Ethereum、BNB Chain、Polygon、Base では `send-evm.js` を `ROZO_CHECKOUT_EVM_KEY` と
-併せて使います。上限: トランザクションごとに $100、セッションごとに $200。
+併せて使います。1 回の支払いは **$1,100** を超えられません。それを超える場合は、上記の
+とおり自分のウォレットから支払ってください。
 
 ```json
 {
@@ -183,5 +213,5 @@ node scripts/dist/status.js --rozo-payment-id <rozoPaymentId> --watch --timeout
 依頼してください。使い捨ての入金アドレスへの 2 回目の支払いは、入金として反映される
 保証がありません。
 
-エラーコードの完全な一覧は [README.md](README.md) に、エージェント向けの指示は
-[SKILL.md](SKILL.md) にあります。
+エラーコードの完全な一覧は [README.md](../README.md) に、エージェント向けの指示は
+[SKILL.md](../SKILL.md) にあります。

package/{QUICKSTART.md → docs/QUICKSTART.md}

@@ -4,21 +4,34 @@
 
 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.
-For how it works and why, see [README.md](README.md).
+For how it works and why, see [README.md](../README.md).
 
 ## The one-liner
 
+```bash
+npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLINKID
+```
+
+That runs every step below for you: pick a coin, quote, create, review,
+confirm, deposit instructions, then polling until settlement. At the coin
+prompt you can paste your wallet address and the picker will check your
+balances and mark which coins you can afford — optional, and it never changes
+what gets signed.
+
+If you already know your coin, name it and skip the question:
+
 ```bash
 npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLINKID --with usdt-solana
 ```
 
-That runs every step below for you: quote, create, review, confirm, deposit
-instructions, then polling until settlement. 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`.
+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.
 
-Add `--send` to pay from a hot wallet rather than your own, and `--json` for
-machine-readable output.
+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
+from a hot wallet instead, and `--json` for machine-readable output.
 
 The rest of this page is the same flow run one step at a time, which is what
 you want if something goes wrong or you are scripting it yourself.
@@ -51,8 +64,8 @@ node scripts/dist/quote.js --url "$LINK"
 {
   "success": true,
   "merchant": "OpenRouter, Inc.",
-  "invoice": { "amount": "5.00", "fiat": { "amount": "5.00", "currency": "USD" } },
-  "callerPays": "5.00",
+  "invoice": { "amount": "1050.00", "fiat": { "amount": "1050.00", "currency": "USD" } },
+  "callerPays": "1050.00",
   "coinbaseExpiryIso": "2026-08-09T10:00:00.000Z"
 }
 ```
@@ -73,19 +86,21 @@ is **withheld** at this stage — you get a masked summary to check first.
 {
   "success": true,
   "rozoPaymentId": "11111111-2222-4333-8444-555555555555",
-  "invoice": { "amount": "5.000000", "currency": "USD" },
+  "invoice": { "amount": "1050.000000", "currency": "USD" },
   "deposit": null,
   "depositWithheld": true,
   "display": {
     "chain": "Solana",
-    "amount": "5.021000 USDT",
-    "payToMasked": "9WzDXw...AWWM",
-    "memoRequirement": "This deposit REQUIRES the memo/tag below. ..."
+    "amount": "1054.410000 USDT",
+    "payToMasked": "9WzDXw...AWWM"
   },
   "expiry": { "effectiveDeadlineIso": "2026-08-08T11:00:00.000Z", "minutesOfSlack": 55 }
 }
 ```
 
+This example is the flagship case: a **$1,050.00** invoice for $1,000 of
+OpenRouter credits. Any invoice up to **$1,100** can be paid this way.
+
 **Check `display.amount` before going on.** It is normally larger than the
 invoice — it includes the bridge and network fees. Note the `rozoPaymentId`;
 every later command uses it.
@@ -110,23 +125,37 @@ scripts require.
     "tokenSymbol": "USDT",
     "receiverAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
     "receiverMemo": "rozo-901",
-    "amount": "5.021000",
+    "amount": "1054.410000",
     "payTo": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
   }
 }
 ```
 
-For Lightning, `deposit.lnInvoice` holds the BOLT11 string to scan, and
-`deposit.amount` is in satoshis.
+Send exactly the fields this block gives you. For Lightning,
+`deposit.lnInvoice` holds the BOLT11 string to scan, and `deposit.amount` is
+in satoshis.
 
 ## 4. Pay
 
-Pick one. **Mode A** — pay from your own wallet: send exactly
-`deposit.amount` of `deposit.tokenSymbol` to `deposit.receiverAddress`, on
-`deposit.chain`, including `deposit.receiverMemo` if there is one. Copy the
-address from the JSON; never retype it.
+### The simple way: from your own wallet
+
+**No key, no environment variable, no configuration.** Open any wallet, and
+send exactly what the `deposit` block above says:
+
+- the `amount` of the `tokenSymbol`,
+- on the `chain`,
+- to the `receiverAddress` — copied from the JSON, never retyped.
+
+If the block contains any other field, such as `receiverMemo`, include it
+exactly as given; it is part of the address for that chain. For Lightning,
+scan or paste `deposit.lnInvoice` instead.
+
+That is the whole of Mode A. Skip to step 5.
+
+### The optional way: let the script pay (Mode B)
 
-**Mode B** — let the script pay from a hot wallet (EVM and Solana only):
+Only if you want this machine to sign for you, and only on EVM chains and
+Solana. This is the only part that needs a private key:
 
 ```bash
 # Preview exactly what would be signed — signs nothing
@@ -139,7 +168,8 @@ ROZO_CHECKOUT_SOL_KEY=<base58 secret key> \
 ```
 
 Use `send-evm.js` with `ROZO_CHECKOUT_EVM_KEY` for Ethereum, BNB Chain,
-Polygon and Base. Caps: $100 per transaction, $200 per session.
+Polygon and Base. A single payment may not exceed **$1,100**; above that, pay
+from your own wallet as above.
 
 ```json
 {
@@ -184,5 +214,5 @@ Read `error.code`. The three you are most likely to hit:
 reconcile it. A second payment to a one-time deposit address is not guaranteed
 to be credited.
 
-The full error table is in [README.md](README.md), and the agent-facing
-instructions are in [SKILL.md](SKILL.md).
+The full error table is in [README.md](../README.md), and the agent-facing
+instructions are in [SKILL.md](../SKILL.md).

package/{QUICKSTART.zh.md → docs/QUICKSTART.zh.md}

@@ -4,17 +4,25 @@
 
 用 Solana、BNB Chain、Ethereum、Polygon、Base 或 Stellar 上的 USDT/USDC，或者用走
 Lightning 的 BTC，去支付一个 OpenRouter Coinbase 收款链接 (Payment Link)。五分钟搞定。
-工作原理与设计理由见 [README.md](README.md)。
+工作原理与设计理由见 [README.md](../README.md)。
 
 ## 一行命令搞定
 
+```bash
+npx @rozoai/checkout pay https://payments.coinbase.com/payment-links/pl_01YOURLINKID
+```
+
+这一条命令会替你跑完下面的每一步：选币、报价、创建订单、核对、确认、充值指令，然后一直轮询到结清。在选币那一步，你可以粘贴自己的钱包地址，它会去查余额并标出哪些币你付得起 —— 这是可选的，而且不会改变任何实际签名的内容。
+
+如果你已经知道要用哪种币，直接指定就能跳过这一问：
+
 ```bash
 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`。
+`--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`：交互式选择只在终端里出现，而且没有默认币种。
 
-加 `--send` 就用热钱包付款而不是用你自己的钱包，加 `--json` 输出机器可读格式。
+默认情况下它只是打印一个地址，让你用任意钱包去付 —— 不需要私钥，也不需要任何配置。只有当你想让 CLI 改从热钱包签名时才加 `--send`；加 `--json` 输出机器可读格式。
 
 本页剩下的内容就是同一套流程，只不过一步一步来 —— 如果出了问题，或者你想自己写脚本，那才需要看它们。
 
@@ -46,8 +54,8 @@ node scripts/dist/quote.js --url "$LINK"
 {
   "success": true,
   "merchant": "OpenRouter, Inc.",
-  "invoice": { "amount": "5.00", "fiat": { "amount": "5.00", "currency": "USD" } },
-  "callerPays": "5.00",
+  "invoice": { "amount": "1050.00", "fiat": { "amount": "1050.00", "currency": "USD" } },
+  "callerPays": "1050.00",
   "coinbaseExpiryIso": "2026-08-09T10:00:00.000Z"
 }
 ```
@@ -68,19 +76,21 @@ node scripts/dist/create-order.js --url "$LINK" --chain 900 --token USDT
 {
   "success": true,
   "rozoPaymentId": "11111111-2222-4333-8444-555555555555",
-  "invoice": { "amount": "5.000000", "currency": "USD" },
+  "invoice": { "amount": "1050.000000", "currency": "USD" },
   "deposit": null,
   "depositWithheld": true,
   "display": {
     "chain": "Solana",
-    "amount": "5.021000 USDT",
-    "payToMasked": "9WzDXw...AWWM",
-    "memoRequirement": "This deposit REQUIRES the memo/tag below. ..."
+    "amount": "1054.410000 USDT",
+    "payToMasked": "9WzDXw...AWWM"
   },
   "expiry": { "effectiveDeadlineIso": "2026-08-08T11:00:00.000Z", "minutesOfSlack": 55 }
 }
 ```
 
+本例即旗舰场景：一张 **$1,050.00** 的账单，用于购买 $1,000 的 OpenRouter 额度。
+任何不超过 **$1,100** 的账单都可以这样支付。
+
 **继续之前务必核对 `display.amount`。** 它通常大于账单金额 —— 因为它包含了跨桥费用和
 网络费用。记下 `rozoPaymentId`；后面每一条命令都要用它。
 
@@ -103,22 +113,35 @@ node scripts/dist/create-order.js --url "$LINK" --chain 900 --token USDT --confi
     "tokenSymbol": "USDT",
     "receiverAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
     "receiverMemo": "rozo-901",
-    "amount": "5.021000",
+    "amount": "1054.410000",
     "payTo": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
   }
 }
 ```
 
-对于 Lightning，`deposit.lnInvoice` 里是供扫码的 BOLT11 字符串，`deposit.amount`
-的单位是聪 (satoshis)。
+严格按这个信息块给出的字段来发送。对于 Lightning，`deposit.lnInvoice` 里是供扫码的
+BOLT11 字符串，`deposit.amount` 的单位是聪 (satoshis)。
 
 ## 4. 付款
 
-二选一。**模式 A** —— 用你自己的钱包付：在 `deposit.chain` 上，把恰好
-`deposit.amount` 数量的 `deposit.tokenSymbol` 发送到 `deposit.receiverAddress`，
-如果有 `deposit.receiverMemo` 就带上它。地址直接从 JSON 里复制；绝不要手打重输。
+### 最简单的方式：用你自己的钱包
+
+**无需私钥、无需环境变量、无需任何配置。** 打开任意一个钱包，严格按上面那个
+`deposit` 信息块所写的去发送：
+
+- `amount` 数量的 `tokenSymbol`，
+- 在 `chain` 这条链上，
+- 发往 `receiverAddress` —— 从 JSON 里复制，绝不要手打重输。
+
+如果这个信息块里还有别的字段，比如 `receiverMemo`，就原样一并带上；在那条链上它属于
+地址的一部分。对于 Lightning，改为扫码或粘贴 `deposit.lnInvoice`。
+
+模式 A 到这里就全部结束了。直接跳到第 5 步。
+
+### 可选的方式：让脚本替你付（模式 B）
 
-**模式 B** —— 让脚本从热钱包付款（仅限 EVM 与 Solana）：
+只有当你想让这台机器替你签名时才需要，而且仅限 EVM 链与 Solana。这是唯一需要私钥的
+部分：
 
 ```bash
 # 预览将要签名的确切内容 —— 不会签任何名
@@ -131,7 +154,7 @@ ROZO_CHECKOUT_SOL_KEY=<base58 secret key> \
 ```
 
 Ethereum、BNB Chain、Polygon 和 Base 用 `send-evm.js` 配合 `ROZO_CHECKOUT_EVM_KEY`。
-额度上限：单笔 $100，单会话 $200。
+单笔付款不得超过 **$1,100**；超过这个数就按上面的方式用你自己的钱包付。
 
 ```json
 {
@@ -175,4 +198,4 @@ node scripts/dist/status.js --rozo-payment-id <rozoPaymentId> --watch --timeout
 `rozoPaymentId` 和每一个交易 hash，找人来做对账。向一个一次性充值地址付第二笔款，
 并不保证会被入账。
 
-完整的错误码表在 [README.md](README.md)，面向 agent 的指令在 [SKILL.md](SKILL.md)。
+完整的错误码表在 [README.md](../README.md)，面向 agent 的指令在 [SKILL.md](../SKILL.md)。

package/docs/README.es.md

@@ -0,0 +1,251 @@
+# rozo-checkout
+
+[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
+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.
+
+```bash
+npx @rozoai/checkout pay <coinbase-link>
+```
+
+Primero pregunta con qué moneda se quiere pagar —al pegar la dirección de la
+billetera en el prompt, marca cuáles se pueden pagar con el saldo disponible— y
+luego imprime una dirección de depósito para pagar desde cualquier billetera
+—**sin clave privada, sin variable de entorno, sin configuración**—. Después
+espera hasta que la factura quede liquidada.
+
+¿Ya se sabe qué moneda usar? Se puede omitir la pregunta:
+
+```bash
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+## Monedas con las que se puede pagar
+
+| Cadena | `--with` | Id de cadena | Notas |
+|---|---|---|---|
+| 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 |
+| Base | `usdc-base` | `8453` | 6 decimales |
+| Solana | `usdt-solana` `usdc-solana` | `900` | SPL; SOL nativo no admitido |
+| Stellar | `usdc-stellar` | `1500` | memo 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.
+
+## Usarlo desde el agente
+
+La carga útil es la misma en todas partes: el comando de una línea de arriba, o
+apuntar al agente a [llms.txt](../llms.txt). **Pagar desde la propia billetera
+nunca necesita una clave.** Solo la bandera opcional `--send` firma en local, y
+solo esa bandera lee `ROZO_CHECKOUT_EVM_KEY` / `ROZO_CHECKOUT_SOL_KEY`. Los agentes y los scripts deben
+pasar siempre `--with`: el selector solo aparece en una terminal y no hay moneda
+por defecto de forma deliberada.
+
+<details>
+<summary><b>Claude Code</b> — instalar la habilidad, o pegar el comando de una línea</summary>
+
+Este repositorio es una habilidad de Claude Code: incluye `SKILL.md` más los
+ejecutables de `scripts/dist/`. Basta con clonarlo en el directorio de
+habilidades y Claude Code lo detecta automáticamente.
+
+```bash
+git clone https://github.com/RozoAI/rozo-checkout-skill ~/.claude/skills/rozo-checkout
+```
+
+O saltarse la instalación y simplemente pedirle que ejecute:
+
+```
+Paga este enlace de OpenRouter con USDT en Solana:
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. Añadir `--send` solo si se quiere
+que Claude firme desde una billetera caliente, lo cual necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>Codex CLI</b> — AGENTS.md, o ejecutarlo directamente</summary>
+
+Codex lee `AGENTS.md` desde la raíz del proyecto. Conviene añadir una
+instrucción permanente para que sepa cómo pagar sin que haya que explicárselo
+cada vez:
+
+```
+Para pagar un enlace de pago de OpenRouter / Coinbase, ejecuta:
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>OpenCode</b> — AGENTS.md, o ejecutarlo directamente</summary>
+
+OpenCode también lee `AGENTS.md` desde la raíz del proyecto, así que el fragmento
+de Codex de arriba funciona sin cambios. El camino más corto sigue siendo el
+propio comando:
+
+```bash
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>Cline</b> — .clinerules, o ejecutarlo directamente</summary>
+
+Cline lee las instrucciones permanentes desde `.clinerules` en la raíz del proyecto:
+
+```
+Para pagar un enlace de pago de OpenRouter / Coinbase, ejecuta:
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>Cursor</b> — .cursor/rules, o ejecutarlo directamente</summary>
+
+Añadir una regla de proyecto en `.cursor/rules/rozo-checkout.mdc`:
+
+```
+Para pagar un enlace de pago de OpenRouter / Coinbase, ejecuta:
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>Hermes Agent</b> — ejecutar el comando de una línea en una sesión</summary>
+
+Hermes Agent (Nous Research) tiene acceso a la shell y su propio sistema de
+habilidades. Se inicia con `hermes` y se le pide:
+
+```
+Descarga https://checkout.rozo.ai/llms.txt y luego paga este enlace de OpenRouter:
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>OpenClaw</b> — openclaw agent exec</summary>
+
+El punto de entrada headless de OpenClaw ejecuta una tarea puntual, lo que encaja
+con un pago que se dispara desde un script o desde un canal de chat:
+
+```bash
+openclaw agent exec "Pay this OpenRouter link with USDT on Solana by running: npx @rozoai/checkout pay <coinbase-link> --with usdt-solana"
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>Pi</b> — ejecutar el comando de una línea en una sesión</summary>
+
+Pi es un agente de terminal BYOK cuyas herramientas integradas incluyen `bash`,
+así que puede ejecutar el comando directamente. Se inicia con `pi` y se le pide:
+
+```
+Paga este enlace de OpenRouter con USDT en Solana ejecutando:
+npx @rozoai/checkout pay <coinbase-link> --with usdt-solana
+```
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+<details>
+<summary><b>Terminal — sin ningún agente</b> — ejecutar los scripts paso a paso</summary>
+
+Conducir cada paso a mano. Los paquetes son autocontenidos; no hay nada que
+instalar más allá de Node 18+.
+
+```bash
+git clone https://github.com/RozoAI/rozo-checkout-skill && cd rozo-checkout-skill
+LINK="https://payments.coinbase.com/payment-links/pl_01YOURLINKID"
+
+# Cotización de solo lectura, no cuesta nada
+node scripts/dist/quote.js --url "$LINK"
+
+# Crear la orden. Aquí se RETIENE la dirección de depósito completa; primero se
+# obtiene un resumen enmascarado para revisar.
+node scripts/dist/create-order.js --url "$LINK" --chain 900 --token USDT
+
+# Una vez decidido el pago, volver a ejecutar con --confirm para liberarla
+node scripts/dist/create-order.js --url "$LINK" --chain 900 --token USDT --confirm
+
+# Pagar el bloque de depósito desde cualquier billetera y observar la liquidación
+node scripts/dist/status.js --rozo-payment-id <uuid> --watch
+```
+
+Cada script imprime exactamente un objeto JSON en stdout. Código de salida `0`
+éxito, `1` rechazado/fallido (leer `error.code`), `2` uso incorrecto, `3` enviado
+pero sin confirmar. Recorrido completo: [QUICKSTART](QUICKSTART.es.md).
+
+Billetera: cualquier billetera, **sin clave**. Para el envío desde billetera
+caliente, ver `send-evm.js` / `send-sol.js`, que leen `ROZO_CHECKOUT_EVM_KEY` /
+`ROZO_CHECKOUT_SOL_KEY`.
+</details>
+
+<details>
+<summary><b>Cualquier otro agente</b> — apuntarlo a llms.txt</summary>
+
+Cualquier agente capaz de descargar una URL y ejecutar un comando puede hacer esto:
+
+```
+Descarga https://checkout.rozo.ai/llms.txt a tu contexto y úsalo
+para pagar este enlace de OpenRouter: <coinbase-link>
+```
+
+Si el agente no tiene shell pero puede hacer peticiones HTTP, puede manejar
+directamente los cuatro endpoints públicos — ver [cómo funciona](how-it-works.md).
+
+Billetera: cualquier billetera, **sin clave**. `--send` sí necesita la clave del entorno.
+</details>
+
+## Tres reglas que conviene conocer
+
+- **La dirección de depósito es de un solo uso.** Nunca reutilizar una de una
+  orden anterior, de una respuesta cacheada o de una captura de pantalla.
+- **Enviar exactamente el importe mostrado.** Normalmente es mayor que la
+  factura: incluye las comisiones del puente y de la red.
+- **Nunca pagar dos veces una orden ya fondeada.** Si ya se ha detectado un
+  pago, detenerse y pedir a una persona que lo concilie; un segundo pago a una
+  dirección de un solo uso no tiene garantía de ser acreditado.
+
+La lista completa de lo que esta herramienta se niega a hacer, y por qué, está en
+[docs/safety.md](safety.md).
+
+## Enlaces
+
+- [Inicio rápido](QUICKSTART.es.md) — los cinco comandos, con la salida esperada
+- [Cómo funciona](how-it-works.md) — el flujo, los endpoints, los identificadores
+- [Diseño de seguridad](safety.md) — cada salvaguarda, en detalle
+- [SKILL.md](../SKILL.md) — instrucciones dirigidas al agente · [llms.txt](../llms.txt) — resumen en un solo archivo
+- [checkout.rozo.ai/agent](https://checkout.rozo.ai/agent.html) — lo mismo, en la web
+- [Issues](https://github.com/RozoAI/rozo-checkout-skill/issues) — errores y solicitudes
+
+## Registro de cambios
+
+- **0.1.1** — un solo límite de gasto en lugar de dos: un pago individual no
+  puede superar los $1,100 (dimensionado para una compra de crédito de $1,000
+  más su comisión del 5%); se eliminan el tope acumulado por sesión y la bandera
+  `--yes-large`. La documentación deja explícito que pagar desde la propia
+  billetera no necesita clave ni configuración.
+- **0.1.0** — primera versión: `npx @rozoai/checkout`.
+
+## Licencia
+
+MIT.