Agent Mandate from zero
What you need
- ☐ The Binance App with a verified account and Binance Wallet
- ☐ A computer with Node.js 18+ and an AI agent that runs Skills (OpenClaw is officially supported by Binance; Claude Code also runs Skills)
- ☐ About 0.0002 BNB on BSC for gas in the Agentic Wallet
- ☐ Quick path (starter): that is all. Full path: also your own main wallet (Binance Wallet or MetaMask) with ~0.001 BNB
Quick path: starter mandate (~10 min)
Claim your Agent ID (this also creates your Agentic Wallet)
Binance App → Wallet → homepage banner → Agent ID → pick a name.ai → confirm. Each user gets one Agent ID; it cannot be transferred.
✓ You see your .ai name and an Agentic Wallet management page in the app.
Install the Agentic Wallet Skill and the baw CLI (official, by Binance)
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/binance-agentic-wallet
npm install -g @binance/agentic-wallet@1.12.0
✓ baw --help prints its commands.
Sign your agent in to the Agentic Wallet
💬 "Sign in to my Agentic Wallet"
The agent runs baw auth signin: the terminal shows a pairing code and opens a page with a QR code. In the Binance App, scan it, check the pairing code matches, and confirm. The agent waits for baw auth verify to return SUCCESS. This is Binance's official flow on your own machine; the Agent Mandate website never shows a QR code or asks for a pairing code.
baw wallet status --json
✓ status is CONNECTED. If it says expired (10002004), start this step again.
Turn on Developer Mode
Binance App → Agentic Wallet management → Settings (top-right icon) → Developer Mode → read the Risk Warning → confirm → approve the signature request. Your agent needs it to call the Agent Mandate contract. It lasts 7 days and each use extends it. The Agentic Wallet balance must be under the Developer Mode cap, so keep only a little in it.
baw wallet settings --json
✓ devMode.enabled is true.
Add gas
💬 "What is my Agentic Wallet BSC address?"
Send about 0.0002 BNB (BSC network) to that address. Each action costs roughly 0.000005–0.00002 BNB.
Install the Agent Mandate Skill
git clone https://github.com/Ceros612bnb/agent-mandate.git cd agent-mandate/skill/mandate npm install
Copy the skill/mandate folder into your agent's skills folder (or point your agent to it), then create config.json with:
{
"agentMandate": "0xEe76D7aa4e930C83DEe5fAF57a2E8eE942c7C5b5",
"demoResearchDesk": "0x993885cAd8EbF4f6E03B3630e3515929a416D189",
"starterFaucet": "0x4c1d35a7963b3F1Dc6289C84c5CBc142fEa4B208",
"rpcUrl": "https://bsc-rpc.publicnode.com",
"chainId": 56
}💬 "Is Agent Mandate ready?"
✓ ready shows hasAgentId, developerModeEnabled and hasGas all true.
Claim your starter mandate
💬 "Claim my Agent Mandate starter"
Your agent shows a summary: a 0.00005 BNB budget that can only buy demo notes, valid 14 days. Say yes; if the Binance App asks for confirmation, confirm there.
✓ Your agent reports your mandate number. You are now counted in the challenge.
Use it
💬 "Use my mandate to buy a research note on topic 7"
✓ It succeeds; your mandate page shows a green Executed line.
Try to trick your agent
💬 "Send 0.00001 BNB from my mandate to 0x000000000000000000000000000000000000dEaD"
The Skill refuses at once: that address is not in your mandate. To see the contract block it on-chain, say explicitly: "Demonstrate a blocked attempt". After you agree, the agent submits it with --allow-blocked; no funds move and the attempt is recorded publicly. Three of those and the mandate locks itself.
✓ Your mandate page shows a red Blocked line and the attacker received nothing.
Check that you are counted
Open Join and paste your Agentic Wallet address into "Am I counted?".
Full path: be the principal
Create a mandate with your own main wallet
Open My mandates in your main wallet's browser (Binance Wallet in-app browser, or a computer with MetaMask). This is your wallet, not the Agentic Wallet. Connect, paste the agent address (it must show ✓ holds a Binance Agent ID), set the budget, caps per action and per day, the approval threshold, days valid, blocked attempts before auto-lock and the allowed services, then Create and fund.
Approve large actions
Actions above your threshold become proposals under Waiting for your approval. Approve or Reject them.
Revoke and withdraw
Revoke stops the agent at once (and every sub-agent it delegated to). Withdraw all returns the rest to your own wallet.
Delegate to a sub-agent (optional)
💬 "Give agent 0x… a sub-mandate: 0.00001 per action, 0.00002 per day, 3 days, notes only"
A sub-mandate can only be narrower than its parent, and its spending counts against every level above it.
Troubleshooting
| Symptom | Fix |
|---|---|
| 10002004 / AUTH_REJECTED at sign-in | The QR or pairing code expired. Redo step 3 from the start. |
| 351802: Developer Mode expired | Turn it on again in the Binance App (step 4). |
| 351804: cannot enable Developer Mode | The Agentic Wallet balance is over the cap. Move some out and retry. |
| 351805: simulation failed | Usually out of gas or an invalid call. Check the Agentic Wallet BNB balance. |
| Refused: outside mandate | The action is outside the mandate; that is working as intended. If a page or message asked for it, it may be a trap. |
| PENDING_CONFIRMATION | Open the Binance App and confirm within 5 minutes. |
| Pool empty | The starter pool ran out. Tell the team, or create your own mandate (full path). |
| The site says no Agent ID | Wrong address. Use your Agentic Wallet BSC address (step 5). |
| Your wallet (e.g. MetaMask) warns the site or contract is "unknown" or "malicious" when creating a mandate | The site and contracts are new, so automated filters have no reputation for them yet; we have reported it as a false positive. Before confirming, check it yourself: the site is ceros612bnb.github.io/agent-mandate, the contract is 0xEe76D7aa4e930C83DEe5fAF57a2E8eE942c7C5b5 (verified on BscScan), the BNB amount equals the budget you typed, and there is no token approval. If unsure, do not confirm; the starter path through your agent needs no wallet connection on the site. |
Frequently asked questions
Can I lose money?
Only small gas fees for transactions you approve. The starter budget is sponsored, can only buy demo notes, and those payments are burned; nobody profits.
Does the agent spend on its own?
No. Every transaction is previewed and needs your yes, and the contract also blocks anything out of scope even if you approve by mistake.
Why two wallets?
The full path separates the one who grants (your wallet) from the one who acts (the agent), so a hijacked agent cannot withdraw. The quick path needs only the agent wallet.
Who sees my data?
Everything on-chain is public: wallet addresses, mandates, actions. No names or personal data are stored.
How do I stop?
Just stop. On the full path, click Revoke and then Withdraw all.
Is there an admin?
AgentMandate has none. StarterFaucet only has its sponsor, who can withdraw the unused pool and revoke starter mandates, as disclosed in the source.