Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Agent banking and payments on Solana. Send and receive stablecoins with cancellable escrow transfers. Optional on-chain accounts with policy-enforced spendin...
Agent banking and payments on Solana. Send and receive stablecoins with cancellable escrow transfers. Optional on-chain accounts with policy-enforced spendin...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Agent banking and payments on Solana. Send and receive stablecoins β non-custodial, on-chain.
npm install -g @silkysquad/silk Requires Node.js 18+.
# 1. Initialize (creates wallet and agent ID) silk init # 2. Check your wallet address silk wallet list Your wallet and agent ID are saved at ~/.config/silkyway/config.json. Your private key never leaves your machine. silk init is idempotent β safe to run multiple times.
Default cluster is mainnet-beta (real USDC). Switch to devnet for testing with free tokens. silk config set-cluster devnet # test tokens silk config set-cluster mainnet-beta # real USDC silk config get-cluster # show current ClusterAPI Base URLNetworkmainnet-betahttps://api.silkyway.aiMainnet (real USDC)devnethttps://devnet-api.silkyway.aiDevnet (test USDC)
On devnet, use the faucet β it gives you 0.1 SOL (for transaction fees) + 100 USDC: silk config set-cluster devnet silk wallet fund silk balance On mainnet, send SOL and USDC to your wallet address manually. SOL is required for Solana transaction fees.
silk pay <recipient> <amount> [--memo <text>] This locks USDC into on-chain escrow. The recipient claims it with silk claim, or you cancel for a full refund with silk cancel. The output includes a claim link (claimUrl) β a URL you can share with the recipient's human. They open it in a browser, connect their wallet, and claim the payment. This is the easiest way for a non-technical recipient to claim. # Send 10 USDC silk pay 7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx 10 --memo "Payment for code review" # Output includes claimUrl β share it with the recipient # Example: https://app.silkyway.ai/transfers/9aE5kBqRvF3...?cluster=devnet # Check your balance silk balance # View your transfers silk payments list silk payments get <transfer-pda>
If someone sent you a payment: silk payments list silk claim <transfer-pda>
Cancel a payment you sent (before the recipient claims it): silk cancel <transfer-pda>
Save contacts so you can send payments by name instead of address. silk contacts add alice 7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx silk contacts list silk contacts get alice silk contacts remove alice Once saved, use names anywhere you'd use an address: silk pay alice 10 --memo "Thanks for the review" silk account send alice 5 Contact names are case-insensitive and stored lowercase. Saved at ~/.config/silkyway/contacts.json.
silk wallet create second-wallet silk wallet fund --wallet second-wallet silk wallet list Use --wallet <label> on any command to select a non-default wallet: silk pay <address> 10 --wallet second-wallet silk balance --wallet second-wallet
silk chat "How do I send a payment?" A persistent agentId (UUID) is auto-generated on first use for session continuity.
A SilkyWay account is an on-chain wallet β like a bank account β that a human owner creates and funds with USDC. The owner can add agents as operators with per-transaction spending limits enforced on-chain. This is useful for automations, recurring payments, or any scenario where a human wants to delegate spending authority to an agent with guardrails. You don't need an account to use SilkyWay. Escrow payments (silk pay) work with just a wallet. Accounts are an optional upgrade when your human wants to give you direct spending access with on-chain controls. Key concepts: Owner β The human who creates and funds the account. Full control: can transfer any amount, pause the account, add/remove operators. Operator β You (the agent). Authorized to send tokens from the account, subject to a per-transaction limit set by the owner. Per-transaction limit β Maximum USDC you can send in one transaction. Enforced on-chain β the Solana program rejects transactions that exceed it. A limit of 0 means unlimited. Pause β The owner can pause the account, blocking all operator transfers until unpaused. You cannot unpause it.
Your human creates the account β you cannot create it yourself. Share the setup URL with your human (replace with your address from silk wallet list): https://app.silkyway.ai/account/setup?agent=YOUR_WALLET_ADDRESS They'll connect their wallet, set your spending limit, and fund the account. Important: Your human must select the same network (mainnet/devnet) on the setup page as your CLI cluster. If you're on devnet, tell them to switch to devnet before creating the account. After your human creates the account, sync it: silk account sync Check your status and send payments: silk account status silk account send <recipient> <amount> If the amount exceeds your per-transaction limit, the transaction is rejected on-chain with ExceedsPerTxLimit. If the account is paused, you get AccountPaused. If silk account sync returns "No account found", your human hasn't created the account yet β share the setup URL with them.
You can deposit tokens from your wallet into the account, or withdraw them back: # Deposit 10 USDC from your wallet into the account silk account deposit 10 # Withdraw 5 USDC from the account back to your wallet silk account withdraw 5 deposit moves tokens from your wallet into the Silk account. withdraw is a convenience wrapper around account send where the recipient is your own wallet β it's subject to the same per-transaction limit as any other transfer.
Query the audit trail for your account: # List all events silk account events # Filter by event type silk account events --type TRANSFER silk account events --type DEPOSIT Event types: ACCOUNT_CREATED, ACCOUNT_CLOSED, DEPOSIT, TRANSFER, OPERATOR_ADDED, OPERATOR_REMOVED, PAUSED, UNPAUSED.
If your wallet is an operator on multiple accounts (different owners added you), silk account sync picks one deterministically (sorted by PDA) and warns you. To target a specific account: silk account sync --account <pda>
AccountsEscrow (silk pay)Setup requiredHuman creates account + adds you as operatorNone β just a funded walletSpending limitsPer-transaction limit enforced on-chainNo limitsRecipient claims?No β direct transfer, tokens arrive immediatelyYes β recipient must silk claimCancellable?No β transfer is instantYes β sender can cancel before claimBest forOngoing payments with human oversightOne-off payments between parties If your human has set up an account for you, prefer silk account send β it's simpler (no claim step) and your human controls the spending limits.
CommandDescriptionsilk initInitialize CLI (create wallet, agent ID, and contacts file)silk wallet create [label]Create a new walletsilk wallet listList all wallets with addressessilk wallet fund [--sol] [--usdc] [--wallet <label>]Fund wallet from devnet faucetsilk balance [--wallet <label>]Show SOL and USDC balancessilk pay <recipient> <amount> [--memo <text>] [--wallet <label>]Send USDC payment into escrowsilk claim <transfer-pda> [--wallet <label>]Claim a received paymentsilk cancel <transfer-pda> [--wallet <label>]Cancel a sent paymentsilk payments list [--wallet <label>]List transferssilk payments get <transfer-pda>Get transfer detailssilk contacts add <name> <address>Save a contact to the address booksilk contacts remove <name>Remove a contactsilk contacts listList all saved contactssilk contacts get <name>Look up a contact's addresssilk account sync [--wallet <label>] [--account <pda>]Discover and sync your on-chain accountsilk account status [--wallet <label>]Show account balance, spending limit, and pause statesilk account events [--type <eventType>] [--wallet <label>]List account events (audit trail)silk account deposit <amount> [--wallet <label>]Deposit USDC from wallet into accountsilk account withdraw <amount> [--wallet <label>]Withdraw USDC from account back to your walletsilk account send <recipient> <amount> [--memo <text>] [--wallet <label>]Send from account (policy-enforced on-chain)silk chat <message>Ask SilkyWay support agent a questionsilk config set-cluster <cluster>Set cluster (mainnet-beta or devnet)silk config get-clusterShow current cluster and API URLsilk config reset-clusterReset cluster to default (mainnet-beta) Use --wallet <label> on any command to select a non-default wallet. Recipients accept contact names or Solana addresses.
SilkyWay is non-custodial β your private keys never leave your machine. Every payment follows a build-sign-submit flow: Build β The SDK calls an API endpoint with payment details. The backend builds an unsigned Solana transaction and returns it as base64. Sign β The SDK signs the transaction locally using your private key. Submit β The SDK sends the signed transaction to the backend, which forwards it to Solana. The backend handles Solana complexity (PDA derivation, instruction building, blockhash management). It never sees your private key β all authorization is enforced on-chain by the Solana program.
Base URL: https://api.silkyway.ai (mainnet) or https://devnet-api.silkyway.ai (devnet) All requests use Content-Type: application/json.
Build an unsigned create_transfer transaction. Locks USDC into escrow. Request: { "sender": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "recipient": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx", "amount": 10.00, "token": "usdc", "memo": "Payment for code review" } FieldTypeRequiredDescriptionsenderstringyesSender's Solana public keyrecipientstringyesRecipient's Solana public keyamountnumberyesAmount in token units (e.g. 10.00 = 10 USDC)tokenstringyesToken symbol (e.g. "usdc")memostringnoHuman-readable memoclaimableAfternumbernoUnix timestamp β recipient cannot claim before this time You can also pass mint (token mint pubkey) or poolPda directly instead of token, but token is the simplest option. Response: { "ok": true, "data": { "transaction": "AQAAAAAAAAAAAAAA...base64...AAAAAAA=", "transferPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "nonce": "1738900000000", "message": "Sign and submit via POST /api/tx/submit" } } The transferPda is the on-chain address for this escrow. Save it β you need it to claim or cancel.
Build an unsigned claim_transfer transaction. Moves USDC from escrow to the recipient's wallet. Only the designated recipient can claim. If claimableAfter was set, the claim will fail before that time. Request: { "transferPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "claimer": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx" } FieldTypeRequiredDescriptiontransferPdastringyesThe transfer's on-chain PDAclaimerstringyesRecipient's Solana public key Response: { "ok": true, "data": { "transaction": "AQAAAAAAAAAAAAAA...base64...AAAAAAA=", "message": "Sign and submit via POST /api/tx/submit" } } Common errors: ClaimTooEarly (6003) β claimableAfter hasn't passed yet TransferAlreadyClaimed (6000) β already claimed TransferAlreadyCancelled (6001) β sender cancelled first Unauthorized (6004) β claimer is not the designated recipient
Build an unsigned cancel_transfer transaction. Refunds USDC from escrow back to the sender. Only the original sender can cancel, and only while the transfer is still ACTIVE (not yet claimed). Request: { "transferPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "canceller": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp" } FieldTypeRequiredDescriptiontransferPdastringyesThe transfer's on-chain PDAcancellerstringyesSender's Solana public key Response: { "ok": true, "data": { "transaction": "AQAAAAAAAAAAAAAA...base64...AAAAAAA=", "message": "Sign and submit via POST /api/tx/submit" } } Common errors: TransferAlreadyClaimed (6000) β recipient already claimed TransferAlreadyCancelled (6001) β already cancelled Unauthorized (6004) β canceller is not the original sender
Submit a signed transaction to Solana. Request: { "signedTx": "AQAAAAAAAAAAAAAA...base64-signed...AAAAAAA=" } Response: { "ok": true, "data": { "txid": "5UfDuXsrhFnxGZmyJxNR8z7Ee5JDFrgWHKPdTEJvoTpB3Qw8mKz4GQN1sxZWoGL" } }
Get details for a single transfer. Example: GET /api/transfers/9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4 Response: { "ok": true, "data": { "transfer": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "transferPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "sender": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "recipient": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx", "amount": "10000000", "amountRaw": "10000000", "status": "ACTIVE", "memo": "Payment for code review", "createTxid": "5UfDuXsrhFnxGZmyJxNR8z7Ee5JDFrgWHKPdTEJvoTpB", "claimTxid": null, "cancelTxid": null, "claimableAfter": null, "claimableUntil": null, "createdAt": "2025-02-07T12:00:00.000Z", "updatedAt": "2025-02-07T12:00:00.000Z", "token": { "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU", "symbol": "USDC", "decimals": 6 }, "pool": { "poolPda": "3Fk8vMYJbCbEB2jzRCdRG9rFJhN2TCmPia9BjEKpTk5R", "feeBps": 50 } } } } Note: amount is in raw token units. USDC has 6 decimals, so "10000000" = 10.00 USDC.
List all transfers where the wallet is sender or recipient. Example: GET /api/transfers?wallet=BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp Response: { "ok": true, "data": { "transfers": [ { "transferPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "sender": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "recipient": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx", "amount": "10000000", "status": "ACTIVE", "memo": "Payment for code review", "createdAt": "2025-02-07T12:00:00.000Z", "token": { "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU", "symbol": "USDC", "decimals": 6 }, "pool": { "poolPda": "3Fk8vMYJbCbEB2jzRCdRG9rFJhN2TCmPia9BjEKpTk5R", "feeBps": 50 } } ] } }
Airdrop devnet SOL or USDC. Devnet only. Request: { "wallet": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "token": "usdc" } token is optional. Omit or use "sol" for SOL airdrop, "usdc" for USDC mint. Response: { "ok": true, "data": { "amount": 0.1, "txid": "5UfDuXsrhFnxGZmyJxNR8z7Ee5JDFrgWHKPdTEJvoTpB3Qw8mKz4GQN1sxZWoGL" } }
GET /api/account/by-operator/:pubkey Find accounts where your wallet is an operator. Used by silk account sync. Example: GET /api/account/by-operator/7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx Response: { "ok": true, "data": { "accounts": [ { "pda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "owner": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU", "mintDecimals": 6, "isPaused": false, "balance": 10000000, "operatorSlot": { "index": 0, "perTxLimit": 5000000, "dailyLimit": 0 } } ] } } Returns an empty array if no accounts found β this means your human hasn't set up your account yet. GET /api/account/:pda Get full account details. Used by silk account status. Example: GET /api/account/9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4 Response: { "ok": true, "data": { "pda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "owner": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU", "mintDecimals": 6, "isPaused": false, "balance": 10000000, "operators": [ { "pubkey": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx", "perTxLimit": 5000000, "dailyLimit": 0 } ] } } Note: balance and perTxLimit are in raw token units. USDC has 6 decimals, so 5000000 = $5.00. POST /api/account/transfer Build an unsigned transfer transaction from a SilkyWay account. Used by silk account send. Request: { "signer": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx", "accountPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "recipient": "Dg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx7xKXz9BpR3mFV", "amount": 3000000 } FieldTypeRequiredDescriptionsignerstringyesYour wallet address (operator)accountPdastringyesThe account's on-chain PDArecipientstringyesRecipient's Solana public keyamountnumberyesAmount in raw token units (e.g. 3000000 = 3.00 USDC) Response: { "ok": true, "data": { "transaction": "AQAAAAAAAAAAAAAA...base64...AAAAAAA=" } } Sign and submit the returned transaction via POST /api/tx/submit. Common errors: ExceedsPerTxLimit β Amount exceeds your per-transaction spending limit AccountPaused β Account is paused by the owner; operator transfers blocked Unauthorized β Signer is not the owner or an operator on this account POST /api/account/create Build an unsigned create-account transaction. Used by the setup page (human-facing, not typically called by agents). Request: { "owner": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU", "operator": "7xKXz9BpR3mFVDg2Thh3AG6sFRPqNrDJ4bHUkR8Y7vNx", "perTxLimit": 5000000 } POST /api/account/deposit Build an unsigned deposit transaction. Used by silk account deposit and the setup page. Request: { "depositor": "BrKz4GQN1sxZWoGLbNTojp4G3JCFLRkSYk3mSRWhKsXp", "accountPda": "9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4", "amount": 10000000 } FieldTypeRequiredDescriptiondepositorstringyesWallet address depositing the tokensaccountPdastringyesThe account's on-chain PDAamountnumberyesAmount in raw token units (e.g. 10000000 = 10.00 USDC) Sign and submit the returned transaction via POST /api/tx/submit. GET /api/account/:pda/events List audit trail events for an account. Used by silk account events. Example: GET /api/account/9aE5kBqRvF3mNcXz8BpR3mFVDg2Thh3AG6sFRPqNrDJ4/events Query parameters: ParamTypeRequiredDescriptioneventTypestringnoFilter by event type: ACCOUNT_CREATED, ACCOUNT_CLOSED, DEPOSIT, TRANSFER, OPERATOR_ADDED, OPERATOR_REMOVED, PAUSED, UNPAUSED Example with filter: GET /api/account/9aE5kBqRvF3.../events?eventType=TRANSFER
Send a message to the SilkyWay support agent. Returns an AI-generated response. Request: { "agentId": "uuid-v4", "message": "How do I send a payment?" } FieldTypeRequiredDescriptionagentIdstringyesUUID v4 identifying the agent (auto-generated by the SDK)messagestringyesThe question to ask Response (200): { "ok": true, "data": { "message": "Use silk pay...", "agentId": "uuid-v4" } }
StatusDescriptionACTIVETokens locked in escrow, awaiting claim or cancellationCLAIMEDRecipient claimed the tokensCANCELLEDSender cancelled and reclaimed the tokensEXPIREDTransfer expired past its claimableUntil window
CodeNameDescription6000TransferAlreadyClaimedTransfer has already been claimed6001TransferAlreadyCancelledTransfer has already been cancelled6002TransferExpiredTransfer has expired6003ClaimTooEarlyCannot claim before claimableAfter timestamp6004UnauthorizedSigner is not authorized for this action6005PoolPausedThe token's escrow pool is temporarily paused β try again later6006InsufficientFundsSender has insufficient token balance
CodeNameDescription6000UnauthorizedSigner is not the owner or an operator on this account6001ExceedsPerTxLimitTransfer amount exceeds operator's per-transaction spending limit6002ExceedsDailyLimitTransfer exceeds operator daily limit (not yet enforced)6003AccountPausedAccount is paused β operator transfers blocked until owner unpauses6004MaxOperatorsReachedAccount already has 3 operators (maximum)6005OperatorNotFoundSpecified operator not found on account6006OperatorAlreadyExistsOperator is already on this account6007InsufficientBalanceAccount doesn't have enough tokens for this transfer6008MathOverflowArithmetic overflow in calculation
ErrorHTTPDescriptionINVALID_PUBKEY400Invalid Solana public key formatINVALID_AMOUNT400Amount must be positiveMISSING_FIELD400Required field not providedTRANSFER_NOT_FOUND404No transfer found for the given PDAPOOL_NOT_FOUND404No escrow pool found for this tokenTOKEN_NOT_FOUND400Token symbol or mint not recognizedTX_FAILED400Transaction simulation or submission failedRATE_LIMITED429Too many faucet requestsFAUCET_FAILED400Faucet airdrop failed
Success: { "ok": true, "data": { ... } } Error: { "ok": false, "error": "ERROR_CODE", "message": "Human-readable description" }
Non-custodial β the backend builds unsigned transactions; you sign locally with your private key before submitting Private keys are never transmitted to the server All authorization is enforced on-chain by the Solana program, not by the backend Keys are stored locally at ~/.config/silkyway/config.json β never share this file
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.