Files
skills/public/hanzo-web3.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

348 lines
24 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-web3</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hanzo-web3.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-web3">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-web3.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hanzo-web3</h1><p class="lede">Hanzo Web3 is the blockchain infrastructure layer of the Hanzo ecosystem.</p><h1>Hanzo Web3 - Blockchain API for 100+ Chains</h1>
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-web3-gateway.md</code>, <code>hanzo/hanzo-mcp.md</code>, <code>hanzo/hanzo-commerce.md</code></p>
<h2>Overview</h2>
<p>Hanzo Web3 is the <strong>blockchain infrastructure layer</strong> of the Hanzo ecosystem. It provides unified API access to 100+ EVM and non-EVM chains including Ethereum, Solana, Base, Arbitrum, Polygon, Lux, and more. Node RPC, structured data, webhooks, smart wallets, and Solana-specific APIs are all available through a single API key.</p>
<h3>Why Hanzo Web3?</h3>
<ul><li><strong>One key, 100+ chains</strong>: No per-chain configuration or separate providers</li><li><strong>Structured data</strong>: Token balances, NFT metadata, portfolio views without indexing</li><li><strong>Push notifications</strong>: Managed webhooks for onchain events</li><li><strong>Account abstraction</strong>: ERC-4337 smart wallets with gas sponsorship</li><li><strong>Solana native</strong>: Yellowstone gRPC, DAS, and WebSocket support</li><li><strong>Part of Hanzo ecosystem</strong>: Integrates with Hanzo Chat, Commerce, Console, and MCP</li></ul>
<h2>When to use</h2>
<p>Use this skill when:</p>
<ul><li>The user wants to read or write blockchain data</li><li>The user needs token balances, NFT metadata, or transaction history</li><li>The user wants to deploy or interact with smart contracts</li><li>The user needs real-time onchain event notifications via webhooks</li><li>The user wants to set up smart wallets or account abstraction</li></ul>
<h2>Hard requirements</h2>
<ol><li><strong>API Key required.</strong> If <code>HANZO_WEB3_API_KEY</code> is not set, tell the user to get one free at https://web3.hanzo.ai/dashboard, or switch to the <code>hanzo-web3-gateway</code> skill for keyless access.</li><li><strong>Never expose the API key</strong> in user-visible output, logs, or screenshots.</li><li><strong>Rate limits apply.</strong> Free tier: 25 req/s, PAYG: 300 req/s. Respect 429 responses with exponential backoff.</li></ol>
<h2>Preflight checks</h2>
<p>Before making any request, silently verify:</p>
<ul><li><code>HANZO_WEB3_API_KEY</code> environment variable is set and non-empty</li><li>If unset, suggest: <code>export HANZO_WEB3_API_KEY=&lt;your-key&gt;</code></li></ul>
<h2>Quick reference</h2>
<p>| Item | Value | |------|-------| | Base URL | <code>https://api.web3.hanzo.ai/v1</code> | | Auth header | <code>X-API-Key: ${HANZO_WEB3_API_KEY}</code> | | Alt auth | URL path: <code>https://api.web3.hanzo.ai/v1/${HANZO_WEB3_API_KEY}/eth/mainnet</code> | | WebSocket | <code>wss://ws.web3.hanzo.ai/v1/${HANZO_WEB3_API_KEY}</code> | | Status | https://status.web3.hanzo.ai | | Docs | https://web3.hanzo.ai/docs | | Dashboard | https://web3.hanzo.ai/dashboard |</p>
<h2>Network names</h2>
<p>| Chain | Network ID | Mainnet | Testnet | |-------|-----------|---------|---------| | Ethereum | eth | <code>eth/mainnet</code> | <code>eth/sepolia</code>, <code>eth/holesky</code> | | Base | base | <code>base/mainnet</code> | <code>base/sepolia</code> | | Arbitrum | arb | <code>arb/mainnet</code> | <code>arb/sepolia</code> | | Polygon | polygon | <code>polygon/mainnet</code> | <code>polygon/amoy</code> | | Optimism | opt | <code>opt/mainnet</code> | <code>opt/sepolia</code> | | Solana | sol | <code>sol/mainnet</code> | <code>sol/devnet</code> | | Lux | lux | <code>lux/mainnet</code> | <code>lux/testnet</code> | | Avalanche | avax | <code>avax/mainnet</code> | <code>avax/fuji</code> | | BNB Chain | bsc | <code>bsc/mainnet</code> | <code>bsc/testnet</code> | | 90+ more | ... | See docs | See docs |</p>
<h2>One-file quickstart</h2>
<h3>Get latest block number (Ethereum)</h3>
<pre><code class="lang-bash">curl -X POST https://api.web3.hanzo.ai/v1/eth/mainnet \
-H &quot;Content-Type: application/json&quot; \
-H &quot;X-API-Key: ${HANZO_WEB3_API_KEY}&quot; \
-d &#x27;{&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;method&quot;:&quot;eth_blockNumber&quot;,&quot;params&quot;:[],&quot;id&quot;:1}&#x27;</code></pre>
<h3>Get token balances</h3>
<pre><code class="lang-bash">curl &quot;https://api.web3.hanzo.ai/v1/data/tokens/balances?address=0x...&amp;network=eth/mainnet&quot; \
-H &quot;X-API-Key: ${HANZO_WEB3_API_KEY}&quot;</code></pre>
<h3>Get NFT metadata</h3>
<pre><code class="lang-bash">curl &quot;https://api.web3.hanzo.ai/v1/data/nfts?owner=0x...&amp;network=eth/mainnet&quot; \
-H &quot;X-API-Key: ${HANZO_WEB3_API_KEY}&quot;</code></pre>
<h3>Create webhook</h3>
<pre><code class="lang-bash">curl -X POST https://api.web3.hanzo.ai/v1/webhooks \
-H &quot;Content-Type: application/json&quot; \
-H &quot;X-API-Key: ${HANZO_WEB3_API_KEY}&quot; \
-d &#x27;{
&quot;url&quot;: &quot;https://your-server.com/webhook&quot;,
&quot;network&quot;: &quot;eth/mainnet&quot;,
&quot;event_type&quot;: &quot;address_activity&quot;,
&quot;addresses&quot;: [&quot;0x...&quot;]
}&#x27;</code></pre>
<h3>Python (with Hanzo SDK)</h3>
<pre><code class="lang-python">from hanzo import Hanzo
client = Hanzo() # uses HANZO_WEB3_API_KEY from env
# JSON-RPC
block = client.web3.rpc(&quot;eth/mainnet&quot;, method=&quot;eth_blockNumber&quot;)
# Structured data
balances = client.web3.tokens.balances(
address=&quot;0x...&quot;,
network=&quot;eth/mainnet&quot;
)
# Webhooks
hook = client.web3.webhooks.create(
url=&quot;https://your-server.com/webhook&quot;,
network=&quot;eth/mainnet&quot;,
event_type=&quot;address_activity&quot;,
addresses=[&quot;0x...&quot;]
)</code></pre>
<h2>Endpoint selector</h2>
<p>| Task | Endpoint | Method | |------|----------|--------| | JSON-RPC call | <code>POST /v1/{network}</code> | POST | | Get token balances | <code>GET /v1/data/tokens/balances</code> | GET | | Get token prices | <code>GET /v1/data/tokens/prices</code> | GET | | Get token metadata | <code>GET /v1/data/tokens/metadata</code> | GET | | Get NFTs by owner | <code>GET /v1/data/nfts</code> | GET | | Get NFT metadata | <code>GET /v1/data/nfts/metadata</code> | GET | | Get transfers | <code>GET /v1/data/transfers</code> | GET | | Get transaction history | <code>GET /v1/data/transactions</code> | GET | | Get portfolio | <code>GET /v1/data/portfolio</code> | GET | | Create webhook | <code>POST /v1/webhooks</code> | POST | | List webhooks | <code>GET /v1/webhooks</code> | GET | | Delete webhook | <code>DELETE /v1/webhooks/{id}</code> | DELETE | | WebSocket subscribe | <code>WS /v1/{api_key}</code> | WS | | Smart wallet create | <code>POST /v1/wallets/create</code> | POST | | Smart wallet execute | <code>POST /v1/wallets/execute</code> | POST | | Gas estimate | <code>POST /v1/gas/estimate</code> | POST | | Simulate transaction | <code>POST /v1/simulate</code> | POST |</p>
<h2>Skill map</h2>
<h3>Node APIs</h3>
<p>Core JSON-RPC access for 100+ chains with load balancing and automatic failover.</p>
<p>| Endpoint | Description | |----------|-------------| | <code>POST /v1/{network}</code> | Standard JSON-RPC proxy (eth_call, eth_sendRawTransaction, etc.) | | <code>POST /v1/{network}/debug</code> | Debug namespace (debug_traceTransaction, debug_traceCall) | | <code>POST /v1/{network}/trace</code> | Trace namespace (trace_block, trace_transaction) | | <code>WS /v1/{api_key}</code> | WebSocket for subscriptions (newHeads, logs, pendingTransactions) |</p>
<h3>Data APIs</h3>
<p>Structured onchain data across tokens, NFTs, transfers, and portfolio views.</p>
<p>| Endpoint | Description | |----------|-------------| | <code>GET /v1/data/tokens/balances</code> | ERC-20 balances for any address | | <code>GET /v1/data/tokens/prices</code> | Real-time token prices (USD, ETH, BTC) | | <code>GET /v1/data/tokens/metadata</code> | Token name, symbol, decimals, logo | | <code>GET /v1/data/nfts</code> | NFTs owned by address | | <code>GET /v1/data/nfts/metadata</code> | NFT metadata, media, traits | | <code>GET /v1/data/transfers</code> | Token and NFT transfer history | | <code>GET /v1/data/transactions</code> | Full transaction history | | <code>GET /v1/data/portfolio</code> | Aggregated portfolio across chains |</p>
<h3>Solana APIs</h3>
<p>High-throughput Solana access with Yellowstone gRPC and DAS.</p>
<p>| Endpoint | Description | |----------|-------------| | <code>POST /v1/sol/mainnet</code> | Solana JSON-RPC | | <code>gRPC /v1/sol/yellowstone</code> | Yellowstone gRPC streams (accounts, transactions, blocks) | | <code>POST /v1/sol/das</code> | Digital Asset Standard API (compressed NFTs, Metaplex) | | <code>WS /v1/sol/ws</code> | Solana WebSocket subscriptions |</p>
<h3>Webhooks</h3>
<p>Push-based notifications for onchain events with managed delivery.</p>
<p>| Endpoint | Description | |----------|-------------| | <code>POST /v1/webhooks</code> | Create webhook subscription | | <code>GET /v1/webhooks</code> | List active webhooks | | <code>GET /v1/webhooks/{id}</code> | Get webhook details | | <code>DELETE /v1/webhooks/{id}</code> | Delete webhook | | <code>POST /v1/webhooks/{id}/test</code> | Send test event |</p>
<p>Supported event types: <code>address_activity</code>, <code>token_transfer</code>, <code>nft_transfer</code>, <code>new_block</code>, <code>contract_event</code>, <code>pending_transaction</code>.</p>
<h3>Smart Wallets</h3>
<p>ERC-4337 account abstraction with gas sponsorship and social login.</p>
<p>| Endpoint | Description | |----------|-------------| | <code>POST /v1/wallets/create</code> | Create smart wallet | | <code>POST /v1/wallets/execute</code> | Execute user operation | | <code>POST /v1/wallets/batch</code> | Batch multiple operations | | <code>POST /v1/gas/estimate</code> | Estimate gas for user operation | | <code>POST /v1/gas/sponsor</code> | Sponsor gas for user |</p>
<h3>Recipes</h3>
<p>Practical integration patterns.</p>
<p>| Recipe | Description | |--------|-------------| | Token swap monitoring | Watch DEX swaps and notify on price impact | | NFT mint tracker | Alert when new NFTs are minted in a collection | | Wallet portfolio | Build multi-chain portfolio dashboard | | Transaction relay | Submit and track transactions with retry logic | | Airdrop checker | Check eligibility across protocols |</p>
<h2>MCP Integration</h2>
<p>Expose Hanzo Web3 as MCP tools for agentic workflows:</p>
<pre><code class="lang-typescript">import { MCPServer, Tool } from &#x27;@hanzo/mcp&#x27;
const web3Tools: Tool[] = [
{
name: &#x27;web3_rpc&#x27;,
description: &#x27;Execute JSON-RPC call on any supported chain&#x27;,
parameters: {
network: { type: &#x27;string&#x27;, required: true },
method: { type: &#x27;string&#x27;, required: true },
params: { type: &#x27;array&#x27;, default: [] }
},
async execute({ network, method, params }) {
const res = await fetch(`https://api.web3.hanzo.ai/v1/${network}`, {
method: &#x27;POST&#x27;,
headers: {
&#x27;Content-Type&#x27;: &#x27;application/json&#x27;,
&#x27;X-API-Key&#x27;: process.env.HANZO_WEB3_API_KEY
},
body: JSON.stringify({ jsonrpc: &#x27;2.0&#x27;, method, params, id: 1 })
})
return await res.json()
}
},
{
name: &#x27;web3_token_balances&#x27;,
description: &#x27;Get token balances for an address&#x27;,
parameters: {
address: { type: &#x27;string&#x27;, required: true },
network: { type: &#x27;string&#x27;, default: &#x27;eth/mainnet&#x27; }
},
async execute({ address, network }) {
const res = await fetch(
`https://api.web3.hanzo.ai/v1/data/tokens/balances?address=${address}&amp;network=${network}`,
{ headers: { &#x27;X-API-Key&#x27;: process.env.HANZO_WEB3_API_KEY } }
)
return await res.json()
}
}
]</code></pre>
<h2>Error handling</h2>
<p>| Code | Meaning | Action | |------|---------|--------| | 200 | Success | Process response | | 400 | Bad request | Check parameters | | 401 | Unauthorized | Check API key | | 429 | Rate limited | Exponential backoff (1s, 2s, 4s, 8s, max 30s) | | 500 | Server error | Retry up to 3 times | | 502/503 | Upstream error | Retry with different endpoint |</p>
<h2>Official links</h2>
<ul><li>Dashboard: https://web3.hanzo.ai/dashboard</li><li>Documentation: https://web3.hanzo.ai/docs</li><li>API Reference: https://web3.hanzo.ai/docs/api</li><li>Status: https://status.web3.hanzo.ai</li><li>Hanzo AI: https://hanzo.ai</li><li>Hanzo Bot: https://hanzo.bot</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2026-02-26 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: blockchain, web3, infrastructure <strong>Prerequisites</strong>: HTTP/curl, blockchain basics</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hanzo-web3.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>