maestro

name: maestro description: Maestro Symphony blockchain query operations for OpenAgents agents, including tip freshness checks, address/UTXO/runes queries, and production-safe troubleshooting against deployed Symphony API endpoints. metadata: oa: project: maestro identifier: maestro version: "0.1.0" expires_at_unix: 1798761600 capabilities: - http:outbound - filesystem:read - process:spawn

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, or regtest).
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 (/dump restricted, 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