{"id":51485855,"url":"https://github.com/0xsequence/builder-cli","last_synced_at":"2026-07-07T06:30:44.881Z","repository":{"id":336636105,"uuid":"1150475878","full_name":"0xsequence/builder-cli","owner":"0xsequence","description":"CLI for Builder","archived":false,"fork":false,"pushed_at":"2026-02-13T15:08:19.000Z","size":106,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-13T23:51:29.591Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xsequence.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-05T10:21:09.000Z","updated_at":"2026-02-13T15:08:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/0xsequence/builder-cli","commit_stats":null,"previous_names":["0xsequence/builder-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/0xsequence/builder-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fbuilder-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fbuilder-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fbuilder-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fbuilder-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xsequence","download_url":"https://codeload.github.com/0xsequence/builder-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xsequence%2Fbuilder-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35218117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-07T06:30:43.899Z","updated_at":"2026-07-07T06:30:44.872Z","avatar_url":"https://github.com/0xsequence.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sequence Builder CLI\n\nCLI for Sequence Builder - designed for AI agents and automation. Create wallets, authenticate, manage projects, query blockchain data, and send transactions from the command line.\n\n## Quick Start\n\nRun any command directly with `npx`:\n\n```bash\nnpx @0xsequence/builder-cli --help\n```\n\nOr install globally:\n\n```bash\nnpm install -g @0xsequence/builder-cli\nsequence-builder --help\n```\n\n## Private Key Encryption\n\nSet `SEQUENCE_PASSPHRASE` in your environment to auto-encrypt and store the private key. No need to pass `-k` after wallet creation.\n\n```bash\nexport SEQUENCE_PASSPHRASE=\"your-strong-secret\"\n```\n\n```bash\n# 1. Generate a wallet\nnpx @0xsequence/builder-cli create-wallet --json\n\n# 2. Store the private key securely (shown in output)\n\n# 3. Login with your private key\nnpx @0xsequence/builder-cli login -k \u003cyour-private-key\u003e\n\n# 4. Create a project and get your access key\nnpx @0xsequence/builder-cli projects create \"My Project\"\n\n# 5. Get your Sequence wallet address (where to send tokens)\nnpx @0xsequence/builder-cli wallet-info -k \u003cprivate-key\u003e -a \u003caccess-key\u003e\n\n# 6. Fund the Sequence wallet via the Trails link from step 5\n\n# 7. Send an ERC20 transfer (gas paid with same token!)\nnpx @0xsequence/builder-cli transfer \\\n  -k \u003cprivate-key\u003e \\\n  -a \u003caccess-key\u003e \\\n  -t \u003ctoken-address\u003e \\\n  -r \u003crecipient\u003e \\\n  -m \u003camount\u003e \\\n  -c \u003cchain-id\u003e\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `create-wallet` | Generate new EOA keypair |\n| `wallet-info` | Show EOA and Sequence wallet addresses |\n| `login -k \u003ckey\u003e` | Authenticate with private key |\n| `projects` | List all projects |\n| `projects create [name]` | Create new project |\n| `projects get \u003cid\u003e` | Get project details |\n| `apikeys \u003cproject-id\u003e` | List API keys |\n| `apikeys default \u003cproject-id\u003e` | Get default API key |\n| `transfer` | Send ERC20 transfer via Sequence wallet |\n| `indexer balances \u003caddress\u003e` | Get token balances |\n| `indexer native-balance \u003caddress\u003e` | Get native token balance |\n| `indexer history \u003caddress\u003e` | Get transaction history |\n| `indexer token-info \u003ccontract\u003e` | Get token contract info |\n\n## Understanding Wallet Addresses\n\nThis CLI uses **Sequence Smart Wallets** for transfers. When you create a wallet, you get:\n\n- **EOA Address**: The standard Ethereum address derived from your private key (used for login/project ownership)\n- **Sequence Wallet Address**: A smart contract wallet that enables gas-free transactions (used for transfers)\n\nUse `wallet-info` to see both addresses:\n\n```bash\nnpx @0xsequence/builder-cli wallet-info -k \u003cprivate-key\u003e -a \u003caccess-key\u003e\n```\n\n**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!).\n\n## Create Wallet\n\nGenerate a new wallet for use with Sequence Builder:\n\n```bash\nnpx @0xsequence/builder-cli create-wallet\n```\n\nOutput:\n\n```\n✓ Wallet created successfully!\n\nPrivate Key: 0x4c0883a69102937d6231471b5dbb6204fe512961708279f9f4e7d1b3e6d1e3a1\nAddress:     0x89D9F8f31817BAdb5D718CD6fb483b71DbD2dfeD\n\nIMPORTANT: Store these credentials securely. They will not be shown again.\n```\n\n## Wallet Info\n\nShow both EOA and Sequence wallet addresses:\n\n```bash\nnpx @0xsequence/builder-cli wallet-info -k \u003cprivate-key\u003e -a \u003caccess-key\u003e\n```\n\nOutput:\n\n```\nWallet Addresses:\n\nEOA Address:           0x742BDb3bEEB7aDCe50294665a7388ADB7519a6eA\nSequence Wallet:       0xA715064b5601Aebf197aC84A469b72Bb7Dc6A646\n\nImportant:\n  Send tokens to the Sequence Wallet address for use with the transfer command.\n  The Sequence Wallet can pay gas fees with ERC20 tokens (no ETH needed).\n\nFund your wallet:\n  Click the link below to fund your Sequence Wallet via Trails:\n\nhttps://demo.trails.build/?mode=swap\u0026toAddress=0xA715064b5601Aebf197aC84A469b72Bb7Dc6A646\u0026toChainId=137\u0026toToken=0x3c499c542cef5e3811e1192ce70d8cc03d5c3359\u0026apiKey=AQAAAAAAAKhGHJc3N5V2AWqfJ1v9xZ2u0nA\u0026theme=light\n```\n\n## Login\n\nAuthenticate with Sequence Builder using your private key:\n\n```bash\nnpx @0xsequence/builder-cli login -k 0x4c0883a69102937d6231471b5dbb6204fe5129617...\n```\n\nOptions:\n\n- `-k, --private-key \u003ckey\u003e` - Your wallet private key (required)\n- `-e, --email \u003cemail\u003e` - Email address to associate with your account\n- `--env \u003cenvironment\u003e` - Environment (prod, dev)\n\n## Projects\n\n### List Projects\n\n```bash\nnpx @0xsequence/builder-cli projects\n```\n\n### Create Project\n\n```bash\nnpx @0xsequence/builder-cli projects create \"My Game\"\n```\n\nOptions:\n\n- `--chain-ids \u003cids\u003e` - Comma-separated list of chain IDs\n- `-k, --private-key \u003ckey\u003e` - Show Sequence wallet address in output\n\n### Get Project Details\n\n```bash\nnpx @0xsequence/builder-cli projects get 12345\n```\n\n## API Keys\n\n### List API Keys\n\n```bash\nnpx @0xsequence/builder-cli apikeys 12345\n```\n\n### Get Default API Key\n\n```bash\nnpx @0xsequence/builder-cli apikeys default 12345\n```\n\n## Transfer (ERC20)\n\nSend an ERC20 token transfer using Sequence smart wallet:\n\n```bash\nnpx @0xsequence/builder-cli transfer \\\n  -k 0x4c0883a... \\\n  -a AQAAAAAAAABnD... \\\n  -t 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \\\n  -r 0x1234567890123456789012345678901234567890 \\\n  -m 10.5 \\\n  -c 8453\n```\n\nOptions:\n\n- `-k, --private-key \u003ckey\u003e` - Your wallet private key (required)\n- `-a, --access-key \u003ckey\u003e` - Project access key (required)\n- `-t, --token \u003caddress\u003e` - ERC20 token contract address (required)\n- `-r, --recipient \u003caddress\u003e` - Recipient address (required)\n- `-m, --amount \u003camount\u003e` - Amount to send in token units (required)\n- `-c, --chain-id \u003cchainId\u003e` - Chain ID (required)\n\n**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!\n\n## Indexer Commands\n\nQuery blockchain data using Sequence Indexer.\n\n### Get Token Balances\n\n```bash\nnpx @0xsequence/builder-cli indexer balances \u003caddress\u003e \\\n  -a \u003caccess-key\u003e \\\n  -c \u003cchain-id\u003e \\\n  --include-metadata\n```\n\n### Get Native Token Balance\n\n```bash\nnpx @0xsequence/builder-cli indexer native-balance \u003caddress\u003e \\\n  -a \u003caccess-key\u003e \\\n  -c \u003cchain-id\u003e\n```\n\n### Get Transaction History\n\n```bash\nnpx @0xsequence/builder-cli indexer history \u003caddress\u003e \\\n  -a \u003caccess-key\u003e \\\n  -c \u003cchain-id\u003e \\\n  --limit 20\n```\n\n### Get Token Info\n\n```bash\nnpx @0xsequence/builder-cli indexer token-info \u003ccontract-address\u003e \\\n  -a \u003caccess-key\u003e \\\n  -c \u003cchain-id\u003e\n```\n\n## Supported Networks\n\n| Network | Chain ID |\n|---------|----------|\n| Ethereum | 1 |\n| Polygon | 137 |\n| Base | 8453 |\n| Arbitrum | 42161 |\n| Optimism | 10 |\n| BSC | 56 |\n| Avalanche | 43114 |\n\nSee all supported networks at [Sequence Status](https://status.sequence.info/).\n\n## JSON Output Mode\n\nAll commands support `--json` flag for machine-readable output:\n\n```bash\nnpx @0xsequence/builder-cli projects --json\nnpx @0xsequence/builder-cli apikeys 12345 --json\nnpx @0xsequence/builder-cli create-wallet --json\nnpx @0xsequence/builder-cli indexer balances \u003caddress\u003e -a \u003ckey\u003e -c 8453 --json\n```\n\nExample JSON output:\n\n```json\n{\n  \"privateKey\": \"0x4c0883a...\",\n  \"address\": \"0x89D9F8f...\"\n}\n```\n\n## Exit Codes\n\n| Code | Meaning |\n|------|---------|\n| 0 | Success |\n| 1 | General error |\n| 10 | Not logged in |\n| 11 | Invalid private key |\n| 20 | Insufficient funds |\n| 30 | No projects found |\n| 31 | Project not found |\n| 40 | API error |\n\n## Configuration\n\nConfiguration is stored in `~/.sequence-builder/config.json`:\n\n- JWT token for authentication\n- Environment settings\n- Encrypted private key (if `SEQUENCE_PASSPHRASE` is set)\n\n### Encrypted Key Storage\n\nWhen `SEQUENCE_PASSPHRASE` is set as an environment variable, the CLI will:\n\n1. **On `create-wallet` / `login`**: Encrypt the private key with AES-256-GCM and store it in config\n2. **On all other commands**: Automatically decrypt and use the stored key (no `-k` flag needed)\n\nThe private key is encrypted using a key derived from `SEQUENCE_PASSPHRASE` via scrypt. Only the encrypted ciphertext, salt, and IV are stored -- never the raw key.\n\nTo disable encrypted storage, simply unset the env var. You can always override with an explicit `-k` flag.\n\n## Environment Support\n\n```bash\n# Use production (default)\nnpx @0xsequence/builder-cli login -k \u003ckey\u003e --env prod\n\n# Use development\nnpx @0xsequence/builder-cli login -k \u003ckey\u003e --env dev\n\n# Use custom API URL\nnpx @0xsequence/builder-cli login -k \u003ckey\u003e --api-url https://custom-api.example.com\n```\n\n## Requirements\n\n- Node.js 18+\n\n## Local Development\n\n```bash\n# Clone and install\ngit clone https://github.com/0xsequence/builder-cli.git\ncd builder-cli\npnpm install\n\n# Run in development mode\npnpm dev create-wallet\npnpm dev login -k \u003ckey\u003e\npnpm dev projects\n\n# Build\npnpm build\n```\n\n## Publishing\n\n```bash\n# Bump version\nnpm version patch  # or: minor | major\n\n# Build and publish (single command)\npnpm upload\n\n# Or manually:\npnpm build\nnpm publish --access public\n\n# Push tags\ngit push origin main --tags\n```\n\n## License\n\nMIT — see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xsequence%2Fbuilder-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xsequence%2Fbuilder-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xsequence%2Fbuilder-cli/lists"}