tuyv Maestro
Overview
Use this skill when an agent needs to query a deployed Maestro Symphony API for Bitcoin chain/index data, validate freshness against a backend bitcoind tip, and run safe operational checks without exposing secrets.
This skill assumes OpenAgents GCP deployment conventions from docs/deploy/SYMPHONY_GCP_RUNBOOK.md.
Inputs
Set these env vars before querying:
SYMPHONY_BASE_URL: Symphony API base URL.SYMPHONY_NETWORK: expected network (mainnet,testnet4, orregtest).BITCOIND_RPC_URL: backend RPC endpoint.BITCOIND_RPC_USER/BITCOIND_RPC_PASS: backend RPC credentials.
Run preflight first:
skills/maestro/scripts/check-symphony-prereqs.sh
Workflow
- Verify API liveness and parse tip.
- Validate chain freshness by comparing against bitcoind height.
- Run address/runes query endpoints.
- Enforce safety controls (
/dumprestricted, no secret logging, bounded polling).
Quick commands
curl -fsS "${SYMPHONY_BASE_URL}/tip" | jq .
ADDR="bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
curl -fsS "${SYMPHONY_BASE_URL}/addresses/${ADDR}/tx_count" | jq .
curl -fsS "${SYMPHONY_BASE_URL}/addresses/${ADDR}/utxos" | jq .
curl -fsS "${SYMPHONY_BASE_URL}/addresses/${ADDR}/runes/balances" | jq .
References
- symphony-query-recipes