Skip to content

Commit 9dcb7cc

Browse files
Merge branch 'main' into ai-bankofai-patch-1
2 parents eaee132 + 170ad5c commit 9dcb7cc

44 files changed

Lines changed: 1618 additions & 2810 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/docker.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ on:
77
- master
88
- update-mcp-server
99
- ai-bankofai-patch-1
10+
- x402-sdk-1.0.0-update
1011
tags:
1112
- 'test'
1213
pull_request:
@@ -15,6 +16,7 @@ on:
1516
- master
1617
- update-mcp-server
1718
- ai-bankofai-patch-1
19+
- x402-sdk-1.0.0-update
1820
workflow_dispatch: # Intentionally unrestricted — allows manual builds from any branch for flexibility
1921

2022
env:

README.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 🚀 BANK OF AI
1+
# 🚀 BANK OF AI
22

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

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

1717
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.
1818

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

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

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

30-
- **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.
31-
- **Application Logic Layer (Skills)**: The agent’s **“brain.”** Uses structured instructions (`SKILL.md`) to guide AI in orchestrating underlying tools.
32-
- **sunswap**: Enables automated DEX swaps.
30+
- **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.
31+
- **Application Logic Layer (Skills)**: The agent’s **“brain.”** Uses structured instructions (`SKILL.md`) to guide AI in orchestrating underlying tools.
32+
- **sunswap**: Enables automated DEX swaps.
3333
- **x402-payment**: Allows agents to detect payment requirements and execute payments automatically.
3434

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

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

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

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

5858
## 🚦 Quick Start
5959

60-
### 🚀 For Sellers
60+
### 🚀 For Sellers
6161
*Want to monetize your API, content, or services?*
6262

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

6666
---
6767

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

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

7575
---
7676

7777
## 🏗️ Developer Resources
7878

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

8383
---

docs/McpServer-Skills/SKILLS/BANKOFAISkill.md

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ BANK OF AI SKILLS can operate on **real on-chain assets**. Blockchain transactio
2727
| **multisig-permissions** | Multi-sig permission setup, key management, co-signed proposals | Wallet credentials (owner key for permission changes) |
2828
| **x402-payment** | On-chain "pay-first" auto-settlement on TRON (TRC20) & BSC (ERC20), with GasFree support | Wallet credentials (via agent-wallet) |
2929
| **recharge-skill** | Balance, order history, account top-up | BANK OF AI API key |
30+
| **twitter-digest** | Generate a daily digest from your own X/Twitter account — mentions, home timeline, and reply opportunities (API-only) | X/Twitter API credentials |
31+
| **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`) |
3032
| **bankofai-guide** | Onboarding helper — post-install setup, first AgentWallet creation, wallet guard for other skills | None (runs automatically when needed) |
3133

3234
### 🔑 Where Do I Get These Keys? How Do I Set Them Up?
@@ -439,7 +441,7 @@ Some APIs and AI agents require on-chain payment before use. This skill uses the
439441
> Activate my GasFree account on nile with USDT.
440442
441443
:::tip GasFree support (TRON)
442-
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.
444+
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.
443445
:::
444446

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

469+
## twitter-digest {#twitter-digest}
470+
471+
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".
472+
473+
**What it does:**
474+
475+
> Generate today's X/Twitter digest for my account.
476+
477+
> Summarize my mentions and reply opportunities from the last day.
478+
479+
:::caution Requires X/Twitter API access
480+
This skill pulls data through the X/Twitter API, so it needs valid API credentials configured for your account.
481+
:::
482+
483+
---
484+
485+
## twitter-mcp {#twitter-mcp}
486+
487+
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.
488+
489+
**What it does:**
490+
491+
> Install and authorize xurl for my X/Twitter account.
492+
493+
> Generate my X/Twitter daily digest from the xurl CLI.
494+
495+
:::tip xurl vs. twitter-digest
496+
Use `twitter-mcp` when you want digests driven by the local `xurl` CLI; use `twitter-digest` for the API-only digest flow.
497+
:::
498+
499+
---
500+
467501
## bankofai-guide {#bankofai-guide}
468502

469503
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:

docs/McpServer-Skills/SKILLS/Faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Run this in your terminal:
4040
ls ~/.agents/skills
4141
```
4242

43-
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`.
43+
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`.
4444

4545
Then verify in your AI chat:
4646

docs/McpServer-Skills/SKILLS/Intro.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ No. Skills use an **on-demand, lightweight architecture** — the AI only loads
5757

5858
## What Can Skills Do for You?
5959

60-
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.
60+
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.
6161

6262
### 🔑 Secure Wallet Management
6363

@@ -147,6 +147,14 @@ Check your BANK OF AI balance and top up with a single sentence.
147147
148148
💡 For top-up and withdrawal rules, see: [**recharge-skill**](./BANKOFAISkill.md#recharge-skill)
149149

150+
### 🐦 X/Twitter Daily Digest
151+
152+
Turn your own X/Twitter account into a daily briefing — mentions, home timeline, and reply opportunities, summarized for you.
153+
154+
> 🗣️ "Generate today's X/Twitter digest for my account."
155+
156+
💡 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).
157+
150158
### 🧭 Onboarding Guide (bankofai-guide)
151159

152160
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.

docs/McpServer-Skills/SKILLS/QuickStart.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ If you're already using a Skills-compatible AI Agent (OpenClaw, a Telegram bot,
2929
3. The AI handles the entire flow automatically:
3030
- Pulls the `BofAI/skills` repository
3131
- Detects your current Agent's skills directory (e.g. `~/.agents/skills/`)
32-
- 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)
32+
- 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)
3333

3434
:::tip Why this is the recommended path for beginners
3535
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.
@@ -70,13 +70,14 @@ The installer will guide you through a few steps — just follow along:
7070
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:
7171

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

8283
:::tip Select all
@@ -223,7 +224,7 @@ When you see output like this, all Skills have been successfully installed to yo
223224
```
224225
◇ Installation complete
225226
226-
◇ Installed 12 skills ──────────────────────────────────────────────────╮
227+
◇ Installed 14 skills ──────────────────────────────────────────────────╮
227228
│ │
228229
│ ✓ ~/.agents/skills/bankofai-guide │
229230
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
@@ -255,6 +256,12 @@ When you see output like this, all Skills have been successfully installed to yo
255256
│ ✓ ~/.agents/skills/usdd-just-protocol │
256257
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
257258
│ symlinked: Claude Code, OpenClaw │
259+
│ ✓ ~/.agents/skills/twitter-digest │
260+
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
261+
│ symlinked: Claude Code, OpenClaw │
262+
│ ✓ ~/.agents/skills/twitter-mcp │
263+
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
264+
│ symlinked: Claude Code, OpenClaw │
258265
│ ✓ ~/.agents/skills/x402-payment │
259266
│ universal: Amp, Antigravity, Antigravity CLI, Cline, Codex +8 more │
260267
│ symlinked: Claude Code, OpenClaw │

docs/Openclaw-extension/QuickStart.md

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -115,9 +115,9 @@ After confirming, the installer automatically removes old skills:
115115
```
116116
Running cleanup...
117117
118-
◇ Found 11 unique installed skill(s)
118+
◇ Found 14 unique installed skill(s)
119119
◇ Removal process complete
120-
◆ Successfully removed 11 skill(s)
120+
◆ Successfully removed 14 skill(s)
121121
122122
✓ Clean install cleanup completed.
123123
@@ -295,12 +295,13 @@ Press Enter (or type `1`) to install globally — this way all your OpenClaw wor
295295
Then the skill picker launches:
296296

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

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

@@ -328,30 +332,36 @@ After selecting, the installer shows a security risk assessment:
328332
│ Multi-Sig & Account Permissions -- -- --
329333
│ recharge-skill Safe 1 alert Med Risk
330334
│ SunPerp Perpetual Futures Trading -- -- --
335+
│ SunPump Meme Token Toolkit -- -- --
331336
│ SunSwap DEX Trading -- -- --
332337
│ TRC20 Token Toolkit -- -- --
333338
│ TronScan Data Lookup -- -- --
334339
│ TRX Staking & SR Voting -- -- --
335340
│ USDD / JUST Protocol -- -- --
341+
│ twitter-digest -- -- --
342+
│ twitter-mcp -- -- --
336343
│ x402-payment Safe 1 alert Med Risk
337344
│ agent-wallet Safe 1 alert High Risk
338345
```
339346

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

342349
```
343-
◇ Installed 11 skills
350+
◇ Installed 14 skills
344351
345352
│ ✓ agent-wallet → ~/.openclaw/skills/agent-wallet
346353
│ ✓ bankofai-guide → ~/.openclaw/skills/bankofai-guide
347354
│ ✓ Multi-Sig & Account Permissions → ~/.openclaw/skills/multi-sig-account-permissions
348355
│ ✓ recharge-skill → ~/.openclaw/skills/recharge-skill
349356
│ ✓ SunPerp Perpetual Futures Trading → ~/.openclaw/skills/sunperp-perpetual-futures-trading
357+
│ ✓ SunPump Meme Token Toolkit → ~/.openclaw/skills/sunpump-meme-token-toolkit
350358
│ ✓ SunSwap DEX Trading → ~/.openclaw/skills/sunswap-dex-trading
351359
│ ✓ TRC20 Token Toolkit → ~/.openclaw/skills/trc20-token-toolkit
352360
│ ✓ TronScan Data Lookup → ~/.openclaw/skills/tronscan-data-lookup
353361
│ ✓ TRX Staking & SR Voting → ~/.openclaw/skills/trx-staking-sr-voting
354362
│ ✓ USDD / JUST Protocol → ~/.openclaw/skills/usdd-just-protocol
363+
│ ✓ twitter-digest → ~/.openclaw/skills/twitter-digest
364+
│ ✓ twitter-mcp → ~/.openclaw/skills/twitter-mcp
355365
│ ✓ x402-payment → ~/.openclaw/skills/x402-payment
356366
```
357367

0 commit comments

Comments
 (0)