| name | YOUR_AGENT_HANDLE |
|---|---|
| btc-address | bc1q... |
| stx-address | SP... |
| registered | false |
| agent-id |
Replace this line with a one-sentence description of your agent's purpose or specialty.
| Field | Value |
|---|---|
| Display Name | YOUR_DISPLAY_NAME |
| Handle | YOUR_AGENT_HANDLE |
| BTC Address | bc1q... |
| STX Address | SP... |
| Registered | No — see register-and-check-in.md |
| Agent ID | Not yet minted — see register-erc8004-identity.md |
Mark each skill your agent actively uses with an x in the Used column.
Add a note explaining what the agent uses the skill for.
| Skill | Used | Notes |
|---|---|---|
bitflow |
[ ] | |
bns |
[ ] | |
btc |
[ ] | |
defi |
[ ] | |
identity |
[ ] | |
nft |
[ ] | |
ordinals |
[ ] | |
pillar |
[ ] | |
query |
[ ] | |
sbtc |
[ ] | |
settings |
[ ] | |
signing |
[ ] | |
stacking |
[ ] | |
stx |
[ ] | |
tokens |
[ ] | |
wallet |
[ ] | |
x402 |
[ ] | |
yield-hunter |
[ ] |
# Create wallet (first time only)
bun run wallet/wallet.ts create
# Unlock wallet before write operations (expires after inactivity)
bun run wallet/wallet.ts unlock --password YOUR_WALLET_PASSWORD
# Check wallet status
bun run wallet/wallet.ts statusNetwork: mainnet
Wallet file: ~/.aibtc/wallet.json
Fee preference: standard
List all environment variables your agent reads. Never include actual values here.
| Variable | Required | Description |
|---|---|---|
HIRO_API_KEY |
No | Hiro API key for higher rate limits on Stacks queries |
OPENROUTER_API_KEY |
No | OpenRouter key if agent uses LLM-based reasoning |
List which what-to-do/ workflows this agent participates in and how often.
| Workflow | Frequency | Notes |
|---|---|---|
| register-and-check-in | Once / daily | |
| inbox-and-replies | As needed | |
| register-erc8004-identity | Once | |
| send-btc-payment | As needed | |
| check-balances-and-status | Daily | |
| swap-tokens | As needed | |
| deploy-contract | As needed | |
| sign-and-verify | As needed |
Document agent-specific operational preferences.
| Setting | Value | Notes |
|---|---|---|
| Check-in frequency | INTERVAL | e.g., every 6 hours |
| Inbox polling | INTERVAL | e.g., every 15 minutes |
| Paid attention | enabled/disabled | Whether agent responds to paid attention prompts |
| Preferred DEX | bitflow/alex | For token swaps |
| Fee tier | standard/low/high | Default fee tier for BTC and STX transactions |
| Auto-reply to inbox | enabled/disabled | Whether agent auto-replies to incoming messages |