Glossary

AgentWallet

A Solana PDA owned by the Pact program. Tracks an agent’s balance for premiums and refunds. See Protocol primitives → AgentWallet.

Allowlist

Closed list of API keys / wallets approved to call Market and the authenticated public API in private beta. See Private beta.

Bootstrap

The one-time on-chain init step that creates the CoveragePool and EndpointConfig PDAs after program deployment. See Status for the current state.

Classifier

The component that labels each call as success, client_error, or server_error based on the upstream response. See Classifier & refund policy.

`client_error`

A call that failed because of the agent’s request (bad auth, malformed payload, expired token, rate-limited per-key). No refund.

CoveragePool

The on-chain pot of USDC that pays refunds. Funded by Pact in v1. See Protocol primitives → CoveragePool.

EndpointConfig

A Solana PDA that holds rules for one wrapped endpoint: premium rate, classifier config, settler authority. One per provider × endpoint. See Protocol primitives → EndpointConfig.

MPP

Multi-Payment-Protocol — a Solana-stablecoin variant of HTTP 402 payment challenges. Server returns WWW-Authenticate: SolanaCharge <params> and a Payment-Receipt header on the retry. Sits alongside x402 and uses the same agent → provider payment flow; pay.sh and pact pay parse both.

`pact-market-pinocchio`

The Solana program (Pinocchio is a Solana program framework). Program ID: 5bCJcdWdKLJ7arrMVMFh3z99rQDxV785fnD9XGcr3xwc. See Protocol Reference.

Pact Market

The curated wrapped-provider interface at market.pactnetwork.io. One interface on top of Pact Network. See Market.

Pact Network

The protocol — on-chain Solana program plus off-chain settler/indexer/API. The risk layer for agent payments.

`pact pay`

Drop-in for solana-foundation/pay (pay.sh): same argv, exit codes, and x402 + MPP wire format; adds Pact’s on-chain refund layer. See Quickstart.

pay.sh

Common name for solana-foundation/pay — the Solana Foundation’s CLI / MCP for resolving HTTP 402 via x402 and MPP using Solana stablecoins.

Premium

Pact’s per-call fee on top of the principal. Set per EndpointConfig. Earned by the CoveragePool on successful calls; refunded along with principal on server_error. See Classifier & refund policy.

Principal

What the agent pays the upstream provider for a call. Distinct from premium (Pact’s fee).

`server_error`

A call that failed because of the provider or the network (5xx, timeout, truncated body, Market internal error). Refund issued: principal + premium.

`settle_batch`

The on-chain instruction that commits a batch of classified calls. Settler service calls it. Premiums move into the pool, refunds move out. See Concepts → settle_batch.

Settler

The off-chain service that batches classified calls and submits settle_batch transactions. See Settlement authority.

`success`

A call that returned a 2xx with a valid body. Premium earned by the protocol; agent pays principal + premium.

USDC

The settlement asset on mainnet v1. Mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.

x402

HTTP 402 Payment Required, used as a payment-protocol convention for agent → provider payments. Pact covers x402 calls with on-chain refunds.