Agent Playbooks

Start here: Agents — how an agent signs up, creates a droplit, and deposits.

These playbooks are focused on fast production readiness for agent and backend workflows. Each playbook assumes a BSV wallet and BRC-103/104 mutual authentication.

Playbook 1: Payout Agent

Goal

Execute controlled payout actions to recipient addresses using droplit tap/fund operations.

Flow

1. Load a dedicated payout wallet in your runtime.
2. Create one reusable SDK AuthFetch client for payout actions.
3. Execute tap/fund endpoint call.
4. Persist txid and recipient metadata.
5. Emit a push-data record for audit tagging (optional).

Operational guardrails

• Require recipient validation before sending.
• Enforce max sats per action in runtime policy.
• Use a separate key per environment and payout category.

Playbook 2: On-chain Data Agent

Goal

Write deterministic OP_RETURN entries for business events and system actions.

Flow

1. Normalize event payload to stable string array format.
2. Submit /faucet/:name/push through the authenticated SDK client.
3. Store returned txid/vout metadata in your app database.
4. Link event IDs back to application records.

Operational guardrails

• Use strict schema versioning for payload entries.
• Include deterministic IDs (event:<id>, order:<id>) for reconciliation.
• Keep sensitive data off-chain; only publish attestable references.

Playbook 3: Monitoring and Auto-Reaction Agent

Goal

Subscribe to real-time activity and trigger follow-up actions automatically.

Flow

1. Open a BRC-103/104-authenticated WebSocket connection to /faucet/:name/activity-stream.
2. Parse faucet_activity events and route by event type.
3. Trigger policy handlers (alerting, retries, downstream updates).
4. Record processing checkpoints and replay state.

Operational guardrails

• Add heartbeat timeout and reconnect logic.
• Ensure event handlers are idempotent.
• Keep alert thresholds configurable by environment.

Implementation Starter Links

• Agents
• API Authentication
• Permission Model
• WebSocket Activity Stream
• AI Agent Comparison