Developer guide

Vocabulary

3 min read

  • Adapter: a component that translates ChatterPay's common model to the specific API or mechanics of a blockchain or provider.
  • Artifact Registry / OCI registry: a repository from which pipelines publish, verify and download versioned images and other OCI artifacts.
  • Canary: an initial, real activation for a small, controlled set of accounts before a rollout is expanded.
  • Reconciliation: comparing Operation, ledger and external evidence to confirm an operation's result and record differences or adjustments.
  • partner_managed custody: a model in which the Partner controls the keys and signing authority for its users' wallets.
  • EntryPoint: the central ERC-4337 contract that receives and processes UserOperations.
  • Event: a durable message that communicates a state change or a domain fact to other components.
  • Finality: the degree of certainty that a transaction confirmed by a blockchain will not be reverted.
  • Helm chart: a declarative, versioned package for deploying an application and its configuration on Kubernetes.
  • Hot wallet: a wallet whose key is available to a connected service that can sign operations online.
  • Idempotency: the property that lets a request be repeated, or a message be reprocessed, without duplicating its financial effect.
  • Inbox: a record of messages already processed by a consumer, used to detect duplicates.
  • Operational ledger: an append-only record of internal movements and adjustments tied to an operation; it lets you reconstruct amounts, fees, gas, refunds and compensations.
  • Leg / OperationLeg: an independent transaction or stage that is part of a composite operation and keeps its own network, provider, amount, hash and status.
  • Capability manifest: a versioned document that identifies a combination of network, asset, contracts, providers, execution mode, limits and evidence enabled for an environment.
  • OCI: open specifications for packaging and distributing images and other artifacts through compatible registries.
  • Operation: a durable resource that represents a transfer, swap or other financial action and keeps its full lifecycle.
  • Outbox: a persistent table or record where a business change and the event that communicates it are saved in the same transaction.
  • Partner Signer Gateway: a service controlled by the Partner that validates a signing request and uses the key corresponding to the keyReference and the authorized policy.
  • Provider: an external service used to execute or assist a capability, such as an RPC, bundler, paymaster or LI.FI.
  • Private key: a cryptographic secret that lets you produce valid signatures for a blockchain account.
  • RLS (Row-Level Security): PostgreSQL policies that restrict which rows each tenant context can query or modify.
  • RPO (Recovery Point Objective): the maximum acceptable data loss expressed as a time interval.
  • RTO (Recovery Time Objective): the target time to recover service after an interruption.
  • SBOM (Software Bill of Materials): an inventory of components and dependencies included in a software release.
  • Self-hosted: a mode in which a real deployment's runtime is deployed and operated inside the Partner-controlled cloud environment.
  • Self-custody: a model in which the user controls signing authority and no third party can move their funds unilaterally.
  • Tenant: the unit of administrative and data isolation within a deployment.
  • UserOperation: the ERC-4337 structure that describes an action requested by a smart account.
  • Webhook: a signed HTTP notification that ChatterPay sends to the endpoint registered by the Partner.