| ARCHITECTURE.md |
Package layers, dependency graph, key types, patterns |
| arkscript_spec.md |
RFC-style specification for the lib/arkscript tapscript policy system (AST, encoding, invariants, security considerations) |
| durable_actor_architecture.md |
CDC pattern, durable mailbox lifecycle, recovery flow |
| durable_actor_quickstart.md |
Developer guide: TLVMessage, ActorBehavior, migration checklist |
| oor_subsystem.md |
The OOR (out-of-round) subsystem: per-session actor model, the oor_session_registry single source of truth, the Read/Commit turn with its inline outbox switch, outgoing/incoming flows, crash recovery, and the per-session concurrency fix for issue #605 |
| fee_ledger.md |
Client-side double-entry fee ledger: chart of accounts, per-flow walkthroughs, emission sites, replay safety |
| fee-change-model.md |
Seal-time fee handshake (#270): change-output designation rules, 11-scenario catalogue, proto contract, CLI mapping |
| credit_system.md |
Sat-native credit accounts for below-dust receives, credit-assisted receives, credit-backed sends (Lightning and same-Ark internal settlement), top-ups, and wavewalletdk integration, with mermaid diagrams |
| sdk_layered_architecture.md |
SDK layering rationale: sdk/ark facade, remote vs. embedded modes, sdk/swaps future direction |
| swap_system.md |
End-to-end swap walkthrough: vHTLC tree (collaborative vs. unilateral-exit leaves), receive (out-swap) and pay (in-swap) flows, the off-chain-first cancellation/timeout recovery ladder, same-Ark p2p detection, swap-server RPCs, and proof-gated indexer authorization, with mermaid diagrams |
| wavewalletdk_integration.md |
Basic wavewalletdk integration flow, startup/config examples, swap accounting, and wrapper guidance |
| canonical_activity_log_design.md |
Design (#774): a canonical store with stable cross-restart ids replacing the derive-on-read activity feed — a current-state activity_entries projection plus an append-only, sequence-numbered activity_events log (mailbox-style cursor) for resumable subscribe; foundation of the event-log epic (#776) |
| wavewalletrpc_build.md |
How to build and install the daemon and CLI with the wallet RPC subserver enabled (wavewalletrpc + swapruntime tags) |
| seed_restore_recovery.md |
Restore a self-managed seed and recover Ark state from chain/indexer data |
| swap_background_execution.md |
Optional build-tagged daemon executor for background swap progress and daemon-backed CLI control |
| mailbox_architecture.md |
Three-layer mailbox system: pb, rpc, conn, serverconn |
| mailbox_durable_actor_layer.md |
The durable mailbox and durable actor: leases, dedup, transactional outbox, DurableAsk, and the classic vs. Read/Commit (TxBehavior/Exec[S]) execution paths |
| mailbox_transport_serverconn_clientconn.md |
The RPC-over-mailbox transport relating this client's serverconn to the operator's clientconn: envelope, edge API, shared mailbox/conn primitives, ack watermark, identity/auth/liveness, and the wire contract |
| RPC_MAILBOX_CONTRACT.md |
Envelope semantics, at-least-once delivery, ack watermarks |
| credit_durable_actor_design.md |
Credit subsystem durable-actor design: supervisor + per-operation actors driving fault-tolerant sub-floor pay, credit-receive, and redeem flows against the authoritative server ledger |
| wavewalletdk_mobile.md |
gomobile-safe sdk/wavewalletdk/mobile facade: drives an embedded in-process waved wallet from Android/iOS over the private bufconn transport (bytes-out API, no daemon binary) |