npx a3stack

CLI

The npx a3stack CLI for verifying agents, exploring the registry, and scaffolding new projects — no wallet needed for most commands.

Overview

The a3stack CLI ships as part of the a3stack npm package. Most commands are read-only and require no wallet or private key.

terminal

bash

$npx a3stack --help

verify <globalId>Verify an agent's on-chain identitylookup <address>Find all agents registered by a walletprobe <globalId>Probe an agent's capabilities and endpointschainsList all 22 supported EVM chainscountShow total registered agents on BaseinitScaffold a new A3Stack project

verify

Verify any agent's identity. Reads from the ERC-8004 registry, fetches the registration file, and validates the back-reference. No wallet needed.

terminal

bash

$npx a3stack verify eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

text

$ npx a3stack verify eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

🔍 A3Stack — Identity Verifier

   Agent ID: eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

   Chain:    8453 (eip155)
   Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
   Token ID: 2376

📡 Querying on-chain...

   ✅ Identity verified!
   Owner:          0x1be93C...
   Payment wallet: (defaults to owner)

   📋 Registration File:
   Name:        Arca
   Description: AI agent infrastructure. Built by arcabot.ai.
   Active:      true
   x402 Pay:    true

   🔌 Services:
   - MCP: https://mcp.arcabot.ai/mcp (v2025-06-18)
   - web: https://arcabot.ai

   🌐 Cross-chain registrations:
   - eip155:1:0x8004...#88
   - eip155:42161:0x8004...#16
   [... 14 more chains]

   🔗 Endpoints:
   MCP: https://mcp.arcabot.ai/mcp
   A2A: (not configured)

lookup

Find all ERC-8004 registrations for a wallet address on Base.

terminal

bash

$npx a3stack lookup 0x1be93C...

text

$ npx a3stack lookup 0x1be93C...

🔍 Looking up agents for 0x1be93C... on Base...

   Found 1 agent:
   - #2376: Arca (active, x402 support)
     Global ID: eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

probe

Probe an agent — combines identity verification with endpoint resolution. Shows what tools are available and whether the agent accepts payments.

terminal

bash

$npx a3stack probe eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

text

$ npx a3stack probe eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#2376

🔭 Probing agent...

   Verified:        ✅
   Owner:           0x1be93C...
   MCP endpoint:    https://mcp.arcabot.ai/mcp
   Accepts payment: ✅
   
   Services:
   - MCP: https://mcp.arcabot.ai/mcp
   - web: https://arcabot.ai
   
   Cross-chain registrations: 23 chains (22 EVM + Solana)

chains

List all chains where the ERC-8004 registry is deployed.

terminal

bash

$npx a3stack chains

text

$ npx a3stack chains

   Supported ERC-8004 EVM chains
   
   Chain ID     Name            
   ───────────  ────────────────
   1            Ethereum        
   10           Optimism        
   56           BNB Chain       
   100          Gnosis          
   137          Polygon         
   143          Monad           
   196          X Layer         
   360          Shape           
   1088         Metis           
   1776         Injective EVM   
   2345         GOAT Network    
   2741         Abstract        
   4326         MegaETH         
   5000         Mantle          
   8453         Base            
   42161        Arbitrum        
   42220        Celo            
   43114        Avalanche       
   59144        Linea           
   167000       Taiko           
   534352       Scroll          
   1187947933   SKALE Base      

   22 chains — same registry address on all.

count

Show the current total of registered agents on Base.

terminal

bash

$npx a3stack count

text

$ npx a3stack count

   ERC-8004 Registry on Base
   Total registered agents: 2,381

init

Scaffold a new A3Stack project with TypeScript, example agent, and package.json.

terminal

bash

$npx a3stack init

text

$ npx a3stack init

🚀 A3Stack Project Setup

? Project name: my-agent
? Use TypeScript? Yes
? Install dependencies? Yes

✅ Created my-agent/
   ├── agent.ts
   ├── package.json
   └── tsconfig.json

Next steps:
  cd my-agent
  npm install
  PRIVATE_KEY=0x... npx tsx agent.ts

Installing globally

You can also install the CLI globally for convenience:

terminal

bash

$npm install -g a3stack
$a3stack verify eip155:8453:0x8004...#2376