claw-strk (Starknet Sepolia prototype)

claw-strk is a Sepolia-first Starknet CLI for quickly testing:

• Swaps via AVNU
• Demo lending pool flows
• x402 paywalled HTTP requests (client-side)
• Deploy/test demo ERC20 + ERC721 (NFT) contracts
• A simple .claw name registry (StarknetID-like MVP for Sepolia)

This is prototype tooling for Starknet Sepolia.

1) Install

Install globally from npm:

npm install -g @openclawchain/claw-strk
# or
pnpm add -g @openclawchain/claw-strk

Run:

claw-strk --help

2) Configure (.env)

The CLI loads env in this order:

1. --env <path>
2. ./.env
3. ~/.claw-strk/.env

Minimum required:

STARKNET_ACCOUNT_ADDRESS=0x...
STARKNET_PRIVATE_KEY=0x...
STARKNET_RPC_URL=https://starknet-sepolia.g.alchemy.com/v2/<key>

Optional:

# x402 Server (defaults to OpenClawChain hosted server)
X402_SERVER_URL=https://stark-facilitator.openclawchain.org

Create a template:

claw-strk init

3) CLI examples (mandatory features)

A) Swap (AVNU)

Quote:

claw-strk quote --sell STRK --buy USDC --amount 1

Swap:

claw-strk swap --sell STRK --buy USDC --amount 1 --slippage 5

B) Lending

List demo pools:

claw-strk lend pools

Run the demo (deposit/borrow/repay/withdraw):

claw-strk lend demo

USDC borrow example (STRK collateral → borrow USDC):

# show pool + price
claw-strk lend pool --pool-id strk-usdc

# deposit 1 STRK as collateral
claw-strk lend deposit --pool-id strk-usdc --amount 1

# borrow a tiny amount of USDC (6 decimals)
claw-strk lend borrow --pool-id strk-usdc --amount 0.005

# repay
claw-strk lend repay --pool-id strk-usdc --amount 0.005

# withdraw collateral
claw-strk lend withdraw --pool-id strk-usdc --amount 1

C) x402 payment (paywalled HTTP)

Discover requirements (no payment, defaults to OpenClawChain server):

claw-strk x402 discover

Or discover a specific endpoint:

claw-strk x402 discover \
  --url https://stark-facilitator.openclawchain.org/api/protected/chainstatus

Paywall endpoint example (discover → pay → retry, defaults to OpenClawChain server):

claw-strk x402 request \
  --network sepolia \
  --auto-approve

Or specify a custom endpoint:

claw-strk x402 request \
  --url https://stark-facilitator.openclawchain.org/api/protected/chainstatus \
  --network sepolia \
  --auto-approve

Show only the paywalled content (no JSON wrapper):

claw-strk x402 request \
  --network sepolia \
  --auto-approve \
  --raw

Or print JSON + then print body:

claw-strk x402 request \
  --network sepolia \
  --auto-approve \
  --print-body

Notes:

• x402 request first calls the URL normally; if the server replies 402, it reads the required payment details (accepts[0]) and retries with X-PAYMENT.
• --auto-approve will approve exactly maxAmountRequired to the spender (one-time per amount).
• Override spender/facilitator if needed:

Example discovery response (from the hosted paywall):

{
  "status": 402,
  "ok": false,
  "x402Version": 1,
  "accepts": [
    {
      "scheme": "exact",
      "network": "starknet-sepolia",
      "maxAmountRequired": "1000",
      "resource": "/chainstatus",
      "payTo": "0x04dA15eb06D6D01C4907eb4876Cc29BdeF21A84bD71fB34d0369c83b8744D104",
      "asset": "0x053b40a647cedfca6ca84f542a0fe36736031905a9639a7f19a3c1e66bfd5080",
      "assetSymbol": "USDC",
      "assetDecimals": 6,
      "maxAmountHuman": "0.001"
    }
  ],
  "error": null
}

Example paywalled content response (after payment):

{
  "ok": true,
  "network": "starknet-sepolia",
  "rpcUrl": "https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/v0_10/<key>",
  "time": "2026-..."
}

claw-strk x402 request \
  --url <resource-url> \
  --facilitator <facilitator-base-url> \
  --spender <spender-address> \
  --auto-approve

Verify (no settlement):

claw-strk x402 verify \
  --url https://stark-facilitator.openclawchain.org/api/protected/chainstatus \
  --to 0x04dA15eb06D6D01C4907eb4876Cc29BdeF21A84bD71fB34d0369c83b8744D104 \
  --token USDC \
  --amount 0.001 \
  --network sepolia

Generate an X-PAYMENT header (advanced/manual):

claw-strk x402 pay \
  --to 0x04dA15eb06D6D01C4907eb4876Cc29BdeF21A84bD71fB34d0369c83b8744D104 \
  --token USDC \
  --amount 0.001 \
  --network sepolia

D) .claw domain

Register:

claw-strk claw register --name bobio.claw --metadata '{"owner":"bobio"}' --network sepolia

Resolve:

claw-strk claw resolve --name bobio.claw --network sepolia

Get full record:

claw-strk claw get --name bobio.claw --network sepolia

E) ERC20 demo token

Create:

claw-strk token create --kind mintable --name "Mint Token" --symbol MNT --decimals 6 --initial 0

Mint (owner-only):

claw-strk token mint --token <address> --to <address> --amount 100 --decimals 6

F) NFT (ERC721)

Create collection:

claw-strk nft create --name "OpenClawMinion" --symbol "CLAW" --network sepolia

Mint:

claw-strk nft mint --contract <address> --id 1 --network sepolia

Check ownership (ERC721 balance_of):

claw-strk nft balance --contract <address>

4) References

4.1 Supported tokens (swap)

Starknet Sepolia bridged token addresses:

• STRK: 0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d
• ETH: 0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7
• USDC: 0x053b40a647cedfca6ca84f542a0fe36736031905a9639a7f19a3c1e66bfd5080
• USDT: 0x02ab8758891e84b968ff11361789070c6b1af2df618d6d2f4a78b0757573c6eb
• WBTC: 0x00452bd5c0512a61df7c7be8cfea5e4f893cb40e126bdc40aee6054db955129e
• wstETH: 0x030de54c07e57818ae4a1210f2a3018a0b9521b8f8ae5206605684741650ac25
• EKUBO: 0x01fad7c03b2ea7fbef306764e20977f8d4eae6191b3a54e4514cc5fc9d19e569

4.2 x402 default server (Sepolia)

• Facilitator base: https://stark-facilitator.openclawchain.org/api/facilitator
• Paywalled base: https://stark-facilitator.openclawchain.org/api/protected
• Example resource: GET /chainstatus
• Default spender (facilitator account):
  • 0x04dA15eb06D6D01C4907eb4876Cc29BdeF21A84bD71fB34d0369c83b8744D104

4.3 Lending demo pool (Sepolia)

Pool id: strk-usdc

• Registry: 0x183ca728ea9432536ce728416dcb3126373f18a2e5cd46327a90dc2f1f93e15
• Pool: 0x04bdad5b68e73eaa8784a488f02b6ead417a4e5c0472566027908149f115979b

4.4 Deployed contracts (Sepolia)