agentwallet-sdk v5.1.0: The Complete Agent Identity Stack

#ai #typescript #web3 #agents

This article was written with AI assistance.

AI agents are getting serious. They're executing tasks, managing resources, transacting on-chain, and interacting with other agents autonomously. But there's been a persistent gap: agents need way more than just a wallet to operate at production scale.

agentwallet-sdk@5.1.0 ships a complete agent identity stack. One npm install. Five foundational capabilities.

One line pitch: "One npm install now gives any AI agent a wallet, email address, on-chain ID, reputation, and signed payment intents."

Quick Start

npm install agentwallet-sdk viem

import { createWallet, ERC8004Client, EmailResolver } from 'agentwallet-sdk';

const wallet = createWallet({ chain: 'base', walletClient });
const identity = new ERC8004Client({ chain: 'base' });
const { agentId } = await identity.registerAgent(walletClient, { name: 'MyAgent' });
const resolver = new EmailResolver();
await resolver.linkWallet('myagent@agentmail.to', wallet.address);

Five lines. Wallet + identity + email.

The 5 Components

1. EmailResolver (NEW in v5.1.0)

AgentMail integration gives agents a real email@agentmail.to address cryptographically linked to their wallet. Resolve email to wallet address, send and receive with embedded x402 payment requests.

import { EmailResolver } from 'agentwallet-sdk';

const resolver = new EmailResolver();
const wallet = await resolver.resolveEmail('vendor@agentmail.to');
console.log(wallet.address); // 0x...

await resolver.sendWithPayment({
  to: 'vendor@agentmail.to',
  subject: 'Payment for API access',
  amount: 5_000_000n, // 5 USDC
  token: 'USDC',
  chain: 'base',
});

2. AgentIdentity (ERC-8004 + ERC-6551)

On-chain NFT identity via ERC-8004 Identity Registry with ERC-6551 Token Bound Account. Portable, censorship-resistant, auditable.

import { ERC8004Client } from 'agentwallet-sdk';

const identity = new ERC8004Client({ chain: 'base' });
const { txHash, agentId } = await identity.registerAgent(walletClient, {
  name: 'TradingAgent-v2',
  description: 'Autonomous DeFi execution agent',
});

3. ReputationClient

On-chain reputation scoring. Scored feedback from clients, aggregated summaries, revocable.

import { ReputationClient } from 'agentwallet-sdk';

const reputation = new ReputationClient({ chain: 'base' });
await reputation.giveFeedback(walletClient, {
  agentId: 42n,
  score: 95n,
  category: 1,
  comment: 'Fast, accurate, no hallucinations',
  taskRef: 'task-abc-123',
  verifierRef: '', clientRef: '', contentHash: '0x000...000',
});

const rep = await reputation.getAgentReputation(42n);
console.log(`Score: ${rep.totalScore} from ${rep.count} reviews`);

4. VerifiableIntentClient

Mastercard-spec signed payment intents with scope enforcement. Agents commit to a payment cryptographically. Vendors verify without requiring execution upfront.

import { VerifiableIntentClient } from 'agentwallet-sdk';

const intents = new VerifiableIntentClient({ chain: 'base', walletClient });
const intent = await intents.createIntent({
  recipient: '0xVendorAddress',
  token: 'USDC',
  maxAmount: 50_000_000n,
  scope: 'data-api-access',
  expiresAt: BigInt(Math.floor(Date.now() / 1000) + 3600),
});

5. ValidationClient

Request/respond validation workflow for TEE attestations, compliance proofs, and capability certifications, all written on-chain.

import { ValidationClient } from 'agentwallet-sdk';
import { keccak256, toBytes } from 'viem';

const validation = new ValidationClient({ chain: 'base', validationAddress: '0x...' });
const requestHash = keccak256(toBytes('compliance-check-v1'));
await validation.requestValidation(walletClient, {
  validator: '0xComplianceOracle',
  agentId: 42n,
  requestURI: 'https://example.com/compliance-spec.json',
  requestHash,
});