InspectActivity

id is the stable identifier for this entry. Swap-backed SEND and RECV rows use the Lightning payment_hash. Credit-backed RECV rows use the credit operation id (see CreditReceive.operation_id); the payment_hash lives on recv progress/detail instead. EXIT rows use leave_job_id (or sweep txid); DEPOSIT rows use the boarding outpoint or txid.

kind is the user-visible category.

status is the coarse user-facing outcome: PENDING, COMPLETE, or FAILED. It mirrors the backing source's durable state and should not be reinterpreted by display clients.

amount_sat is signed: positive values are incoming to the wallet, negative values are outgoing.

fee_sat is the absolute fee paid (or pending) for this operation.

counterparty is a short, display-friendly identifier of the other side: a truncated invoice for Lightning, an ark peer address for OOR, a bech32 onchain address for exits, or "boarding" for deposits.

created_at_unix is the local creation timestamp in unix seconds.

updated_at_unix is the last persisted update timestamp in unix seconds. List ACTIVITY and SubscribeWallet sort by this field, descending.

note is the caller-supplied label captured at submit time, if any.

failure_reason is populated only when status is FAILED. It is a single human-readable string, never a coded enum tree.

request is the original payment request or destination associated with the entry, when the backing subsystem persists it. This is useful for expanded views and inspection; compact clients should not need to parse it to explain status or lifecycle.

progress carries lifecycle-specific metadata already normalized by the wallet service. Clients can render phase_label directly or switch on phase without inferring meaning from swap/ledger internals.

failure_code is a stable, machine-readable classification of why a FAILED entry failed. It is set ONLY on FAILED entries; a non-failed entry omits the field entirely (presence-tracked), so its absence is the canonical "no failure" signal and ENTRY_FAILURE_CODE_UNSPECIFIED is never sent on the wire. failure_reason remains the human-readable supplement.

lightning_invoice is populated for Lightning send and receive entries.

onchain_address is populated for deposit and exit entries.

ark_address is populated for direct Ark send or receive entries.

invoice is the BOLT-11 payment request.

payment_hash identifies the invoice and remains stable after the invoice itself is no longer convenient to display.

address is the bech32 onchain address originally issued or targeted.

address is the Ark address originally issued or targeted.

phase is the coarse lifecycle phase for this entry.

phase_label is a short lowercase label that clients can render as-is while they migrate to enum-based presentation.

payment_hash is populated for Lightning-backed send/recv entries.

txid is populated when the backing ledger row has an onchain txid.

confirmation_height is populated once the source records it.

vtxo_outpoint is populated when a swap observes the Ark vHTLC output.

preimage is the hex-encoded Lightning payment preimage once the swap revealed it. For a completed Lightning-backed send this is the proof of payment for the paid invoice (sha256(preimage) == payment_hash); it is empty until the preimage is durably known and for non-Lightning entries.

payment_hash is the Lightning payment hash that identifies the swap-backed activity.

direction is the raw swapclientrpc.SwapDirection enum name, kept as a string so this debug surface can expose swap state without importing the swap service proto into the wallet proto.

state is the raw swapclientrpc.SwapState enum name at inspection time.

pending is true while the backing swap state machine is still active.

amount_sat is the swap amount in satoshis using the swap service's unsigned amount convention.

fee_sat is the fee reported by the swap service for this swap.

invoice is the BOLT-11 invoice associated with the swap when known.

vhtlc_outpoint is the Ark vHTLC output observed for the swap when known.

vhtlc_amount_sat is the amount held by vhtlc_outpoint when known.

funding_session_id is the OOR session that funded the swap when known.

claim_session_id is the OOR session that claimed the swap when known.

refund_session_id is the OOR session that refunded the swap when known.

terminal_reason is the swap service's terminal reason string when the swap reached a failed or intervention state.

created_at_unix is the swap creation timestamp in unix seconds.

updated_at_unix is the last swap update timestamp in unix seconds.

deadline_unix is the swap deadline in unix seconds when the swap service exposes one.

refund_locktime is the absolute locktime after which the swap can be refunded.

settlement_type is the raw swapclientrpc.SwapSettlementType enum name when known.

sender_pubkey is the compressed SEC-encoded vHTLC sender key when known.

preimage is the hex-encoded Lightning payment preimage once the swap revealed it. For a completed pay swap this is the proof of payment for the paid invoice; it is empty until the preimage is durably known.

id is the best available identifier. It is an outpoint when the source has one, otherwise an OOR session/output identifier.

amount_sat is the VTXO amount in satoshis.

role is a short technical label such as "spent_input", "change_output", "materialized_output", or "vhtlc_output".

ours is true when the row represents wallet-owned funds.

source names the local source used to derive the row, such as "ledger" or "swap".

session_id is the OOR session/correlation id when known.

output_index is set when the source names a specific OOR output index.

source names the subsystem that produced the row, such as "ledger" or "boarding_sweep".

type is the broad transaction group used by the wallet history query.

subtype is the ledger event type or sweep state.

amount_sat is the row amount in satoshis using the ledger sign convention.

fee_sat is the row's fee contribution in satoshis when the history query can derive one.

created_at_unix is the row creation timestamp in unix seconds.

confirmation_status is the best-known chain confirmation state for the row, for example "pending", "confirmed", or "recorded".

description is the local ledger description persisted with the row.

entry_id is the local ledger row id when the source is the ledger.

txid is the associated chain transaction id when known.

debit_account is the local accounting debit account.

credit_account is the local accounting credit account.

round_id is the Ark round id associated with the row when known.

session_id is the OOR session/correlation id associated with the row when known.

confirmation_height is the confirmed block height when known.

hidden_from_activity is true when WalletService.List suppresses the row because it is an internal execution leg.

role is the inspection role inferred for this row.

output_index is the transaction output index associated with txid. A negative value means the source has no output index.