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|ENS|wallet>Verify one global ID or all registrations owned by ENS/walletlookup <address|ENS>Find ERC-8004 registrations for an ownerprobe <globalId>Probe an agent's capabilities and endpointschainsList all 22 supported EVM chainscount [chainId]Count registered agents with chunked log scansinitScaffold 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

🔍 Verifying agent identity

   Chain:    Base (8453)
   Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
   Agent ID: #2376

   ✓ Verified on-chain
   Owner: 0x1be93C700dDC596D701E8F2106B8F9166C625Adb
   URI:   https://arcabot.ai/agent-metadata.json
   Pay:   0x1be93C700dDC596D701E8F2106B8F9166C625Adb
   Name:  Arca
   ✓ Metadata back-reference present

   Services:
   → web: https://arcabot.ai
   → A2A: https://arcabot.ai/.well-known/agent-card.json
   → a3stack: https://a3stack.arcabot.ai
   → clawfix: https://clawfix.dev

The next CLI release also accepts ENS names or wallet addresses. It resolves ENS, then scans supported chains using chunked logs and RPC fallbacks.

terminal

bash

$# after a3stack@0.1.1 is published\nnpx a3stack verify arcabot.eth

text

$ # next CLI release / source build
$ npx a3stack verify arcabot.eth

🔍 Verifying agent identity

   ✓ Resolved arcabot.eth → 0x1be93C700dDC596D701E8F2106B8F9166C625Adb

   ✓ Found EVM registration(s):

   ✓ Ethereum        #22775  eip155:1:0x8004...#22775
   ✓ Optimism        #0      eip155:10:0x8004...#0
   ✓ Base            #2376   eip155:8453:0x8004...#2376
   ✓ Scroll          #1      eip155:534352:0x8004...#1
   … more chains when their public RPCs respond

   Name: Arca

lookup

Find ERC-8004 registrations for a wallet or ENS name. Use A3STACK_CHAIN_IDS to keep public-RPC scans bounded.

terminal

bash

$A3STACK_CHAIN_IDS=1,10,8453,534352 npx a3stack lookup arcabot.eth

text

$ A3STACK_CHAIN_IDS=1,10,8453,534352 npx a3stack lookup 0x1be93C700dDC596D701E8F2106B8F9166C625Adb

🌐 Scanning all chains for 0x1be93C700dDC596D701E8F2106B8F9166C625Adb

   Found 4 registration(s):

   ✓ Ethereum        #22775  eip155:1:0x8004...#22775
   ✓ Optimism        #0      eip155:10:0x8004...#0
   ✓ Base            #2376   eip155:8453:0x8004...#2376
   ✓ Scroll          #1      eip155:534352:0x8004...#1

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 eip155:8453:0x8004...#2376

   ✓ Identity verified on Base
   Owner: 0x1be93C700dDC596D701E8F2106B8F9166C625Adb
   URI:   https://arcabot.ai/agent-metadata.json
   Pay to: 0x1be93C700dDC596D701E8F2106B8F9166C625Adb
   Name:   Arca
   Active: yes

   Endpoints:
   → web      https://arcabot.ai
   → A2A      https://arcabot.ai/.well-known/agent-card.json
   → github   https://github.com/arcabotai

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

Count registered agents by scanning mint logs. Public RPCs may rate-limit wide scans; the CLI chunks ranges and reports degraded chains honestly.

terminal

bash

$npx a3stack count 8453

text

$ npx a3stack count 8453

📊 Agent count (chunked Transfer-event scan)

   Base              2,376 agents

init

The scaffold command is reserved for the next CLI release. For now, install the packages directly.

terminal

bash

$npx a3stack init

text

$ npx a3stack init

🚀 Scaffold a new A3Stack agent

Coming in v0.2.0 — for now, install the packages directly:

   npm install @a3stack/core viem

Docs: https://a3stack.arcabot.ai

Installing globally

You can also install the CLI globally for convenience:

terminal

bash

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