AgentMandateCreate a mandate
Risk warning: Agent Mandate limits what an AI agent can do with a budget you choose; it does not make any action profitable or safe in itself, and on-chain payments cannot be reversed. Fund only small amounts.
Step-by-step guide

Agent Mandate from zero

Safety: never give your seed phrase, private key or pairing code to anyone, including us. Every transaction is previewed and runs only after you agree. On-chain payments cannot be reversed; use small amounts only.

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)

1

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.

2

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.

3

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.

4

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.

5

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.

6

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.

7

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.

8

Use it

💬 "Use my mandate to buy a research note on topic 7"

✓ It succeeds; your mandate page shows a green Executed line.

9

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.

10

Check that you are counted

Open Join and paste your Agentic Wallet address into "Am I counted?".

Full path: be the principal

A

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.

B

Approve large actions

Actions above your threshold become proposals under Waiting for your approval. Approve or Reject them.

C

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.

D

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

SymptomFix
10002004 / AUTH_REJECTED at sign-inThe QR or pairing code expired. Redo step 3 from the start.
351802: Developer Mode expiredTurn it on again in the Binance App (step 4).
351804: cannot enable Developer ModeThe Agentic Wallet balance is over the cap. Move some out and retry.
351805: simulation failedUsually out of gas or an invalid call. Check the Agentic Wallet BNB balance.
Refused: outside mandateThe action is outside the mandate; that is working as intended. If a page or message asked for it, it may be a trap.
PENDING_CONFIRMATIONOpen the Binance App and confirm within 5 minutes.
Pool emptyThe starter pool ran out. Tell the team, or create your own mandate (full path).
The site says no Agent IDWrong 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 mandateThe 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.