The following provides an overview of the main gRPC services that power the arkd system.
ArkService
– the primary access point for real-time coordination, batch participation, intent management, and transaction submission. It enables clients to register intents, coordinate multi-party batches, sign with MuSig2, and spend VTXOs without relinquishing control of their funds. Event-driven endpoints like GetEventStream
and GetTransactionsStream
let clients stay synchronized with network activity.
IndexerService
– optimized for historical queries, auditing, and VTXO tree navigation. It provides functions for VTXO lifecycle analysis, chain tracing, sweep monitoring, and connector tree exploration. Use it to reconstruct offchain state, audit fund flows, and handle data-rich workflows.
GetVtxoTreeLeaves
vs. full GetVtxoTree
). Batch sweep tracking provides visibility into operator claims and onchain unroll scenarios.
The complete interfaces for both services are defined in the protocol buffer specification and are available in the buf.build registry: