Payments10 min read

How Kizuna Settlement Works on Solana

Deep dive into Kizuna's settlement system for AI agent transactions on Solana. Learn how the Onboard-Verify-Settle-Repay flow works, how funds are locked, and how exactly-once billable events ensure financial safety.

How Kizuna Settlement Works

Settlement is the moment when a verified payment approval becomes a completed financial transaction. In Kizuna, settlement is the second step of the two-phase verify/settle flow. Once the x402 facilitator has created a reservation during verify, settlement executes the actual fund movement.

Kizuna settles on Solana for its sub-second finality, low transaction costs, and high throughput. Every settlement emits an exactly-once billable event — the atomic unit of Kizuna's commercial model.

The Verify/Settle Two-Phase Flow

The flow begins when a client SDK calls verify. The facilitator validates protocol inputs, resolves the agent's lane, and forwards the request to the Kizuna kernel. If the kernel approves, the facilitator creates a reservation in the appropriate pool and returns a signed approval envelope.

The client then calls settle with the reservation ID. The facilitator validates the reservation and decision envelope, then executes settlement:

  • Enterprise lane: consumes locked prefund from the mandate account
  • Crypto-fast lane: creates debt against the isolated collateral pool
  • On-chain settlement executes via Solana programs
  • Exactly-once billable event is emitted and recorded

Settlement on Solana

Solana provides the execution layer for Kizuna settlement. The protocol's Solana programs handle fund transfers, state updates, and event emission. Key advantages of Solana for settlement include:

Sub-Second Finality

Settlements finalize in under 400ms. Agents don't wait — they verify, settle, and move to the next task.

Low Cost

Settlement transactions cost fractions of a cent. This makes micro-settlements for AI agent tasks economically viable.

High Throughput

Solana processes thousands of transactions per second, supporting large-scale agent deployments without congestion.

Program Composability

Kizuna's Solana programs compose with SPL tokens, Token-2022 extensions, and other DeFi primitives.

Enterprise Settlement Mechanics

For enterprise lane settlements, the flow consumes locked prefund. When an enterprise agent onboards, its operator deposits funds into a mandate account with spending limits. Each settlement deducts from this prefund balance. When the balance runs low, the operator replenishes it.

This model provides clear audit trails: every settlement is traceable to a specific mandate, amount, and timestamp. There is no credit risk — funds are locked before any agent can spend them.

Crypto-Fast Settlement Mechanics

Crypto-fast settlements create debt against collateral. The agent posts collateral into an isolated pool before making requests. Each settlement creates a debt position within that pool, subject to LTV caps and health factor enforcement.

If the health factor drops below threshold, the kernel restricts new settlements until the agent repays debt or adds collateral. This isolation ensures that one agent's risk cannot affect others.

Exactly-Once Billable Events

Every Kizuna settlement emits exactly one billable event. This is enforced at the protocol level — duplicate settlements are rejected, and partial settlements are not possible. The billable event is the foundation of Kizuna's commercial model and audit system.

Billable events include the settlement amount, lane, agent identity, reservation ID, and timestamp. They are indexed and queryable through the companion API for billing, reconciliation, and compliance reporting.

Frequently Asked Questions

How does Kizuna settlement work?

Kizuna follows a default flow of Onboard → Verify → Settle → Repay. Agents onboard with funding (prefunded mandate or collateral), the x402 facilitator verifies each request, settlement is executed on-chain with exactly-once billable events, and repayment handles any outstanding balances.

What tokens does Kizuna support?

Kizuna supports SOL and any SPL token for settlement. The protocol uses Solana's transfer hook mechanism for additional compliance checks when needed.

Are funds safe during settlement?

Yes. Kizuna enforces a strict rule: no payout without locked funding. Funds are held in program-derived accounts and controlled by audited Solana programs. Kill switches can halt settlement if anomalies are detected.

Build with Kizuna

Start building with the trust, settlement, and control layer for agent commerce.

Docs →