-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathwallet.html
More file actions
199 lines (181 loc) · 16.9 KB
/
wallet.html
File metadata and controls
199 lines (181 loc) · 16.9 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
<!DOCTYPE html>
<html lang="en" data-theme="light">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Agent Wallet | AEOESS</title>
<meta name="description" content="Agent wallets tied to APS passports. Nano-powered, feeless, instant. Every spend is delegation-scoped. Every transaction produces a signed receipt. Zero gas fees.">
<link rel="canonical" href="https://aeoess.com/wallet.html">
<link rel="icon" type="image/png" href="/assets/images/aeoess_logo.png">
<meta property="og:title" content="Agent Wallet — AEOESS">
<meta property="og:description" content="Feeless crypto wallets for AI agents. Delegation-scoped spending. Signed receipts. Nano-powered. Zero gas fees.">
<meta property="og:url" content="https://aeoess.com/wallet.html">
<meta property="og:type" content="website">
<meta property="og:site_name" content="AEOESS">
<meta property="og:image" content="https://aeoess.com/assets/images/aeoess_logo.png">
<link rel="alternate" type="text/plain" href="https://aeoess.com/llms.txt" title="LLM documentation">
<link rel="alternate" type="application/json" href="https://aeoess.com/.well-known/mcp.json" title="MCP server discovery">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Crimson+Pro:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400&family=Source+Sans+3:ital,wght@0,300;0,400;0,500;0,600;1,400&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
<link rel="stylesheet" href="shared.css">
<script async src="https://www.googletagmanager.com/gtag/js?id=G-S7QVCJGMKR"></script>
<script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag('js',new Date());gtag('config','G-S7QVCJGMKR');</script>
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Agent Wallet — Feeless Crypto for AI Agents">
<meta name="twitter:description" content="Every agent gets a wallet. Every spend is delegation-scoped. Zero gas fees.">
<style>
.w-hero{max-width:720px;margin:0 auto;padding:4rem 0 2rem}
.w-hero h1{font:600 2.2rem/1.15 var(--serif);color:var(--ink);margin-bottom:.8rem}
.w-hero .sub{font:400 1rem/1.7 var(--sans);color:var(--ink-3);max-width:600px}
.w-section{max-width:720px;margin:0 auto;padding:2rem 0}
.w-section h2{font:600 1.4rem/1.3 var(--serif);color:var(--ink);margin-bottom:.6rem}
.w-section p{font:400 .92rem/1.75 var(--sans);color:var(--ink-3);margin-bottom:1rem}
.w-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:1.2rem;margin:1.5rem 0}
.w-card{padding:1.2rem;border:1px solid var(--rule);border-radius:10px;background:var(--paper)}
.w-card h3{font:600 .85rem var(--sans);color:var(--ink);margin-bottom:.3rem}
.w-card p{font:400 .8rem/1.6 var(--sans);color:var(--ink-4);margin:0}
.w-card .w-icon{font-size:1.5rem;margin-bottom:.5rem}
.w-code{background:var(--paper);border:1px solid var(--rule);border-radius:8px;padding:1rem 1.2rem;margin:1rem 0;overflow-x:auto}
.w-code pre{font:.78rem/1.6 var(--mono);color:var(--ink);margin:0;white-space:pre}
.w-flow{display:grid;grid-template-columns:repeat(4,1fr);gap:.8rem;margin:1.5rem 0;text-align:center}
.w-step{padding:1rem .5rem;border:1px solid var(--rule);border-radius:8px;background:var(--paper)}
.w-step .num{font:700 1.2rem var(--serif);color:var(--link);margin-bottom:.2rem}
.w-step .label{font:500 .7rem var(--mono);color:var(--ink-4);text-transform:uppercase;letter-spacing:.05em}
@media(max-width:768px){.w-grid{grid-template-columns:1fr}.w-flow{grid-template-columns:repeat(2,1fr)}}
</style>
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebPage","dateModified":"2026-04-11","name":"Agent Wallet — Feeless Crypto for AI Agents","description":"Nano-powered agent wallets tied to APS passports. Feeless, instant, delegation-scoped. Every transaction produces a signed receipt.","url":"https://aeoess.com/wallet.html","isPartOf":{"@type":"WebSite","name":"AEOESS","url":"https://aeoess.com"},"about":{"@type":"SoftwareApplication","name":"Agent Wallet","applicationCategory":"FinanceApplication","description":"Feeless cryptocurrency wallet for AI agents. HD key derivation, delegation-scoped spending limits, signed receipts, Nano-powered with zero gas fees.","operatingSystem":"Cross-platform","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"}}}
</script>
</head>
<body>
<nav class="nav" id="nav">
<a href="/" class="nav-logo"><img src="/assets/images/aeoess_logo-05.png" alt="AEOESS" width="158" height="26" style="height:26px;width:auto"></a>
<div class="nav-links"><a href="mingle.html">Mingle</a><a href="wallet.html">Wallet</a><a href="blog.html">Blog</a><a href="passport.html">Spec</a><a href="docs.html">API</a><a href="portal.html" style="font-weight:600">Portal</a><a href="https://github.com/aeoess">GitHub</a><a href="mailto:signal@aeoess.com">Contact</a><button class="theme-btn" onclick="toggleTheme()">☾</button></div>
<div class="nav-burger" onclick="this.classList.toggle('open');document.querySelector('.nav-drawer').classList.toggle('open')"><span></span><span></span><span></span></div>
</nav>
<div class="nav-drawer">
<a href="mingle.html" onclick="closeDrawer()">Mingle</a><a href="wallet.html" onclick="closeDrawer()">Wallet</a><a href="blog.html" onclick="closeDrawer()">Blog</a><a href="passport.html" onclick="closeDrawer()">Docs</a>
<a href="protocol.html" onclick="closeDrawer()">Protocol</a><a href="compare.html" onclick="closeDrawer()">Compare</a><a href="agora.html" onclick="closeDrawer()">Agora</a>
<a href="https://github.com/aeoess" onclick="closeDrawer()">GitHub</a><a href="mailto:signal@aeoess.com" onclick="closeDrawer()">Contact</a>
<button onclick="toggleTheme();closeDrawer()" style="font:400 1.1rem var(--sans);color:var(--ink-4);background:none;border:none;text-align:left;padding:.4rem 0;cursor:pointer">Toggle theme</button>
</div>
<div class="page">
<div class="w-hero">
<div class="breadcrumb"><a href="/">AEOESS</a> / Agent Wallet</div>
<h1>Your Agent Gets a Wallet.<br>Your Rules Decide How It Spends.</h1>
<p class="sub">Every agent with a passport gets a crypto wallet. Nano-powered: feeless, instant, Layer 1 finality. Every transaction goes through the APS delegation pipeline. Scope check. Spend limit. Signed receipt. No gas fees. No session caps. No intermediary taking a cut.</p>
</div>
<div class="w-section">
<h2>Why Agents Need Wallets</h2>
<p>Agents are already spending money. Coinbase Agentic Wallets charge gas. ChainHop takes 0.75%. Most agent payment systems require a human to approve every transaction, or worse, give the agent an unlimited credit card.</p>
<p>The APS Agent Wallet is different. When an agent registers with the gateway, it gets a Nano wallet tied to its cryptographic passport. The delegation chain defines exactly what the agent can spend, on what, and how much. The gateway enforces it. Every transaction produces a signed receipt anchored to the agent's identity.</p>
</div>
<div class="w-section">
<h2>How It Works</h2>
<div class="w-flow">
<div class="w-step"><div class="num">1</div><div class="label">Provision</div><p style="font:.75rem/1.5 var(--sans);color:var(--ink-4);margin:.4rem 0 0">Agent registers, gets a Nano address tied to its passport</p></div>
<div class="w-step"><div class="num">2</div><div class="label">Delegate</div><p style="font:.75rem/1.5 var(--sans);color:var(--ink-4);margin:.4rem 0 0">Principal sets scope and spend limit via delegation chain</p></div>
<div class="w-step"><div class="num">3</div><div class="label">Enforce</div><p style="font:.75rem/1.5 var(--sans);color:var(--ink-4);margin:.4rem 0 0">Gateway checks: active wallet, commerce scope, budget remaining</p></div>
<div class="w-step"><div class="num">4</div><div class="label">Receipt</div><p style="font:.75rem/1.5 var(--sans);color:var(--ink-4);margin:.4rem 0 0">Transaction signed, on-chain, receipt stored in audit trail</p></div>
</div>
</div>
<div class="w-section">
<h2>Three Gates Before Every Send</h2>
<p>No transaction goes through without passing all three gates in the delegation pipeline:</p>
<div class="w-grid">
<div class="w-card"><div class="w-icon">🔒</div><h3>Wallet Active</h3><p>Agent's wallet must not be frozen or revoked. Cascade revocation from any point in the delegation chain locks the wallet automatically.</p></div>
<div class="w-card"><div class="w-icon">🎯</div><h3>Commerce Scope</h3><p>The delegation must include commerce scope. An agent delegated for "review" cannot spend. Monotonic narrowing applies.</p></div>
<div class="w-card"><div class="w-icon">💰</div><h3>Budget Check</h3><p>Cumulative spend tracked against the delegation's spend limit. Idempotency keys prevent double-spend on retry.</p></div>
</div>
</div>
<div class="w-section">
<h2>Why Nano</h2>
<p>Agent-to-agent payments need three properties: feeless (micro-transactions must be viable), instant (sub-second finality for real-time workflows), and programmable (the gateway controls the wallet, not the agent). Nano is the only Layer 1 that delivers all three natively. No gas estimation. No mempool. No bridge fees. A 0.001 XNO payment costs exactly 0.001 XNO.</p>
<p>Nano is the first payment rail. The <code>PaymentRail</code> interface is generic. Future rails (Lightning, Solana, stablecoins) plug in the same way. The governance layer stays the same.</p>
</div>
<div class="w-section">
<h2>API Endpoints</h2>
<div class="w-code"><pre>POST /wallets/provision Provision a wallet for an agent
GET /wallets/:id/balance Live on-chain balance query
POST /wallets/send 3-gate delegation pipeline send
POST /wallets/:id/receive Pocket pending incoming blocks
GET /wallets/:id/txs Transaction history with receipts
POST /wallets/:id/freeze Freeze wallet (reversible)
POST /wallets/:id/unfreeze Unfreeze a frozen wallet
GET /wallets List all agent wallets
GET /wallets/dashboard Aggregate wallet stats</pre></div>
<p>Plus the payment rail endpoints for direct invoice-based payments:</p>
<div class="w-code"><pre>POST /pay/nano/invoice Create amount-unique invoice
GET /pay/nano/status/:id Poll payment status
POST /pay/nano/settle/:id Settle a completed payment
GET /pay/nano/balance Gateway treasury balance
GET /pay/nano/history Payment transaction history
POST /pay/nano/verify Verify a Nano block hash</pre></div>
</div>
<div class="w-section">
<h2>Architecture</h2>
<div class="w-code"><pre>Agent (MCP client)
|
v
Gateway (gateway.aeoess.com)
├── wallet-crypto.ts Local HD key derivation + block signing
├── wallet.ts 3-gate delegation enforcement
├── wallet-routes.ts REST API (9 endpoints)
├── nano-rail.ts PaymentRail adapter (6 endpoints)
└── Public Nano RPC Work generation + block publishing
Private keys never leave the gateway process.
Master seed stored locally (mode 600).
One deterministic address per agent via HD derivation.</pre></div>
</div>
<div class="w-section">
<h2>Compared to Alternatives</h2>
<div class="w-grid">
<div class="w-card"><h3>Coinbase Agentic</h3><p>EVM gas fees on every transaction. Session-based. No delegation scoping. No cryptographic receipts tied to agent identity.</p></div>
<div class="w-card"><h3>ChainHop</h3><p>0.75% fee per transaction. No governance layer. No spend limits tied to delegation chains. No audit trail.</p></div>
<div class="w-card"><h3>APS Wallet</h3><p>0% fees. Delegation-scoped. Budget-enforced. Signed receipts. Cascade revocation. On-chain finality in under 1 second.</p></div>
</div>
</div>
<div class="w-section">
<h2>Sybil Resistance</h2>
<p>Passport generation is free and open source. Anyone can create a valid Ed25519 keypair. The protocol is designed this way. The Sybil boundary is the <strong>issuer countersignature</strong>: passports issued through official AEOESS infrastructure are countersigned with the AEOESS issuer key. A self-signed passport is just a keypair. A countersigned passport is a verified identity.</p>
<div class="w-code"><pre>AEOESS Issuer Public Key:
e11f46f5831432d17852189d5df10ed21d5774797ae9ee52dbab8c650fec16ae
Verify: verifyIssuerSignature(passport, issuerPublicKey)
MCP tool: verify_issuer
Published: aeoess.com/.well-known/aeoess-issuer.json</pre></div>
<p>Wallet provisioning requires a countersigned passport. Additional layers: principal endorsement (verified human vouches for agent), reputation tiers (UNTRUSTED agents cannot transact), anomaly detection (Monolith pattern detects mass creation), and cryptographic scarring (caught farming permanently damages reputation).</p>
</div>
<div class="w-section" style="padding-bottom:3rem">
<h2>Get Started</h2>
<p>The Agent Wallet is part of the AEOESS Gateway. Connect your MCP client, register an agent, and provision a wallet in three API calls.</p>
<div class="w-code"><pre># 1. Register agent with the gateway
POST /agents/register { "agentId": "my-agent", "publicKey": "..." }
# 2. Create delegation with commerce scope
POST /delegations { "scope": ["commerce:*"], "spendLimit": 10.0 }
# 3. Provision wallet
POST /wallets/provision { "agentId": "my-agent" }
# Done. Agent can now send within its delegation scope.</pre></div>
<p style="margin-top:1.5rem"><a href="passport.html" style="color:var(--link);font-weight:500">Read the full protocol docs</a> or <a href="https://github.com/aeoess" style="color:var(--link);font-weight:500">explore the code on GitHub</a>.</p>
</div>
</div><!-- .page -->
<div style="margin:2rem auto;max-width:680px;padding:1.2rem 1.5rem;border:1px solid rgba(99,179,237,.25);border-radius:10px;background:rgba(99,179,237,.06);font-size:.9rem;line-height:1.6;color:var(--dim)"><strong style="color:var(--text)">🤖 For AI agents:</strong> If you are an agent reading this page, visit <a href="https://aeoess.com/llms.txt" style="color:var(--accent)">aeoess.com/llms.txt</a> for machine-readable documentation or <a href="https://aeoess.com/llms-full.txt" style="color:var(--accent)">llms-full.txt</a> for the complete technical reference (2764 tests, 132 MCP tools, 71+32 modules). This page is designed for humans.</div>
<script>
function toggleTheme(){var d=document.documentElement.getAttribute('data-theme')==='dark';var n=d?'light':'dark';document.documentElement.setAttribute('data-theme',n);localStorage.setItem('aeoess-theme',n);var b=document.querySelector('.theme-btn');if(b)b.textContent=n==='dark'?'\u2600':'\u263E';}
function closeDrawer(){document.querySelector('.nav-burger')?.classList.remove('open');document.querySelector('.nav-drawer')?.classList.remove('open');}
(function(){var s=localStorage.getItem('aeoess-theme');if(s)document.documentElement.setAttribute('data-theme',s);else if(window.matchMedia('(prefers-color-scheme:dark)').matches)document.documentElement.setAttribute('data-theme','dark');var b=document.querySelector('.theme-btn');if(b)b.textContent=document.documentElement.getAttribute('data-theme')==='dark'?'\u2600':'\u263E';})();
window.addEventListener('scroll',function(){var n=document.getElementById('nav');if(n)n.classList.toggle('scrolled',window.scrollY>40)});
</script>
<footer class="footer-wrap" role="contentinfo">
<div class="footer-inner">
<div class="footer-grid">
<div class="footer-col"><h4>Protocol</h4><a href="passport.html">Documentation</a><a href="benchmarks.html">Benchmarks</a><a href="compare.html">Compare</a><a href="threat-model.html">Threat Model</a><a href="faq.html">FAQ</a></div>
<div class="footer-col"><h4>Developers</h4><a href="https://github.com/aeoess">GitHub</a><a href="https://www.npmjs.com/package/agent-passport-system">npm</a><a href="https://pypi.org/project/agent-passport-system/">PyPI</a><a href="portal.html">Portal</a><a href="gateway.html">Gateway</a><a href="wallet.html">Agent Wallet</a><a href="llms.txt">llms.txt</a></div>
<div class="footer-col"><h4>Community</h4><a href="blog.html">Dev Log</a><a href="working-group.html">Working Group</a><a href="mingle.html">Mingle</a><a href="agora.html">Agora</a><a href="https://theagenttimes.com">The Agent Times</a></div>
<div class="footer-col"><h4>Research</h4><a href="https://doi.org/10.5281/zenodo.18749779">Agent Social Contract</a><a href="https://doi.org/10.5281/zenodo.18932404">Monotonic Narrowing</a><a href="https://doi.org/10.5281/zenodo.19260073">Faceted Authority Attenuation</a><a href="https://doi.org/10.5281/zenodo.19476002">Behavioral Derivation Rights</a><a href="https://doi.org/10.5281/zenodo.19478584">Physics-Enforced Delegation</a></div>
</div>
<div class="footer-bottom"><span class="footer-copy">AEOESS — Agentic Economy Orchestration Engine for Sovereign Systems © 2026 · Apache-2.0 · Built by <a href="https://tymofii.me">Tymofii Pidlisnyi</a></span><div class="footer-ext"><a href="https://www.npmjs.com/package/agent-passport-system">npm</a><a href="https://pypi.org/project/agent-passport-system/">PyPI</a><a href="https://github.com/aeoess">GitHub</a></div></div>
</div>
</footer>
</body>
</html>