participant_id that never changes. See Participants.
Channel
A permanent, one-way payment relationship keyed by (payer_id, payee_id, token_id). Tracks settled_cumulative, locked_balance, and an authorized_signer. See Payment channels.
Commitment
A signed off-chain message that sets a new cumulative amount for one channel. The hot-path primitive. See Commitments.
Cumulative amount
The total value the payer has ever committed to send over a channel, from inception to now. Settlement on-chain applies only the delta against settled_cumulative.
Latest commitment / direct settlement
Settling one channel by submitting one agon-cmt-v5 message via settle_individual. See Direct settlement.
Bundle settlement
One payee settling many agon-cmt-v5 messages — from many payers — in one transaction via settle_commitment_bundle. See Bundle settlement.
Clearing round
One shared agon-round-v4 message signed by several participants that advances many channels in one transaction via settle_clearing_round. Only the net residual flow is applied on-chain. See Clearing rounds.
Gross routed value
The total value represented by all cumulative advances implied by a clearing round, before netting.
Residual / net flow
The remaining participant balance change after payments implied by a clearing round cancel each other out. This is the value actually moved between participant balances on-chain.
agon-cmt-v5
The unilateral cumulative commitment message format. See Message formats.
agon-round-v4
The cooperative clearing-round message format. See Message formats.
Message domain
A 16-byte deployment-scoped tag derived from the program ID and chain ID. Every signed Agon message carries it; messages signed for one deployment will not verify on another. See Deployment.
authorized_signer
The key allowed to sign agon-cmt-v5 commitments for a specific channel. Stored on-chain in ChannelState and rotatable under a timelock.
authorized_settler
An optional delegate named inside a signed agon-cmt-v5 message that is allowed to submit the message on-chain in addition to the payee. See Authorized settler.
Operator hub
A service that coordinates payments between many users and providers using Agon channels, without taking custody. See Operator hubs.
Vault
The protocol’s SPL token accounts, one per registered token, where deposited funds actually live. Participant available_balance and channel locked_balance are ledger positions against the vault.
Available balance
A participant’s spendable balance for a token — usable to lock into channels or request withdrawals.
Locked balance
Funds in a participant’s balance that have been earmarked to a specific channel’s locked_balance. They can only be consumed by settlement against that channel (or released via a timelocked unlock).
Timelock
A mandatory waiting period between requesting and executing a sensitive action — withdrawals, channel unlocks, and channel signer rotations. Prevents sudden disruption of in-flight payments.
Chain ID
A protocol-level identifier (0 mainnet, 1 devnet, 2 testnet, 3 localnet) folded into the message domain. See Deployment.
GlobalConfig
Singleton PDA that holds fee parameters, authority keys, chain ID, and the message domain. See Accounts.
TokenRegistry
Singleton PDA holding the allowlist of settlement tokens. See Accounts.
ParticipantAccount
PDA holding per-token balances and the inbound channel policy for one wallet. See Accounts.
ChannelState
PDA holding the settled cumulative amount, locked balance, and authorized signer for one channel. See Accounts.
Inbound channel policy
A participant-level setting that controls whether others can open inbound channels to them: permissionless, consent-required, or disabled.
Ed25519 program
Solana’s native Ed25519 signature verification program. Agon uses it to verify off-chain agon-cmt-v5 and agon-round-v4 signatures as part of settlement transactions.
BLS signature aggregation
A roadmap item for compressing cooperative rounds further by aggregating many signatures into one. Not shipped in V4. See Roadmap.