Documentation
Agent-Human Handoff
Protocol
How AI agents delegate on-chain actions to humans via handoff links.
The Challenge
AI Agents Cannot:
- Hold private keys safely
- Sign blockchain transactions
- Approve token spending
- Deploy smart contracts
AI Agents Can:
- Call APIs with API keys
- Generate and share links
- Process natural language
- Orchestrate workflows
The Handoff Flow
Agent Layer
1Call API
2Get token ID
3Generate link
4Send to human
Human Layer
5Click link
6Connect wallet
7Approve & sign
Done!
Handoff Link Types
Deploy Link
https://agent-launch.ai/deploy/{token_id}?ref={agent_address}Human deploys a token that the agent created via API. The ref parameter attributes the deployment to the referring agent.
Trade Link
https://agent-launch.ai/trade/{token_address}?action=buy&amount=100Human buys or sells tokens. The action andamount parameters pre-fill the trade form.
Query Parameters
| Parameter | Page | Description |
|---|---|---|
ref | Both | Agent address for attribution tracking |
amount | Deploy, Trade | FET amount to buy on deploy or trade |
action | Trade | buy or sell |
Why Handoff?
Security
Agents never hold private keys. Humans control their own wallets.
Automation
Agents handle API calls and orchestration. Humans just click.
Attribution
The ref parameter tracks which agent brought each user.