Link Your Agent

Use this page if you are about to open or approve the hosted approval link.

Link your agent wallet to your Biomapper-verified wallet so supported x402 services can recognize verified-human free tiers, free trials, or linked-only access.

This is a one-time on-chain approval. After it is done, any service that supports Agentlink knows your agent is backed by a real, verified human.

What success looks like

• transaction confirmed
• no further approval needed
• return to the product or continue using the agent

What you need

• A Biomapper-verified wallet (EOA) on Base or Base Sepolia
• A small amount of gas on that network
• An approval URL (from your platform, or generated with agentlink link --owner ... --open)

Don't have an approval URL yet? See Self-Hosted Agent Operators if you run the agent runtime yourself, or ask the platform that runs your agent to issue the approval link first.

Step-by-step

1. Get the approval URL. Your platform provides it, or you generate it yourself with agentlink link --owner 0xOwner --open.
2. Open it in your browser. The URL already contains everything the linker needs: the agent wallet, network, registry address, and a one-time agent consent signature.
3. Connect your Biomapper-verified wallet. This is your owner wallet, the one you biomapped. Do not use the agent wallet here.
4. Check the details. Confirm the agent address and network shown match what you expect.
5. Approve the on-chain transaction. Click submit in your wallet app. Once the transaction confirms, the link is active.

Recovery and troubleshooting

• Wrong wallet: Reconnect the biomapped owner wallet, not the agent wallet, then reopen the same approval link.
• Expired link: Ask whoever generated the URL for a fresh approval link.
• Already linked: No further approval is needed. Return to the product or continue using the agent.
• Biomapper missing: Finish Biomapper, then come back and check again.

What you just approved

The on-chain linkAgent(...) call records the link between:

• Your owner wallet (your Biomapper-verified wallet)
• The agent wallet (the wallet your agent uses to pay for services)

This is not just connecting your wallet for read access. It is a real blockchain transaction. The link stays active as long as your owner wallet is biomapped in the current Biomapper generation.

After linking

• The agent now qualifies for verified-human handling on any x402 service using Agentlink.
• Any per-human usage quotas are scoped to you and reset each Biomapper generation.
• You can link multiple agents independently. Each needs its own approval.

Managing and revoking links

Open the linker management page at manage.html to review or revoke any of your links. Revoking removes the link immediately. Either the owner wallet or the agent wallet can call unlinkAgent at the protocol level.

FAQ

Does linking cost anything? Yes, a small gas fee on Base or Base Sepolia. There is no ongoing cost.

Am I just connecting my wallet? No. Connecting lets the linker read your Biomapper status. The final step is an on-chain transaction.

Can I link multiple agents? Yes. Each agent is linked independently with its own approval.

What happens when a Biomapper generation ends? Your link stays stored but goes inactive when your owner wallet is not biomapped in the new generation. Re-verify your wallet on Biomapper to reactivate it automatically.

What if I switch wallets? If you biomap a different wallet in a new generation, you need a new link. The old link stays stored but inactive.

Is my identity shared with platforms? No. Platforms only see that the agent is backed by a biomapped human, not who you are. Only the agent → owner mapping is stored on-chain.

Do I need to choose a registry or enter contract details? No. Those details are embedded in the approval URL. You only need to verify the agent address and network shown are correct.