Skip to content
Merged
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
2 changes: 2 additions & 0 deletions .github/workflows/docker.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ on:
- master
- update-mcp-server
- ai-bankofai-patch-1
- x402-sdk-1.0.0-update
tags:
- 'test'
pull_request:
Expand All @@ -15,6 +16,7 @@ on:
- master
- update-mcp-server
- ai-bankofai-patch-1
- x402-sdk-1.0.0-update
workflow_dispatch: # Intentionally unrestricted — allows manual builds from any branch for flexibility

env:
Expand Down
32 changes: 16 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# 🚀 BANK OF AI
# 🚀 BANK OF AI

**Building a Decentralized Financial Sovereignty and Commercial Interconnection Layer for AI Agents**

Expand All @@ -16,9 +16,9 @@ Currently supports **TRON** and **BSC**, with more blockchain networks coming in

x402 is an open blockchain payment protocol based on the HTTP `402 Payment Required` status code. It removes payment friction in M2M (machine-to-machine) interactions for AI agents.

- **Payment-as-Response**: Enables a “pay-before-response” mechanism without complex account registration or session management.
- **Multi-Chain Support**: Currently supports **TRON** (Mainnet/Shasta/Nile) and **BSC** (Mainnet/Testnet); More blockchain networks will be supported in the future.
- **AI-Friendly**: Supports signed payloads, allowing agents to complete settlements automatically.
- **Payment-as-Response**: Enables a “pay-before-response” mechanism without complex account registration or session management.
- **Multi-Chain Support**: Currently supports **TRON** (Mainnet/Shasta/Nile) and **BSC** (Mainnet/Testnet); More blockchain networks will be supported in the future.
- **AI-Friendly**: Supports signed payloads, allowing agents to complete settlements automatically.
- **Use Cases**: Pay-per-request APIs, paywalls, and automated settlement between agents.

---
Expand All @@ -27,9 +27,9 @@ x402 is an open blockchain payment protocol based on the HTTP `402 Payment Requi

Built on the Model Context Protocol (MCP) architecture, providing full on-chain execution capabilities for agents.

- **Infrastructure Layer (MCP Server)**: The agent’s **“hands and eyes.”** Provides a unified interface to read blocks, manage wallets, execute transfers, and interact with any contract.
- **Application Logic Layer (Skills)**: The agent’s **“brain.”** Uses structured instructions (`SKILL.md`) to guide AI in orchestrating underlying tools.
- **sunswap**: Enables automated DEX swaps.
- **Infrastructure Layer (MCP Server)**: The agent’s **“hands and eyes.”** Provides a unified interface to read blocks, manage wallets, execute transfers, and interact with any contract.
- **Application Logic Layer (Skills)**: The agent’s **“brain.”** Uses structured instructions (`SKILL.md`) to guide AI in orchestrating underlying tools.
- **sunswap**: Enables automated DEX swaps.
- **x402-payment**: Allows agents to detect payment requirements and execute payments automatically.

---
Expand All @@ -38,8 +38,8 @@ Built on the Model Context Protocol (MCP) architecture, providing full on-chain

OpenClaw is a financial extension plugin developed by BANK OF AI for AI agents, aiming to become the “central bank” of the agent economy.

- **Wallet Ownership**: Enables agents to truly control and manage on-chain assets.
- **Autonomous Spending**: Agents can independently pay for computation, storage, and data resources.
- **Wallet Ownership**: Enables agents to truly control and manage on-chain assets.
- **Autonomous Spending**: Agents can independently pay for computation, storage, and data resources.
- **Seamless Integration**: Built-in MCP server and automatic skill installer for plug-and-play setup.

---
Expand All @@ -57,27 +57,27 @@ OpenClaw is a financial extension plugin developed by BANK OF AI for AI agents,

## 🚦 Quick Start

### 🚀 For Sellers
### 🚀 For Sellers
*Want to monetize your API, content, or services?*

1. **Integrate x402**: Deploy server-side logic to detect payment requirements and return a `402` status code with payment instructions.
1. **Integrate x402**: Deploy server-side logic to detect payment requirements and return a `402` status code with payment instructions.
2. **Publish Skills**: Write a `SKILL.md` for your service so other AI agents can understand how to interact with it.

---

### 🤖 For Agents/Buyers
### 🤖 For Agents/Buyers
*Want your agent to have autonomous payment and on-chain interaction capabilities?*

1. **Install OpenClaw**: Configure your environment and connect to the [mcp-server-tron](https://github.com/BofAI/mcp-server-tron).
2. **Sync Skills**: Load `sunswap` or `x402-payment` from the [skills](https://github.com/BofAI/skills) repository.
1. **Install OpenClaw**: Configure your environment and connect to the [mcp-server-tron](https://github.com/BofAI/mcp-server-tron).
2. **Sync Skills**: Load `sunswap` or `x402-payment` from the [skills](https://github.com/BofAI/skills) repository.
3. **Start Transacting**: Your agent can now automatically process payment requests from sellers and execute settlements.

---

## 🏗️ Developer Resources

- **Documentation Center**: [docs.bankofai.io](https://docs.bankofai.io)
- **Live Demo**: [x402-demo Repository](https://github.com/BofAI/x402-demo)
- **Documentation Center**: [docs.bankofai.io](https://docs.bankofai.io)
- **Reference Examples**: [x402-examples](https://github.com/BofAI/x402/tree/main/examples/typescript)
- **Technical Support**: Submit issues or join discussions on GitHub.

---
Expand Down
36 changes: 35 additions & 1 deletion docs/McpServer-Skills/SKILLS/BANKOFAISkill.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ BANK OF AI SKILLS can operate on **real on-chain assets**. Blockchain transactio
| **multisig-permissions** | Multi-sig permission setup, key management, co-signed proposals | Wallet credentials (owner key for permission changes) |
| **x402-payment** | On-chain "pay-first" auto-settlement on TRON (TRC20) & BSC (ERC20), with GasFree support | Wallet credentials (via agent-wallet) |
| **recharge-skill** | Balance, order history, account top-up | BANK OF AI API key |
| **twitter-digest** | Generate a daily digest from your own X/Twitter account — mentions, home timeline, and reply opportunities (API-only) | X/Twitter API credentials |
| **twitter-mcp** | Install/authorize the `xurl` CLI for X/Twitter and generate digests from it; optional hosted X MCP bridge | X/Twitter OAuth (via `xurl`) |
| **bankofai-guide** | Onboarding helper — post-install setup, first AgentWallet creation, wallet guard for other skills | None (runs automatically when needed) |

### 🔑 Where Do I Get These Keys? How Do I Set Them Up?
Expand Down Expand Up @@ -439,7 +441,7 @@ Some APIs and AI agents require on-chain payment before use. This skill uses the
> Activate my GasFree account on nile with USDT.

:::tip GasFree support (TRON)
The skill prefers the `exact_gasfree` scheme over `exact_permit` when paying on TRON. GasFree requires an activated account with enough token balance in the GasFree wallet — use `--gasfree-info` to check, and `--gasfree-activate` if it's not active yet.
When paying on TRON, the skill prefers `exact_gasfree` and automatically falls back to `exact` if GasFree payment creation fails. GasFree requires sufficient token balance in the GasFree wallet; inactive accounts can be activated on first payment when the advertised fees permit it. Use `--gasfree-info` to check wallet address, activation status, balance, and nonce; use `--gasfree-activate` to activate manually.
:::

:::caution Wallet credentials come from agent-wallet
Expand All @@ -464,6 +466,38 @@ Check your balance, view order history, or top up your account.

---

## twitter-digest {#twitter-digest}

Generate a concise daily digest from your own X/Twitter account. This skill is **API-only** — it reads your mentions, home timeline, and reply opportunities to produce a daily social-media summary. Trigger it with phrases like "生成X日报", "X日报", "推特日报", or "Twitter digest".

**What it does:**

> Generate today's X/Twitter digest for my account.

> Summarize my mentions and reply opportunities from the last day.

:::caution Requires X/Twitter API access
This skill pulls data through the X/Twitter API, so it needs valid API credentials configured for your account.
:::

---

## twitter-mcp {#twitter-mcp}

Install and authorize `@xdevplatform/xurl`, then generate X/Twitter daily digests directly from the local `xurl` CLI (commands like `whoami`, `timeline`, `mentions`, `posts`, `search`). Unlike `twitter-digest`, the data source here is the local `xurl` CLI rather than an API collector. The hosted X MCP bridge can optionally be registered as `xapi` on request.

**What it does:**

> Install and authorize xurl for my X/Twitter account.

> Generate my X/Twitter daily digest from the xurl CLI.

:::tip xurl vs. twitter-digest
Use `twitter-mcp` when you want digests driven by the local `xurl` CLI; use `twitter-digest` for the API-only digest flow.
:::

---

## bankofai-guide {#bankofai-guide}

The onboarding companion that ties the rest of the skill set together. You don't typically invoke this skill directly — it kicks in automatically in three situations:
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 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`.
You should see 14 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`, `twitter-digest`, `twitter-mcp`, 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?

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.
Fourteen skills in total — covering the most common scenarios in the TRON ecosystem plus X/Twitter tooling, and 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 Down Expand Up @@ -147,6 +147,14 @@ Check your BANK OF AI balance and top up with a single sentence.

💡 For top-up and withdrawal rules, see: [**recharge-skill**](./BANKOFAISkill.md#recharge-skill)

### 🐦 X/Twitter Daily Digest

Turn your own X/Twitter account into a daily briefing — mentions, home timeline, and reply opportunities, summarized for you.

> 🗣️ "Generate today's X/Twitter digest for my account."

💡 Two ways to run it: API-only via [**twitter-digest**](./BANKOFAISkill.md#twitter-digest), or from the local `xurl` CLI via [**twitter-mcp**](./BANKOFAISkill.md#twitter-mcp).

### 🧭 Onboarding Guide (bankofai-guide)

A lightweight companion skill that runs the post-install setup flow, helps you create your first AgentWallet, and acts as a "wallet guard" before any on-chain operation — reminding you to set up a wallet if none exists. You don't usually call it directly; it gets invoked automatically by the installer and by other skills when needed.
Expand Down
15 changes: 11 additions & 4 deletions docs/McpServer-Skills/SKILLS/QuickStart.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ If you're already using a Skills-compatible AI Agent (OpenClaw, a Telegram bot,
3. The AI handles the entire flow automatically:
- Pulls the `BofAI/skills` repository
- Detects your current Agent's skills directory (e.g. `~/.agents/skills/`)
- Installs all 12 BANK OF AI skills: the 11 core skills (`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`) plus `bankofai-guide` (the onboarding helper)
- Installs all 14 BANK OF AI skills: the 13 core skills (`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`, `twitter-digest`, `twitter-mcp`) plus `bankofai-guide` (the onboarding helper)

:::tip Why this is the recommended path for beginners
You don't need to know what `npx`, `npm`, or "global install" mean. The AI handles every step including selecting the right skills directory for your platform, installing the wallet CLI, and onboarding you to your first wallet.
Expand Down Expand Up @@ -70,13 +70,14 @@ The installer will guide you through a few steps — just follow along:
The installer automatically fetches all available Skills from the repo and lists them for selection. Press **Space** to toggle each one — we recommend selecting all:

```
◇ Found 12 skills
◇ Found 14 skills
◇ Select skills to install (space to toggle)
│ agent-wallet, bankofai-guide, Multi-Sig & Account Permissions,
│ recharge-skill, SunPerp Perpetual Futures Trading, SunPump Meme Token Toolkit,
│ SunSwap DEX Trading, TRC20 Token Toolkit, TronScan Data Lookup,
│ TRX Staking & SR Voting, USDD / JUST Protocol, x402-payment
│ TRX Staking & SR Voting, USDD / JUST Protocol, twitter-digest, twitter-mcp,
│ x402-payment
```

:::tip Select all
Expand Down Expand Up @@ -223,7 +224,7 @@ When you see output like this, all Skills have been successfully installed to yo
```
◇ Installation complete

◇ Installed 12 skills ──────────────────────────────────────────────────╮
◇ Installed 14 skills ──────────────────────────────────────────────────╮
│ │
│ ✓ ~/.agents/skills/bankofai-guide │
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
Expand Down Expand Up @@ -255,6 +256,12 @@ When you see output like this, all Skills have been successfully installed to yo
│ ✓ ~/.agents/skills/usdd-just-protocol │
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
│ symlinked: Claude Code, OpenClaw │
│ ✓ ~/.agents/skills/twitter-digest │
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
│ symlinked: Claude Code, OpenClaw │
│ ✓ ~/.agents/skills/twitter-mcp │
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
│ symlinked: Claude Code, OpenClaw │
│ ✓ ~/.agents/skills/x402-payment │
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
│ symlinked: Claude Code, OpenClaw │
Expand Down
22 changes: 16 additions & 6 deletions docs/Openclaw-extension/QuickStart.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,9 +115,9 @@ After confirming, the installer automatically removes old skills:
```
Running cleanup...

◇ Found 11 unique installed skill(s)
◇ Found 14 unique installed skill(s)
◇ Removal process complete
◆ Successfully removed 11 skill(s)
◆ Successfully removed 14 skill(s)

✓ Clean install cleanup completed.

Expand Down Expand Up @@ -295,12 +295,13 @@ Press Enter (or type `1`) to install globally — this way all your OpenClaw wor
Then the skill picker launches:

```
◇ Found 11 skills
◇ Found 14 skills
◇ Select skills to install (space to toggle)
│ agent-wallet, bankofai-guide, Multi-Sig & Account Permissions, recharge-skill,
│ SunPerp Perpetual Futures Trading, SunSwap DEX Trading, TRC20 Token Toolkit,
│ TronScan Data Lookup, TRX Staking & SR Voting, USDD / JUST Protocol, x402-payment
│ SunPerp Perpetual Futures Trading, SunPump Meme Token Toolkit, SunSwap DEX Trading,
│ TRC20 Token Toolkit, TronScan Data Lookup, TRX Staking & SR Voting, USDD / JUST Protocol,
│ twitter-digest, twitter-mcp, x402-payment
```

Here's what each skill does:
Expand All @@ -311,11 +312,14 @@ Here's what each skill does:
| **bankofai-guide** | Onboarding helper that walks the AI through next steps after installation |
| **SunSwap DEX Trading** | Swap tokens on SunSwap (TRON's biggest DEX) |
| **SunPerp Perpetual Futures** | Trade perpetual futures on SunPerp |
| **SunPump Meme Token Toolkit** | Create and trade meme tokens on SunPump; query token info, rankings, holders, and trade history |
| **TronScan Data Lookup** | Query blockchain data via TronScan |
| **TRC20 Token Toolkit** | Common TRC20 token operations like sending tokens |
| **TRX Staking & SR Voting** | Stake TRX, get energy/bandwidth, and vote for Super Representatives |
| **USDD / JUST Protocol** | Manage USDD stablecoin and JUST Protocol positions |
| **Multi-Sig & Account Permissions** | Multi-signature wallet and account permission management |
| **twitter-digest** | Generate X/Twitter daily digests (mentions, home timeline, reply opportunities) |
| **twitter-mcp** | Install/authorize xurl for X/Twitter and generate digests from the local xurl CLI |
| **x402-payment** | x402 protocol payments (agent-to-agent) |
| **recharge-skill** | Check and top up your BANK OF AI balance |

Expand All @@ -328,30 +332,36 @@ After selecting, the installer shows a security risk assessment:
│ Multi-Sig & Account Permissions -- -- --
│ recharge-skill Safe 1 alert Med Risk
│ SunPerp Perpetual Futures Trading -- -- --
│ SunPump Meme Token Toolkit -- -- --
│ SunSwap DEX Trading -- -- --
│ TRC20 Token Toolkit -- -- --
│ TronScan Data Lookup -- -- --
│ TRX Staking & SR Voting -- -- --
│ USDD / JUST Protocol -- -- --
│ twitter-digest -- -- --
│ twitter-mcp -- -- --
│ x402-payment Safe 1 alert Med Risk
│ agent-wallet Safe 1 alert High Risk
```

Review the report, then confirm to proceed. When installation completes:

```
◇ Installed 11 skills
◇ Installed 14 skills
│ ✓ agent-wallet → ~/.openclaw/skills/agent-wallet
│ ✓ bankofai-guide → ~/.openclaw/skills/bankofai-guide
│ ✓ Multi-Sig & Account Permissions → ~/.openclaw/skills/multi-sig-account-permissions
│ ✓ recharge-skill → ~/.openclaw/skills/recharge-skill
│ ✓ SunPerp Perpetual Futures Trading → ~/.openclaw/skills/sunperp-perpetual-futures-trading
│ ✓ SunPump Meme Token Toolkit → ~/.openclaw/skills/sunpump-meme-token-toolkit
│ ✓ SunSwap DEX Trading → ~/.openclaw/skills/sunswap-dex-trading
│ ✓ TRC20 Token Toolkit → ~/.openclaw/skills/trc20-token-toolkit
│ ✓ TronScan Data Lookup → ~/.openclaw/skills/tronscan-data-lookup
│ ✓ TRX Staking & SR Voting → ~/.openclaw/skills/trx-staking-sr-voting
│ ✓ USDD / JUST Protocol → ~/.openclaw/skills/usdd-just-protocol
│ ✓ twitter-digest → ~/.openclaw/skills/twitter-digest
│ ✓ twitter-mcp → ~/.openclaw/skills/twitter-mcp
│ ✓ x402-payment → ~/.openclaw/skills/x402-payment
```

Expand Down
Loading
Loading