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
15 changes: 8 additions & 7 deletions docs/BANK-OF-AI/QuickStart.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The AI will install the Skills and then ask whether to create a wallet.
>
> The command enters interactive mode to let me pick the Skills: I'll use the `-y` flag (without `-g`) so it selects everything by default and installs into this Agent's directory:
>
> ✅ **11 Skills installed.** (installed into this Agent's skills directory)
> ✅ **12 Skills installed.** (installed into this Agent's skills directory)
>
> Now running `bankofai-guide` to walk you through setup…
>
Expand All @@ -47,12 +47,13 @@ The AI will install the Skills and then ask whether to create a wallet.
> | 3 | `multi-sig-account-permissions` |
> | 4 | `recharge-skill` |
> | 5 | `sunperp-perpetual-futures-trading` |
> | 6 | `sunswap-dex-trading` |
> | 7 | `trc20-token-toolkit` |
> | 8 | `tronscan-data-lookup` |
> | 9 | `trx-staking-sr-voting` |
> | 10 | `usdd-just-protocol` |
> | 11 | `x402-payment` |
> | 6 | `sunpump-meme-token-toolkit` |
> | 7 | `sunswap-dex-trading` |
> | 8 | `trc20-token-toolkit` |
> | 9 | `tronscan-data-lookup` |
> | 10 | `trx-staking-sr-voting` |
> | 11 | `usdd-just-protocol` |
> | 12 | `x402-payment` |
>
> **📋 Current status**
>
Expand Down
49 changes: 49 additions & 0 deletions docs/McpServer-Skills/SKILLS/BANKOFAISkill.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ BANK OF AI SKILLS can operate on **real on-chain assets**. Blockchain transactio
| :--- | :--- | :--- |
| **agent-wallet** | Create wallets, sign transactions/messages, manage multiple wallets — supports EVM and TRON | `AGENT_WALLET_PASSWORD` (encrypted mode) or none (interactive) |
| **sunswap** | Check prices, get quotes, swap tokens, manage V2/V3/V4 liquidity pools | Read-only: none. Trading: wallet credentials |
| **sunpump-agent-skill** | SunPump meme coins: create tokens with one command (server-side, no wallet), market data/rankings/holders/portfolios, plus buy/sell meme coins (automatically picks the swap route based on whether the token has launched, TRON mainnet only) | Read-only & token creation: none. On-chain buy/sell: wallet credentials |
| **sunperp-skill** | Market data, open/close positions, withdrawals | Market data: none. Trading: SunPerp API keys |
| **tronscan-skill** | Look up accounts, transactions, tokens, blocks, network stats | Recommended: TronScan API key (may throttle without one) |
| **trc20-toolkit-skill** | Transfer tokens, check balances, manage approvals for any TRC20 token | Read-only: none. Transfers/approvals: wallet credentials |
Expand Down Expand Up @@ -146,6 +147,54 @@ V3 only accepts fee tiers `100`, `500`, `3000`, or `10000` (0.01% / 0.05% / 0.3%

---

## sunpump-agent-skill {#sunpump-agent-skill}

Want to play with meme coins on SunPump? This skill is built on `@bankofai/sun-cli` (≥ 1.2.1) and helps you create meme tokens, check market data, do research, and buy/sell meme coins. Token creation (`sun sunpump launch`) is **server-side — no wallet needed**: provide a name, symbol, description, and logo, and the platform signs and broadcasts the creation transaction for you. For trading, it **picks the trade path automatically**: tokens that haven't created a SunSwap V2 pair yet ("pre-launch") go through `sun sunpump buy/sell`, while tokens that already have a SunSwap V2 pair ("post-launch") use a regular `sun swap` — before placing an order the AI runs `sunpump state` to confirm which path applies.

**Absolutely safe, read-only:**

> What are the top 10 SunPump meme coins by 24h gain?

> Get the detail for token TXYZ...: price, market cap, 24h volume, holder count.

> Show me the holder distribution for TXYZ... — is it controlled by a few addresses?

> Show wallet T...'s SunPump holdings and last 20 trades.

**Requires your confirmation (the AI shows you the bill first):**

> Launch a meme token on SunPump: name <your token name>, symbol <SYMBOL>, description <one sentence>, logo <path to your image>.

> Buy TXYZ... with 10 TRX on SunPump (a token without a SunSwap V2 pair yet).

> Sell 1000 TXYZ... with slippage set to 5%.

> Buy some TXYZ... that already has a SunSwap V2 pair, with 100 TRX and 1% slippage.

**Real scenarios:**

> Looking for hot new coins? "List the top 10 SunPump tokens by 24h volume, then check the holder concentration of the #1."

> Want to snipe a launch? "What's the state of TXYZ... right now? If it's still tradeable on the bonding curve, buy it with 10 TRX." — the AI checks `state` first, quotes, and only places the order after you confirm.

> Want to review your record? "Show me wallet T...'s SunPump holdings and buy history."

:::tip Pre-launch vs post-launch
A SunPump token has two states: **pre-launch** (no SunSwap V2 pair yet, `state` = 1 TRADING or 2 READY_TO_LAUNCH) and **post-launch** (a SunSwap V2 pair has been created, `state` = 3 LAUNCHED). The key concept is the **Bonding Curve (launch progress bar)**: as the community buys in, the meme coin's market cap grows, and once the curve hits 100% a trading pair is automatically created on SunSwap V2 and the token "launches". The AI picks the right command automatically — you don't need to worry about the details, but understanding this helps you follow what it's doing.
:::

:::caution Meme coins are high-risk
Meme coins are highly volatile and easily manipulated. When the AI shows you token info it also surfaces holder concentration — if the top few addresses hold too much combined (e.g. top 5 > 40%), it explicitly warns you of rug-pull risk. Default slippage is 5% (meme coins move fast); always review the quote before confirming a buy or sell.
:::

:::tip About token creation (launch)
Creation goes through the SunPump agent endpoint — the platform signs and broadcasts the transaction, so **no wallet is needed**. Name, symbol, and description are required; a logo is strongly recommended (launches without one may be rejected by the API). On success the AI reports the new token's contract address and creation tx hash. Like every other SunPump operation, launch is **mainnet only** — the CLI rejects any non-mainnet `--network` before doing anything, even under `--dry-run`.
:::

**sunpump-agent-skill's full functionality (queries and trading) only works on TRON mainnet, not testnets.**

---

## sunperp-skill {#sunperp-skill}

Want to trade contracts? This skill handles market data, opening positions, closing positions, and setting stop-loss on SunPerp. Built-in safety locks enforced at the script level: max 20x leverage (configurable in `resources/sunperp_config.json`) and a **mandatory stop-loss on every position-opening order** — auto-set to 5% from entry if you don't specify one, and rejected outright if wider than 25%. Close-position orders (`reduce_only`) are themselves risk-reducing, so they're exempt from the mandatory stop-loss.
Expand Down
2 changes: 1 addition & 1 deletion docs/McpServer-Skills/SKILLS/Faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Run this in your terminal:
ls ~/.agents/skills
```

You should see 11 directory names: `agent-wallet`, `sunswap-dex-trading`, `sunperp-perpetual-futures-trading`, `tronscan-data-lookup`, `trc20-token-toolkit`, `usdd-just-protocol`, `trx-staking-sr-voting`, `multi-sig-account-permissions`, `x402-payment`, `recharge-skill`, and `bankofai-guide`.
You should see 12 directory names: `agent-wallet`, `sunswap-dex-trading`, `sunpump-meme-token-toolkit`, `sunperp-perpetual-futures-trading`, `tronscan-data-lookup`, `trc20-token-toolkit`, `usdd-just-protocol`, `trx-staking-sr-voting`, `multi-sig-account-permissions`, `x402-payment`, `recharge-skill`, and `bankofai-guide`.

Then verify in your AI chat:

Expand Down
10 changes: 9 additions & 1 deletion docs/McpServer-Skills/SKILLS/Intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ No. Skills use an **on-demand, lightweight architecture** — the AI only loads

## What Can Skills Do for You?

Eleven skills in total — covering the most common scenarios in the TRON ecosystem, plus a dedicated onboarding helper. Each one comes with a ready-to-use sample prompt — copy it into your AI chat and hit enter to try it out.
Twelve skills in total — covering the most common scenarios in the TRON ecosystem, plus a dedicated onboarding helper. Each one comes with a ready-to-use sample prompt — copy it into your AI chat and hit enter to try it out.

### 🔑 Secure Wallet Management

Expand All @@ -75,6 +75,14 @@ Check prices, compare rates, even swap tokens in one go.

💡 For more advanced features, see: [**sunswap**](./BANKOFAISkill.md#sunswap)

### 🚀 Launch & Trade SunPump Meme Coins

Create your own meme token in one sentence, buy and sell on SunPump — TRON's meme-token launchpad — and check market data. Token creation happens **server-side, no wallet needed**: just give a name, symbol, description, and logo. For trading, the AI automatically picks the right path: tokens that haven't created a SunSwap V2 pair yet ("pre-launch") trade on the bonding curve, while tokens that already have a SunSwap V2 pair ("post-launch") go through a regular swap. You can also look up token detail, rankings, holder distribution, and wallet portfolios. TRON mainnet only.

> 🗣️ "Launch a meme token on SunPump — here are the name, symbol, description, and logo." or "Show me the top 10 SunPump meme coins by 24h gain, then check the holder concentration of the top one."

💡 For trading and risk details, see: [**sunpump-agent-skill**](./BANKOFAISkill.md#sunpump-agent-skill)

### 📈 Trade Perpetual Contracts

View market data, open and close positions on SunPerp. Built-in safety locks: max 20x leverage (configurable) and a mandatory stop-loss on every position-opening order — auto-set to 5% from entry if omitted, and rejected if wider than 25%. Keeps you from blowing up your account.
Expand Down
Loading
Loading