$npx -y skills add singularityhacker/bank-skills --skill bank-skillTraditional banking via Wise API + on-chain token swaps on Base
| 1 | # Bank Skill |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | Gives AI agents **traditional banking** capabilities (via Wise API) and **on-chain token operations** (via Uniswap on Base). Agents can check balances, send money, retrieve account details, create Ethereum wallets, swap tokens, and send tokens—all through a single skill. |
| 6 | |
| 7 | ## Prerequisites |
| 8 | |
| 9 | **For Banking (Wise API):** |
| 10 | - `WISE_API_TOKEN` environment variable (required) |
| 11 | - Optional: `WISE_PROFILE_ID` (defaults to first available profile) |
| 12 | |
| 13 | **For Token Operations (Base Network):** |
| 14 | - Optional: `CLAWBANK_WALLET_PASSWORD` (wallet keystore password, defaults to "clawbank-default") |
| 15 | - Optional: `BASE_RPC_URL` (Base RPC endpoint, defaults to https://mainnet.base.org) |
| 16 | |
| 17 | ## Operations |
| 18 | |
| 19 | ### Banking Operations (Wise API) |
| 20 | |
| 21 | #### 1. Check Balance |
| 22 | |
| 23 | **Purpose:** Query Wise multi-currency balances for the configured profile. |
| 24 | |
| 25 | **Inputs:** |
| 26 | - `action`: `"balance"` (required) |
| 27 | - `currency`: Currency code filter, e.g. `"USD"` (optional — returns all if omitted) |
| 28 | |
| 29 | **Outputs:** |
| 30 | - JSON array of balance objects, each with `currency`, `amount`, and `reservedAmount` |
| 31 | |
| 32 | **Usage:** |
| 33 | ```bash |
| 34 | echo '{"action": "balance"}' | ./run.sh |
| 35 | echo '{"action": "balance", "currency": "USD"}' | ./run.sh |
| 36 | ``` |
| 37 | |
| 38 | **Example output:** |
| 39 | ```json |
| 40 | { |
| 41 | "success": true, |
| 42 | "balances": [ |
| 43 | {"currency": "USD", "amount": 1250.00, "reservedAmount": 0.00}, |
| 44 | {"currency": "EUR", "amount": 500.75, "reservedAmount": 10.00} |
| 45 | ] |
| 46 | } |
| 47 | ``` |
| 48 | |
| 49 | #### 2. Get Receive Details |
| 50 | |
| 51 | **Purpose:** Retrieve account number, routing number, IBAN, and related info so others can send you payments. |
| 52 | |
| 53 | **Inputs:** |
| 54 | - `action`: `"receive-details"` (required) |
| 55 | - `currency`: Currency code, e.g. `"USD"` (optional — returns all if omitted) |
| 56 | |
| 57 | **Outputs:** |
| 58 | - JSON object with account holder name, account number, routing number (or IBAN/SWIFT for non-USD), and bank name |
| 59 | |
| 60 | **Usage:** |
| 61 | ```bash |
| 62 | echo '{"action": "receive-details"}' | ./run.sh |
| 63 | echo '{"action": "receive-details", "currency": "USD"}' | ./run.sh |
| 64 | ``` |
| 65 | |
| 66 | **Example output:** |
| 67 | ```json |
| 68 | { |
| 69 | "success": true, |
| 70 | "details": [ |
| 71 | { |
| 72 | "currency": "USD", |
| 73 | "accountHolder": "Your Business Name", |
| 74 | "accountNumber": "1234567890", |
| 75 | "routingNumber": "026073150", |
| 76 | "bankName": "Community Federal Savings Bank" |
| 77 | } |
| 78 | ] |
| 79 | } |
| 80 | ``` |
| 81 | |
| 82 | #### 3. Send Money |
| 83 | |
| 84 | **Purpose:** Initiate a transfer from your Wise balance to a recipient. |
| 85 | |
| 86 | **Inputs:** |
| 87 | - `action`: `"send"` (required) |
| 88 | - `sourceCurrency`: Source currency code, e.g. `"USD"` (required) |
| 89 | - `targetCurrency`: Target currency code, e.g. `"EUR"` (required) |
| 90 | - `amount`: Amount to send as a number (required) |
| 91 | - `recipientName`: Full name of the recipient (required) |
| 92 | - `recipientAccount`: Recipient account number or IBAN (required) |
| 93 | |
| 94 | **Additional fields for USD ACH transfers:** |
| 95 | - `recipientRoutingNumber`: 9-digit ABA routing number (required) |
| 96 | - `recipientCountry`: Two-letter country code, e.g. `"US"` (required) |
| 97 | - `recipientAddress`: Street address (required) |
| 98 | - `recipientCity`: City (required) |
| 99 | - `recipientState`: State code, e.g. `"NY"` (required) |
| 100 | - `recipientPostCode`: ZIP/postal code (required) |
| 101 | - `recipientAccountType`: `"CHECKING"` or `"SAVINGS"` (optional, defaults to `"CHECKING"`) |
| 102 | |
| 103 | **Outputs:** |
| 104 | - JSON object with transfer ID, status, and confirmation details |
| 105 | |
| 106 | **USD ACH Transfer Example:** |
| 107 | ```bash |
| 108 | echo '{ |
| 109 | "action": "send", |
| 110 | "sourceCurrency": "USD", |
| 111 | "targetCurrency": "USD", |
| 112 | "amount": 100.00, |
| 113 | "recipientName": "John Smith", |
| 114 | "recipientAccount": "123456789", |
| 115 | "recipientRoutingNumber": "111000025", |
| 116 | "recipientCountry": "US", |
| 117 | "recipientAddress": "123 Main St", |
| 118 | "recipientCity": "New York", |
| 119 | "recipientState": "NY", |
| 120 | "recipientPostCode": "10001", |
| 121 | "recipientAccountType": "CHECKING" |
| 122 | }' | ./run.sh |
| 123 | ``` |
| 124 | |
| 125 | **EUR IBAN Transfer Example (simpler):** |
| 126 | ```bash |
| 127 | echo '{ |
| 128 | "action": "send", |
| 129 | "sourceCurrency": "USD", |
| 130 | "targetCurrency": "EUR", |
| 131 | "amount": 100.00, |
| 132 | "recipientName": "Jane Doe", |
| 133 | "recipientAccount": "DE89370400440532013000" |
| 134 | }' | ./run.sh |
| 135 | ``` |
| 136 | |
| 137 | **Example output:** |
| 138 | ```json |
| 139 | { |
| 140 | "success": true, |
| 141 | "transfer": { |
| 142 | "id": 12345678, |
| 143 | "status": "processing", |
| 144 | "sourceAmount": 100.00, |
| 145 | "sourceCurrency": "USD", |
| 146 | "targetAmount": 93.50, |
| 147 | "targetCurrency": "EUR" |
| 148 | } |
| 149 | } |
| 150 | ``` |
| 151 | |
| 152 | ### Token Operations (Base Network) |
| 153 | |
| 154 | #### 4. Create Wallet |
| 155 | |
| 156 | **Purpose:** Generate a new Ethereum wallet for token operations on Base. |
| 157 | |
| 158 | **Inputs:** |
| 159 | - `action`: `"create-wallet"` (required) |
| 160 | |
| 161 | **Outputs:** |
| 162 | - Wallet address (keystore saved to `~/.clawbank/wallet.json`) |
| 163 | |
| 164 | **Usage:** |
| 165 | ```bash |
| 166 | echo '{"action": "create-wallet"}' | ./run.sh |
| 167 | ``` |
| 168 | |
| 169 | #### 5. Get Wallet |
| 170 | |
| 171 | **Purpose:** Get current wallet address and ETH balance on Base. |
| 172 | |
| 173 | **Inputs:** |
| 174 | - `action`: `"get-wallet"` (requir |