Module rpc 

JSON-RPC + Tax Router Subsystem

Responsibilities:

1. Serialise engine telemetry into billing receipts (ILP / Lightning)
2. Evaluate incoming provider terms against the ILP Threshold Shift License
3. Split every accepted payment through the 12% Tax Router: 12% → divided across the TaxRecipientSuite (ILP micropayments) 88% → Principal’s wallet

The Tax Router is transport-agnostic — it produces a TaxDispatchPlan which the ILP layer (or future Lightning/Nym bridge) executes as discrete micropayments. Each recipient address is an ILP Payment Pointer (“$…”) or a stablecoin wallet address (“did:…”). Nym mixnet routing is opt-in per recipient (use_nym).

Structs

ComputeCostReceipt

A receipt detailing the exact Virtual Compute Cycles burned during a query.

MicropaymentInstruction

A single resolved micropayment instruction in a dispatch plan.

NegotiationResponse

The local agent’s response to the provider’s terms.

ProviderTermsRequest

A request from an external corporate provider (e.g., ISP, Telemetry Aggregator) proposing terms to connect to the local Qualia-DB daemon.

TaxDispatchPlan

The complete dispatch plan produced by the Tax Router. The ILP layer executes each instruction as a discrete micropayment stream.

TaxRecipient

A single named recipient in the tax disbursement suite. ilp_address is an ILP Payment Pointer (“$provider.example/account”) or a stablecoin address (“did:wallet:…”). share_percent must sum to 100 across all recipients in a suite.

TaxRecipientSuite

A configured set of tax recipients for a jurisdiction. Example: Federal 60%, State 30%, Municipal 10%.

Enums

NegotiationStatus

Constants

TAX_RATE_PERCENT

The fixed statutory tax rate applied to all incoming payments. 12% is split across the TaxRecipientSuite before the remainder reaches the Principal’s wallet.

Functions

negotiate_provider_terms

Evaluates a corporate provider’s connection request against the user’s intrinsic ILP connectivity cost and Rights Ontology, then routes the accepted payment through the 12% Tax Router.

route_tax_payment

Routes a gross payment through the 12% Tax Router. Produces a TaxDispatchPlan ready for ILP execution.