Protocol Architecture

How Helius Solana Privacy Rings, Provable Authority Mandates, A402 Atomic Escrows, AgentValve Trust Capacity, and Solana Confidential Compute compose inside tova_core.

End-to-End Shielded HTTP 402 Loop

Program ID: C5K5LF7CGN5zKf7mxHxy5PYQHnvzHEui7dtkLZ1ytmb9
01 · PRINCIPALRing Vaultdeposit_shieldedissue_mandate02 · AGENTShielded Mandate192B Groth16 proofopen_settlement (~155k CU)03 · SOLANA L1SettlementEscrowNullifierRecord PDAProvider capacity lock04 · TEE PROVIDERAttested ClaimIntelTDX / AMD SEV-SNPclaim_settlement (0.25% fee)TIMEOUT > deadline_slot → refund_settlement

On-Chain Invariants

Enforced by tova_core
No double-spendINV-01

Every spent Ring note nullifier initializes a unique NullifierRecord PDA. Reusing a nullifier fails unconditionally at runtime.

Budget soundnessINV-02

Every open_settlement Groth16 proof verifies amount <= per_call_cap, epoch_spent + amount <= epoch_budget, and Merkle inclusion in RingVault.merkle_root.

Atomic deliveryINV-03

Escrowed commitments move to the provider only when claim_settlement verifies an active TEE attestation signature bound to request_hash before deadline_slot; otherwise refund_settlement restores them to RingVault.

Capacity boundINV-04

provider.active_unsettled + settlement_cap_bound <= provider.staked_capacity holds across every open escrow so Sybil endpoints cannot over-reserve agent capital.

Account & PDA Layout

12 instructions · 6 PDAs
ProtocolConfig["config"]

Global authority, fee_recipient, fee_bps (25 bps default), pause flag, counters.

RingVault["ring_vault", principal, mint]

Encrypted commitment Merkle root, note count, viewing-key tag, SPL/SOL escrow ATA.

Mandate["mandate", vault, mandate_id_le]

Agent signing key, per-call & epoch commitments, allowed provider root, expiry, active flag.

ProviderRegistry["provider", provider_pubkey]

Hardware attestation pubkey (IntelTDX / AmdSevSnp), expiry slot, capacity stake, active unsettled volume.

SettlementEscrow["settlement", mandate, settlement_id_le]

Request hash, amount commitment, nullifier hash, deadline slot, Open/Claimed/Refunded status.

NullifierRecord["nullifier", vault, nullifier_hash]

Single-use spent marker preventing any replay of an encrypted Ring note.