@bankofbots/skill 0.4.2 → 0.5.0

package/SKILL.md

@@ -10,14 +10,13 @@ metadata: '{"openclaw":{"requires":{"env":["BOB_API_KEY","BOB_AGENT_ID"]},"optio
 
 ## Core concepts
 
-Bank of Bots v0 is a non-custodial payment proof and trust layer. Agents submit cryptographic proofs of Bitcoin payments they made externally. Each proof builds credit history and raises their BOB Score — a 0–1000 reputation score that represents long-term financial trustworthiness.
+BOB (beta) is a non-custodial payment proof and trust layer. Agents submit cryptographic proofs of Bitcoin payments they made externally. Each proof builds credit history and raises their BOB Score — a 0–1000 reputation score that represents long-term financial trustworthiness.
 
 - **Agent**: An AI agent with its own identity and BOB Score
-- **Payment Intent**: A structured outbound payment — quote routes, execute, optionally submit a proof
-- **Payment Proof**: Cryptographic evidence of a BTC payment (onchain txid, Lightning payment hash, or preimage)
+- **Payment Proof**: Cryptographic evidence of an on-chain transaction (BTC, ETH, Base, or SOL txid/hash)
 - **BOB Score**: 0–1000 reputation score derived from proof history, wallet binding, and social signals
 - **Credit Event**: A scored action that changed the agent's BOB Score (proof submitted, wallet bound, etc.)
-- **Wallet Binding**: Proof of ownership over an external EVM or Lightning wallet — a trust signal for BOB Score
+- **Wallet Binding**: Proof of ownership over an external EVM wallet — a trust signal for BOB Score
 
 ## Commands
 
@@ -45,63 +44,25 @@ bob agent list
 bob agent approve <agent-id>
 ```
 
-### Quote and execute payment intents
+<!-- Payment intents and Lightning proofs are not yet available. Currently only historical on-chain proof imports are supported. -->
+<!-- ### Quote and execute payment intents / ### Submit payment proofs — DISABLED -->
 
-The intent workflow quotes routes before executing, giving visibility into fees, ETAs, and available rails.
+### Submit on-chain proofs (primary flow)
 
-```bash
-# Quote routes for a BTC payment
-bob intent quote <agent-id> --amount <sats> --destination-type raw --destination-ref <lnbc...|bc1...>
-
-# Execute a quoted intent (uses best quote by default)
-bob intent execute <agent-id> <intent-id> [--quote-id <id>]
-
-# Check intent status
-bob intent get <agent-id> <intent-id>
-
-# List recent intents
-bob intent list <agent-id>
-```
-
-| Flag | Description |
-|---|---|
-| `--amount` | Required. Amount in satoshis |
-| `--destination-type` | `raw` or `bob_address` |
-| `--destination-ref` | Lightning invoice, on-chain address, or `alias@bobscore.ai` |
-| `--priority` | `cheapest`, `fastest`, or `balanced` (default: balanced) |
-| `--rail` | Pin to a specific rail: `lightning` or `onchain` |
-
-### Submit payment proofs
-
-Proofs are the primary way to build credit history and increase BOB Score.
-
-```bash
-# Submit an on-chain BTC proof
-bob intent submit-proof <agent-id> <intent-id> --txid <txid>
-
-# Submit a Lightning payment hash
-bob intent submit-proof <agent-id> <intent-id> --payment-hash <hash>
-
-# Submit a Lightning preimage (strongest confidence)
-bob intent submit-proof <agent-id> <intent-id> --preimage <hex> --proof-ref <payment-hash>
-
-# List proofs submitted for an intent
-bob intent proofs <agent-id> <intent-id>
-```
+Agents submit historical on-chain transaction proofs. BOB verifies them on the public ledger and awards credit.
 
 **Proof confidence tiers** (strongest → weakest):
-- `strong` — preimage verified (SHA256 matches payment hash)
-- `medium` — payment hash verified
+- `strong` — on-chain tx confirmed (sufficient confirmations on public ledger)
 - `provisional` — on-chain tx detected, awaiting confirmations
-- `low` — unverified
 
 Proof responses include a `credit` object with `awarded`, `delta`, and `reason` so agents can track score impact.
 
-### Import historical BTC proofs
+### Import historical on-chain proofs
 
-Build credit history from past payments you made before joining the network.
+Build credit history by importing on-chain transactions. BOB verifies each tx on the public ledger and awards credit.
 
 ```bash
+# BTC on-chain
 bob agent credit-import <agent-id> \
   --proof-type btc_onchain_tx \
   --proof-ref <txid> \
@@ -110,9 +71,32 @@ bob agent credit-import <agent-id> \
   --amount <sats> \
   --direction outbound
 
-# Also supports:
-#   --proof-type btc_lightning_payment_hash --proof-ref <hash>
-#   --proof-type btc_lightning_preimage --proof-ref <preimage>
+# ETH on-chain (Ethereum mainnet)
+bob agent credit-import <agent-id> \
+  --proof-type eth_onchain_tx \
+  --proof-ref <0x...txhash> \
+  --rail ethereum \
+  --currency ETH \
+  --amount <gwei> \
+  --direction outbound
+
+# Base L2 on-chain
+bob agent credit-import <agent-id> \
+  --proof-type base_onchain_tx \
+  --proof-ref <0x...txhash> \
+  --rail base \
+  --currency ETH \
+  --amount <gwei> \
+  --direction outbound
+
+# Solana on-chain
+bob agent credit-import <agent-id> \
+  --proof-type sol_onchain_tx \
+  --proof-ref <txsig> \
+  --rail solana \
+  --currency SOL \
+  --amount <lamports> \
+  --direction outbound
 
 # List imported historical proofs
 bob agent credit-imports <agent-id> [--limit 50] [--offset 0]
@@ -160,8 +144,8 @@ bob score signals --signal github --visible true
 **Trust signals that drive score:**
 - Email (10 pts), Phone (10 pts), GitHub (20 pts), Twitter/X (20 pts)
 - KYC/Identity (75 pts), Deposit (100 pts)
-- EVM wallet binding (variable), Lightning wallet binding (variable)
-- Payment proof history (1–10 pts per proof, by amount + confidence)
+- EVM wallet binding (variable)
+- On-chain proof history (1–10 pts per proof, by amount + confirmation depth)
 
 ### Bind a wallet (trust signal for BOB Score)
 
@@ -170,10 +154,6 @@ bob score signals --signal github --visible true
 bob binding evm-challenge
 bob binding evm-verify --address <0x...> --signature <sig>
 
-# Lightning node
-bob binding lightning-challenge <agent-id>
-bob binding lightning-verify <agent-id> --node-pubkey <pubkey> --signature <sig>
-
 # List bindings
 bob binding list
 
@@ -181,6 +161,8 @@ bob binding list
 bob binding delete <binding-id>
 ```
 
+<!-- Lightning node binding is not yet available. -->
+
 ### Social signals
 
 ```bash
@@ -202,7 +184,7 @@ bob webhook update <agent-id> <webhook-id> --active true
 bob webhook delete <agent-id> <webhook-id>
 ```
 
-**v0 event types:** `proof.verified`, `proof.rejected`, `credit.updated`, `payment_intent.settled`, `payment_intent.failed`
+**Event types:** `proof.verified`, `proof.rejected`, `credit.updated`
 
 ### Inbox
 
@@ -251,13 +233,13 @@ Always check `ok` before using `data`. When `ok` is false, `data.error` contains
 |---|---|
 | `403 Forbidden` | Run `bob auth me` — API key may be invalid or agent not approved |
 | `429 Too Many Requests` | Back off and retry; check `next_actions` for suggested wait |
-| Proof verification failed | Use preimage instead of payment hash when available; confirm txid is settled |
+| Proof verification failed | Confirm the tx is settled on-chain with sufficient confirmations |
 | Challenge expired | Re-run the challenge command to get a fresh nonce |
 | Claim code rejected | Generate a new one from the dashboard |
 
 ## Important rules
 
-1. **Amounts** are always in satoshis for BTC.
-2. **Proofs are non-custodial** — Bank of Bots never holds your BTC. You pay externally and submit proof.
-3. **Preimage > hash > txid** — Use the strongest proof type available for the highest confidence tier and best credit outcome.
+1. **Amounts** are in satoshis (BTC), gwei (ETH), or lamports (SOL).
+2. **Proofs are non-custodial** — Bank of Bots never holds funds. You transact externally and submit on-chain proof.
+3. **On-chain only** — Currently only historical on-chain proof imports are supported. Payment intents and Lightning proofs are not yet available.
 4. **next_actions**: Every response includes suggested follow-up commands. Follow them to discover what to do next.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bankofbots/skill",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Bank of Bots skill file for AI agents (Claude Code, OpenClaw, and compatible platforms)",
   "main": "index.js",
   "files": [

package/references/commands.md

@@ -23,50 +23,9 @@ bob agent credit-import <agent-id> --proof-type <type> --proof-ref <ref> \
 bob agent credit-imports <agent-id> [--limit 50] [--offset 0]
 ```
 
-## Intent workflow (quote → inspect → execute)
-
-```bash
-bob intent quote <agent-id> \
-  --amount <sats> \
-  --destination-type raw \
-  --destination-ref <lnbc...|bc1...>
-
-bob intent execute <agent-id> <intent-id> [--quote-id <id>]
-bob intent get <agent-id> <intent-id>
-bob intent list <agent-id>
-```
-
-| Flag | Description |
-|---|---|
-| `--amount` | Required. Satoshis for BTC, gwei for ETH, lamports for SOL |
-| `--destination-type` | `raw` or `bob_address` |
-| `--destination-ref` | Lightning invoice, on-chain address, or `alias@bobscore.ai` |
-| `--priority` | `cheapest`, `fastest`, or `balanced` (default: balanced) |
-| `--rail` | Pin to `lightning`, `onchain`, `ethereum`, `base`, or `solana` |
-| `--currency` | `BTC` (default), `ETH`, `SOL` |
-| `--max-fee` | Max fee in base units |
-
-## Proof submission
-
-```bash
-# On-chain BTC
-bob intent submit-proof <agent-id> <intent-id> --txid <txid>
-
-# Lightning payment hash
-bob intent submit-proof <agent-id> <intent-id> --payment-hash <hash>
-
-# Lightning preimage (strongest)
-bob intent submit-proof <agent-id> <intent-id> \
-  --preimage <hex> --proof-ref <payment-hash>
-
-# EVM or Solana
-bob intent submit-proof <agent-id> <intent-id> \
-  --proof-type eth_onchain_tx --proof-ref <txhash> [--chain-id 0x1]
-bob intent submit-proof <agent-id> <intent-id> \
-  --proof-type sol_onchain_tx --proof-ref <txsig>
-
-bob intent proofs <agent-id> <intent-id>   # list proofs for intent
-```
+<!-- Payment intents and Lightning proofs are not yet available. Currently only historical on-chain proof imports are supported. -->
+<!-- ## Intent workflow (quote → inspect → execute) — DISABLED -->
+<!-- ## Proof submission (bob intent submit-proof) — DISABLED -->
 
 ## BOB Score
 
@@ -83,12 +42,10 @@ bob score signals --signal github --visible true
 # EVM wallet (MetaMask, Coinbase, etc.)
 bob binding evm-challenge --address <0x...>
 bob binding evm-verify --challenge-id <id> --address <0x...> --signature <sig> [--chain-id 0x1]
-
-# Lightning node
-bob binding lightning-challenge <agent-id>
-bob binding lightning-verify <agent-id> --challenge-id <id> --signature <sig>
 ```
 
+<!-- Lightning node binding is not yet available. -->
+
 ## Social signals
 
 ```bash

package/references/errors.md

@@ -16,9 +16,9 @@ Every failed command returns `ok: false` with `data.error` and `next_actions`. A
 | 429 Too Many Requests | Back off and retry. Check `next_actions` for suggested wait. |
 | 409 Conflict | Resource already exists. Run `bob agent get` or `bob intent get` to confirm state. |
 | Proof already submitted | Duplicate proof ref — already counted. Check `bob agent credit-events <agent-id>`. |
-| Challenge expired | Re-run the binding challenge command (`bob binding evm-challenge` or `bob binding lightning-challenge`). |
+| Challenge expired | Re-run the binding challenge command (`bob binding evm-challenge`). |
 | Claim code rejected | Generate a new code from the dashboard. |
-| Proof verification failed | Use preimage instead of payment hash when available. Confirm tx is settled on-chain. |
+| Proof verification failed | Confirm the tx is settled on-chain with sufficient confirmations. Double-check the txid/hash and chain. |
 
 ## Output format
 

package/references/proofs.md

@@ -1,55 +1,67 @@
 # BOB Score — Proof Submission
 
-Submitting payment proofs verifies settlement and awards BOB Score credit. Stronger proof types earn more credit.
+Agents submit historical on-chain transaction proofs. BOB verifies each tx on the public ledger and awards credit.
+
+<!-- Payment intents and Lightning proofs (btc_lightning_preimage, btc_lightning_payment_hash) are not yet available. Currently only historical on-chain proof imports are supported. -->
 
 ## Proof types
 
 | Type | Flag(s) | Confidence | What it proves |
 |---|---|---|---|
-| `btc_lightning_preimage` | `--preimage <hex> --proof-ref <hash>` | **strong** | SHA256(preimage) == payment hash — cryptographically irrefutable |
-| `btc_lightning_payment_hash` | `--payment-hash <hash>` | **medium** | Payment hash observed on node |
-| `btc_onchain_tx` | `--txid <txid>` | **provisional→strong** | On-chain tx confirmed (upgrades as confirmations accumulate) |
-| `eth_onchain_tx` | `--proof-type eth_onchain_tx --proof-ref <txhash> [--chain-id 0x1]` | **medium→strong** | EVM on-chain tx (Ethereum mainnet or Base) |
-| `base_onchain_tx` | `--proof-type base_onchain_tx --proof-ref <txhash>` | **medium→strong** | Base L2 on-chain tx |
-| `sol_onchain_tx` | `--proof-type sol_onchain_tx --proof-ref <txsig>` | **medium→strong** | Solana on-chain tx |
-
-## Submit proof against a payment intent
-
-```bash
-# BTC on-chain
-bob intent submit-proof <agent-id> <intent-id> --txid <txid>
+| `btc_onchain_tx` | `--proof-type btc_onchain_tx --proof-ref <txid>` | **provisional→strong** | BTC on-chain tx confirmed (upgrades as confirmations accumulate) |
+| `eth_onchain_tx` | `--proof-type eth_onchain_tx --proof-ref <txhash>` | **provisional→strong** | Ethereum mainnet on-chain tx |
+| `base_onchain_tx` | `--proof-type base_onchain_tx --proof-ref <txhash>` | **provisional→strong** | Base L2 on-chain tx |
+| `sol_onchain_tx` | `--proof-type sol_onchain_tx --proof-ref <txsig>` | **provisional→strong** | Solana on-chain tx |
 
-# Lightning payment hash
-bob intent submit-proof <agent-id> <intent-id> --payment-hash <hash>
+**Confidence tiers:**
+- `strong` — on-chain tx confirmed with sufficient confirmations on public ledger
+- `provisional` — on-chain tx detected, awaiting confirmations
 
-# Lightning preimage (highest confidence)
-bob intent submit-proof <agent-id> <intent-id> \
-  --preimage <hex> --proof-ref <payment-hash>
+<!-- Intent-based proof submission (bob intent submit-proof) is not yet available. -->
 
-# EVM on-chain (Ethereum mainnet)
-bob intent submit-proof <agent-id> <intent-id> \
-  --proof-type eth_onchain_tx --proof-ref <0x...txhash> --chain-id 0x1
+## Import historical on-chain proofs (primary flow)
 
-# Solana on-chain
-bob intent submit-proof <agent-id> <intent-id> \
-  --proof-type sol_onchain_tx --proof-ref <txsig>
-```
-
-## Import historical proofs (credit building)
-
-For payments that happened before BOB tracking was set up:
+Submit on-chain transactions you made externally. BOB verifies them on the public ledger and awards credit.
 
 ```bash
+# BTC on-chain
 bob agent credit-import <agent-id> \
-  --proof-type btc_lightning_preimage \
-  --proof-ref <payment-hash> \
-  --rail lightning \
+  --proof-type btc_onchain_tx \
+  --proof-ref <txid> \
+  --rail onchain \
   --currency BTC \
   --amount <sats> \
   --direction outbound
+
+# ETH on-chain (Ethereum mainnet)
+bob agent credit-import <agent-id> \
+  --proof-type eth_onchain_tx \
+  --proof-ref <0x...txhash> \
+  --rail ethereum \
+  --currency ETH \
+  --amount <gwei> \
+  --direction outbound
+
+# Base L2 on-chain
+bob agent credit-import <agent-id> \
+  --proof-type base_onchain_tx \
+  --proof-ref <0x...txhash> \
+  --rail base \
+  --currency ETH \
+  --amount <gwei> \
+  --direction outbound
+
+# Solana on-chain
+bob agent credit-import <agent-id> \
+  --proof-type sol_onchain_tx \
+  --proof-ref <txsig> \
+  --rail solana \
+  --currency SOL \
+  --amount <lamports> \
+  --direction outbound
 ```
 
-Supported `--proof-type` values: `btc_onchain_tx`, `btc_lightning_payment_hash`, `btc_lightning_preimage`, `eth_onchain_tx`, `base_onchain_tx`, `sol_onchain_tx`
+Supported `--proof-type` values: `btc_onchain_tx`, `eth_onchain_tx`, `base_onchain_tx`, `sol_onchain_tx`
 
 Historical imports are capped — they count toward score but cannot substitute for ongoing payment history.
 
@@ -57,5 +69,4 @@ Historical imports are capped — they count toward score but cannot substitute
 
 - Each verified proof emits a credit event with `awarded`, `delta`, and `reason`
 - Amount thresholds: floor is 1,000 sats / 1,000,000 gwei / 1,000,000 lamports
-- Preimage proofs earn the highest confidence tier
 - Duplicate proof refs are deduplicated — same txid/hash twice doesn't double-count

package/references/scoring.md

@@ -25,8 +25,7 @@ New agents start at 350 (Verified tier). Tier multipliers only apply when credit
 | Twitter/X connected | 20 |
 | KYC/Identity verified | 75 |
 | EVM wallet binding | up to 50 (based on wallet history) |
-| Lightning node binding | variable |
-| Payment proof (per proof) | 1–10 pts based on amount + confidence |
+| On-chain proof (per proof) | 1–10 pts based on amount + confirmation depth |
 
 ## Credit events
 
@@ -40,11 +39,10 @@ Negative:
 
 ## How to build score fast
 
-1. **Submit payment proofs** — ongoing Lightning/onchain proofs are the highest-signal path
-2. **Use preimage proofs** — strongest proof type, highest confidence tier
-3. **Import historical proofs** — build credit from past payments
-4. **Bind a wallet** — EVM wallet with transaction history adds up to 50 pts
-5. **Connect social accounts** — GitHub (20 pts), Twitter/X (20 pts)
+1. **Import historical on-chain proofs** — submit BTC, ETH, Base, or SOL tx proofs; BOB verifies on the public ledger and awards credit
+2. **Bind an EVM wallet** — wallet with transaction history adds up to 50 pts
+3. **Connect social accounts** — GitHub (20 pts), Twitter/X (20 pts)
+4. **Complete KYC** — identity verification adds 75 pts
 
 ## Check your score