Add indexer endpoints

Author: yigiterdev

README.md

@@ -1,6 +1,6 @@
 # Sequence Builder CLI
 
-CLI for Sequence Builder - designed for AI agents and automation. Create wallets, authenticate, manage projects, and send transactions from the command line.
+CLI for Sequence Builder - designed for AI agents and automation. Create wallets, authenticate, manage projects, query blockchain data, and send transactions from the command line.
 
 ## Quick Start
 
@@ -21,22 +21,22 @@ sequence-builder --help
 
 ```bash
 # 1. Generate a wallet
-npx @0xsequence/builder-cli create-wallet
+npx @0xsequence/builder-cli create-wallet --json
 
 # 2. Store the private key securely (shown in output)
 
-# 3. Fund the wallet with native token for gas fees
-
-# 4. Login with your private key
+# 3. Login with your private key
 npx @0xsequence/builder-cli login -k <your-private-key>
 
-# 5. Create a project
+# 4. Create a project and get your access key
 npx @0xsequence/builder-cli projects create "My Project"
 
-# 6. Get your API keys
-npx @0xsequence/builder-cli apikeys <project-id>
+# 5. Get your Sequence wallet address (where to send tokens)
+npx @0xsequence/builder-cli wallet-info -k <private-key> -a <access-key>
+
+# 6. Fund the Sequence wallet with tokens
 
-# 7. Send an ERC20 transfer
+# 7. Send an ERC20 transfer (gas paid with same token!)
 npx @0xsequence/builder-cli transfer \
   -k <private-key> \
   -a <access-key> \
@@ -48,16 +48,36 @@ npx @0xsequence/builder-cli transfer \
 
 ## Commands
 
-| Command                        | Description                                                      |
-| ------------------------------ | ---------------------------------------------------------------- |
-| `create-wallet`                | Generate new EOA keypair, display private key and wallet address |
-| `login -k <key>`               | Authenticate with private key, get JWT                           |
-| `projects`                     | List all projects                                                |
-| `projects create [name]`       | Create new project                                               |
-| `projects get <id>`            | Get project details                                              |
-| `apikeys <project-id>`         | List API keys                                                    |
-| `apikeys default <project-id>` | Get default API key                                              |
-| `transfer`                     | Send ERC20 transfer                                              |
+| Command | Description |
+|---------|-------------|
+| `create-wallet` | Generate new EOA keypair |
+| `wallet-info` | Show EOA and Sequence wallet addresses |
+| `login -k <key>` | Authenticate with private key |
+| `projects` | List all projects |
+| `projects create [name]` | Create new project |
+| `projects get <id>` | Get project details |
+| `apikeys <project-id>` | List API keys |
+| `apikeys default <project-id>` | Get default API key |
+| `transfer` | Send ERC20 transfer via Sequence wallet |
+| `indexer balances <address>` | Get token balances |
+| `indexer native-balance <address>` | Get native token balance |
+| `indexer history <address>` | Get transaction history |
+| `indexer token-info <contract>` | Get token contract info |
+
+## Understanding Wallet Addresses
+
+This CLI uses **Sequence Smart Wallets** for transfers. When you create a wallet, you get:
+
+- **EOA Address**: The standard Ethereum address derived from your private key (used for login/project ownership)
+- **Sequence Wallet Address**: A smart contract wallet that enables gas-free transactions (used for transfers)
+
+Use `wallet-info` to see both addresses:
+
+```bash
+npx @0xsequence/builder-cli wallet-info -k <private-key> -a <access-key>
+```
+
+**Important**: Send tokens to the **Sequence Wallet Address** for use with the `transfer` command. The Sequence wallet can pay gas fees with ERC20 tokens (no native token needed!).
 
 ## Create Wallet
 
@@ -76,10 +96,27 @@ Private Key: 0x4c0883a69102937d6231471b5dbb6204fe512961708279f9f4e7d1b3e6d1e3a1
 Address:     0x89D9F8f31817BAdb5D718CD6fb483b71DbD2dfeD
 
 IMPORTANT: Store these credentials securely. They will not be shown again.
+```
+
+## Wallet Info
+
+Show both EOA and Sequence wallet addresses:
+
+```bash
+npx @0xsequence/builder-cli wallet-info -k <private-key> -a <access-key>
+```
+
+Output:
 
-To use this wallet:
-  1. Fund it with native token for gas fees
-  2. Run: sequence-builder login -k <your-private-key>
+```
+Wallet Addresses:
+
+EOA Address:           0x742BDb3bEEB7aDCe50294665a7388ADB7519a6eA
+Sequence Wallet:       0xA715064b5601Aebf197aC84A469b72Bb7Dc6A646
+
+Important:
+  Send tokens to the Sequence Wallet address for use with the transfer command.
+  The Sequence Wallet can pay gas fees with ERC20 tokens (no ETH needed).
 ```
 
 ## Login
@@ -113,6 +150,7 @@ npx @0xsequence/builder-cli projects create "My Game"
 Options:
 
 - `--chain-ids <ids>` - Comma-separated list of chain IDs
+- `-k, --private-key <key>` - Show Sequence wallet address in output
 
 ### Get Project Details
 
@@ -136,16 +174,16 @@ npx @0xsequence/builder-cli apikeys default 12345
 
 ## Transfer (ERC20)
 
-Send an ERC20 token transfer:
+Send an ERC20 token transfer using Sequence smart wallet:
 
 ```bash
 npx @0xsequence/builder-cli transfer \
   -k 0x4c0883a... \
   -a AQAAAAAAAABnD... \
-  -t 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 \
+  -t 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
   -r 0x1234567890123456789012345678901234567890 \
   -m 10.5 \
-  -c 137
+  -c 8453
 ```
 
 Options:
@@ -157,6 +195,60 @@ Options:
 - `-m, --amount <amount>` - Amount to send in token units (required)
 - `-c, --chain-id <chainId>` - Chain ID (required)
 
+**Note**: Gas fees are automatically paid using the same token you're transferring (e.g., transfer USDC, pay gas in USDC). No native token (ETH/MATIC) needed!
+
+## Indexer Commands
+
+Query blockchain data using Sequence Indexer.
+
+### Get Token Balances
+
+```bash
+npx @0xsequence/builder-cli indexer balances <address> \
+  -a <access-key> \
+  -c <chain-id> \
+  --include-metadata
+```
+
+### Get Native Token Balance
+
+```bash
+npx @0xsequence/builder-cli indexer native-balance <address> \
+  -a <access-key> \
+  -c <chain-id>
+```
+
+### Get Transaction History
+
+```bash
+npx @0xsequence/builder-cli indexer history <address> \
+  -a <access-key> \
+  -c <chain-id> \
+  --limit 20
+```
+
+### Get Token Info
+
+```bash
+npx @0xsequence/builder-cli indexer token-info <contract-address> \
+  -a <access-key> \
+  -c <chain-id>
+```
+
+## Supported Networks
+
+| Network | Chain ID |
+|---------|----------|
+| Ethereum | 1 |
+| Polygon | 137 |
+| Base | 8453 |
+| Arbitrum | 42161 |
+| Optimism | 10 |
+| BSC | 56 |
+| Avalanche | 43114 |
+
+See all supported networks at [Sequence Status](https://status.sequence.info/).
+
 ## JSON Output Mode
 
 All commands support `--json` flag for machine-readable output:
@@ -165,6 +257,7 @@ All commands support `--json` flag for machine-readable output:
 npx @0xsequence/builder-cli projects --json
 npx @0xsequence/builder-cli apikeys 12345 --json
 npx @0xsequence/builder-cli create-wallet --json
+npx @0xsequence/builder-cli indexer balances <address> -a <key> -c 8453 --json
 ```
 
 Example JSON output:
@@ -178,16 +271,16 @@ Example JSON output:
 
 ## Exit Codes
 
-| Code | Meaning             |
-| ---- | ------------------- |
-| 0    | Success             |
-| 1    | General error       |
-| 10   | Not logged in       |
-| 11   | Invalid private key |
-| 20   | Insufficient funds  |
-| 30   | No projects found   |
-| 31   | Project not found   |
-| 40   | API error           |
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 10 | Not logged in |
+| 11 | Invalid private key |
+| 20 | Insufficient funds |
+| 30 | No projects found |
+| 31 | Project not found |
+| 40 | API error |
 
 ## Configuration
 
@@ -213,13 +306,14 @@ npx @0xsequence/builder-cli login -k <key> --api-url https://custom-api.example.
 
 ## Requirements
 
-- Node.js 18+ (recommended)
+- Node.js 18+
 
 ## Local Development
 
 ```bash
 # Clone and install
-cd cli
+git clone https://github.com/0xsequence/builder-cli.git
+cd builder-cli
 pnpm install
 
 # Run in development mode

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@0xsequence/builder-cli",
   "version": "0.1.0",
-  "description": "CLI for Sequence Builder - designed for AI agents and automation",
+  "description": "CLI for Sequence Builder - manage wallets, projects, transfers, and query blockchain data. Designed for AI agents and automation.",
   "main": "./dist/bin.js",
   "type": "module",
   "bin": {
@@ -26,7 +26,12 @@
     "wallet",
     "ethereum",
     "web3",
-    "ai-agents"
+    "ai-agents",
+    "smart-wallet",
+    "indexer",
+    "erc20",
+    "transfer",
+    "blockchain"
   ],
   "author": "Sequence Platforms Inc.",
   "license": "MIT",
@@ -52,6 +57,7 @@
   "dependencies": {
     "0xsequence": "2.3.39",
     "@0xsequence/auth": "2.3.39",
+    "@0xsequence/indexer": "^2.3.39",
     "@0xsequence/network": "2.3.39",
     "@0xsequence/relayer": "2.3.39",
     "chalk": "^5.3.0",

pnpm-lock.yaml

@@ -9,6 +9,7 @@ import {projectsCommand} from "./commands/projects.js";
 import {apikeysCommand} from "./commands/apikeys.js";
 import {transferCommand} from "./commands/transfer.js";
 import {walletInfoCommand} from "./commands/wallet-info.js";
+import {indexerCommand} from "./commands/indexer.js";
 
 const program = new Command();
 
@@ -24,6 +25,7 @@ program.addCommand(loginCommand);
 program.addCommand(projectsCommand);
 program.addCommand(apikeysCommand);
 program.addCommand(transferCommand);
+program.addCommand(indexerCommand);
 
 // Note: --json, --env, and --api-url are defined on each subcommand
 // This allows subcommands to properly receive and handle these options