Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 33 additions & 4 deletions bankr/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: bankr
description: AI-powered crypto trading agent, wallet API, and LLM gateway via natural language. Use when the user wants to trade crypto, check portfolio balances (with PnL and NFTs), view token prices, search tokens, transfer crypto, manage NFTs, use leverage, bet on Polymarket, deploy tokens, set up automated trading, sign and submit raw transactions, or access LLM models through the Bankr LLM gateway funded by your Bankr wallet. Supports Base, Ethereum, Polygon, Solana, and Unichain.
description: AI-powered crypto trading agent, wallet API, and LLM gateway via natural language. Use when the user wants to trade crypto, check portfolio balances (with PnL and NFTs), view token prices, search tokens, transfer crypto, manage NFTs, use leverage, trade perpetuals on Hyperliquid, bet on Polymarket, deploy tokens, set up automated trading, sign and submit raw transactions, or access LLM models through the Bankr LLM gateway funded by your Bankr wallet. Supports Base, Ethereum, Polygon, Solana, Unichain, World Chain, Arbitrum, BNB Chain, and Hyperliquid.
metadata:
{
"clawdbot":
Expand Down Expand Up @@ -310,6 +310,8 @@ CLI 0.2.0 organizes commands into three namespaces: `wallet`, `agent`, and `toke
| `bankr config get [key]` | Get config value(s) |
| `bankr config set <key> <value>` | Set a config value |
| `bankr --config <path> <command>` | Use a custom config file path |
| `bankr update` | Check for and install CLI updates from npm |
| `bankr update --check` | Check for available updates without installing |

Valid config keys: `apiKey`, `apiUrl`, `llmKey`, `llmUrl`

Expand Down Expand Up @@ -527,16 +529,30 @@ For full details — setup paths, model list, provider config, SDK examples, key

**Reference**: [references/leverage-trading.md](references/leverage-trading.md)

### Hyperliquid Trading

- Perpetual futures on 200+ crypto assets, stocks (TSLA, AAPL, NVDA), and commodities
- Spot trading on Hyperliquid-native tokens (HYPE, PURR, etc.)
- Up to 50x leverage with isolated or cross margin
- Take profit / stop loss on new and existing positions
- Limit orders on perps and spot
- Bridge USDC from Arbitrum (and other EVM chains) to Hyperliquid
- Internal transfers between spot and perps accounts
- Order management: modify, cancel, update leverage/margin

**Reference**: [references/hyperliquid.md](references/hyperliquid.md)

### Token Deployment

- **EVM (Base)**: Deploy ERC20 tokens via Clanker with customizable metadata and social links
- **Solana**: Launch SPL tokens via Raydium LaunchLab with bonding curve and auto-migration to CPMM
- Rehype (decay) pools: 95% creator fees, 5% protocol fee
- Creator fee claiming on both chains
- Fee Key NFTs for Solana (50% LP trading fees post-migration)
- Optional fee recipient designation with 99.9%/0.1% split (Solana)
- Both creator AND fee recipient can claim bonding curve fees (gas sponsored)
- Optional vesting parameters (Solana)
- Rate limits: 1/day standard, 10/day Bankr Club (gas sponsored within limits)
- Rate limits: 50/day standard, 100/day Bankr Club (gas sponsored within daily limits)

**Reference**: [references/token-deployment.md](references/token-deployment.md)

Expand Down Expand Up @@ -569,8 +585,9 @@ For full details — setup paths, model list, provider config, SDK examples, key
| Solana | SOL | High-speed trading | Minimal |
| Unichain | ETH | Newer L2 option | Very Low |
| World Chain | ETH | Uniswap V3/V4 swaps | Very Low |
| Arbitrum | ETH | DeFi, low-cost transactions | Very Low |
| Arbitrum | ETH | DeFi, low-cost transactions | Very Low (gas sponsored) |
| BNB Chain | BNB | BSC ecosystem trading | Low |
| Hyperliquid | USDC | Perps, spot, stocks (HIP-3) | Minimal |

## Safety & Access Control

Expand Down Expand Up @@ -698,8 +715,9 @@ Common issues and fixes:
- **Authentication errors** → Run `bankr login` or check `bankr whoami` (CLI), or verify your `X-API-Key` header (REST API)
- **Insufficient balance** → Add funds or reduce amount
- **Token not found** → Verify symbol and chain
- **Transaction reverted** → Check parameters and balances
- **Transaction reverted** → Check parameters and balances; swap failures now return descriptive error messages (gas insufficiency, on-chain reverts)
- **Rate limiting** → Wait and retry
- **Gas insufficient** → Add native tokens to cover gas fees; gas is sponsored on Base, Polygon, Unichain, and Arbitrum (up to 10 tx/day)

For comprehensive error troubleshooting, setup instructions, and debugging steps, see:

Expand Down Expand Up @@ -805,6 +823,17 @@ See [references/safety.md](references/safety.md) for comprehensive safety guidan
- "Short BTC 10x with stop loss at $45k"
- "Show my Avantis positions"

### Hyperliquid

- "Long $100 of BTC on hyperliquid with 10x"
- "Short ETH on hyperliquid with 5x leverage"
- "Buy $50 of HYPE on hyperliquid"
- "Show my hyperliquid positions"
- "Close my BTC position on hyperliquid"
- "Set take profit at $70000 on my BTC position"
- "Deposit $500 USDC to hyperliquid"
- "What's the funding rate for SOL on hyperliquid?"

### Automation

- "DCA $100 into ETH weekly"
Expand Down
2 changes: 2 additions & 0 deletions bankr/references/llm-gateway.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,9 +53,11 @@ bankr config get llmKey
| `gpt-5.2-codex` | OpenAI | Code generation |
| `gpt-5.4-mini` | OpenAI | Fast, economical (400K context, image input) |
| `gpt-5.4-nano` | OpenAI | Ultra-fast, lowest cost (400K context, image input) |
| `minimax-m2.5` | MiniMax | Cost-effective (204.8K context) |
| `minimax-m2.7` | MiniMax | Balanced performance (204.8K context) |
| `kimi-k2.5` | Moonshot AI | Long-context reasoning |
| `qwen3-coder` | Alibaba | Code generation, debugging |
| `glm-5-turbo` | Z.ai | Fast, large context (202K tokens) |

```bash
# Fetch live model list from the gateway
Expand Down
16 changes: 10 additions & 6 deletions bankr/references/safety.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,7 @@ Manage API key settings at [bankr.bot/api](https://bankr.bot/api):
|-------|------|-------------|
| `readOnly` | boolean | When true, only read tools are available |
| `allowedIps` | string[] | IP whitelist (empty = all allowed) |
| `allowedRecipients` | string[] | Restrict transfer recipients to specific EVM/Solana addresses |
| `walletApiEnabled` | boolean | Whether `/wallet/*` write endpoints are accessible |
| `agentApiEnabled` | boolean | Whether `/agent/*` AI endpoints are accessible |
| `tokenLaunchApiEnabled` | boolean | Whether token deployment is accessible |
Expand Down Expand Up @@ -197,12 +198,15 @@ When building autonomous agents that execute transactions, use a **separate Bank

Fund the agent wallet with enough for gas and intended operations, not more:

| Chain | Gas Buffer | Trading Capital |
|-------|-----------|-----------------|
| Base | 0.01 - 0.05 ETH | As needed for trades |
| Polygon | 5 - 10 MATIC | As needed for trades |
| Ethereum | 0.05 - 0.1 ETH | As needed for trades |
| Solana | 0.1 - 0.5 SOL | As needed for trades |
| Chain | Gas Buffer | Trading Capital | Gas Sponsored |
|-------|-----------|-----------------|---------------|
| Base | 0.01 - 0.05 ETH | As needed for trades | Yes |
| Polygon | 5 - 10 MATIC | As needed for trades | Yes |
| Ethereum | 0.05 - 0.1 ETH | As needed for trades | No |
| Solana | 0.1 - 0.5 SOL | As needed for trades | No |
| Arbitrum | 0.01 - 0.05 ETH | As needed for trades | Yes |
| World Chain | 0.01 - 0.05 ETH | As needed for trades | No |
| BNB Chain | 0.01 - 0.05 BNB | As needed for trades | No |

Replenish periodically rather than pre-loading large amounts.

Expand Down
26 changes: 18 additions & 8 deletions bankr/references/token-deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Deploy and manage tokens on EVM chains (via Clanker) and Solana (via Raydium Lau

| Chain | Protocol | Token Standard | Best For |
|-------|----------|----------------|----------|
| **Base** | Clanker | ERC20 | Memecoins, social tokens |
| **Base** | Clanker / Doppler (rehype) | ERC20 | Memecoins, social tokens |
| **Unichain** | Clanker | ERC20 | Lower fees, newer ecosystem |
| **Solana** | Raydium LaunchLab | SPL | High-speed trading, bonding curves |

Expand Down Expand Up @@ -178,16 +178,16 @@ Shared fee claims are always sponsored to ensure atomic claim+transfer.

| User Type | Daily Limit | Gas Sponsored |
|-----------|-------------|---------------|
| Standard Users | Unlimited | 1 token/day |
| Bankr Club Members | Unlimited | 10 tokens/day |
| Standard Users | 50 tokens/day | Yes (within limits) |
| Bankr Club Members | 100 tokens/day | Yes (within limits) |

Users can launch additional tokens beyond sponsored limits by paying ~0.01 SOL gas.

---

## EVM Token Launches (Clanker)
## EVM Token Launches (Clanker / Doppler)

Deploy ERC20 tokens on Base and Unichain using Clanker.
Deploy ERC20 tokens on Base and Unichain using Clanker or Doppler (rehype pools).

### Deployment Parameters

Expand Down Expand Up @@ -224,14 +224,24 @@ Deploy ERC20 tokens on Base and Unichain using Clanker.

| User Type | Daily Limit |
|-----------|-------------|
| Standard Users | 1 token/day |
| Bankr Club Members | 10 tokens/day |
| Standard Users | 50 tokens/day |
| Bankr Club Members | 100 tokens/day |

### Fee Structure
### Fee Structure (Doppler Rehype Pools)

| Share | Recipient | Description |
|-------|-----------|-------------|
| 95% | Creator | Creator trading fees |
| 5% | Protocol | Protocol fee |

Rehype pools route the Bankr share to a buyback mechanism instead of direct beneficiary splits. Pool fee is 0.7%.

### Fee Structure (Clanker)

- Small fee on each trade, accumulated for token creator
- Claimable anytime via "Claim fees for my token"
- Legacy fees (older Clanker versions) claimed separately
- `transfer_fee_recipient` tool works for both Clanker and Doppler tokens

### Chain Selection

Expand Down