Skip to content
ContractSpec
Start here

Package manual · domains

·Billing, finance and economic evidence

lib.crypto-payments-spec

Provider-neutral crypto wallet governance and HTTP-native agent payment protocol contracts.

domainslibraryv2.0.4experimentalservernode
@lssm-tech/lib.crypto-payments-spec
bun add @lssm-tech/lib.crypto-payments-spec
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Provider-neutral contracts for crypto wallet governance and HTTP-native agent/API payment protocol evidence.

This package closes the first canonical ContractSpec slice for wallet-governed agent payments. It defines reviewable contracts for wallet policies, HTTP payment challenges, agent payment authorizations, settlement evidence refs, failure/idempotency semantics, and CompanyOS/finance-ops/assurance approval composition. It does not sign, custody, broadcast, settle, or call provider SDKs.

Scope

Use this package to model:

  • wallet refs, custody modes, signer-policy refs, chain/network refs, asset refs, spend limits, allowlists, revocation, and rotation;
  • HTTP 402 Payment Required and x402-style payment challenge metadata;
  • agent payment authorizations that require CompanyOS authority, finance-ops spend policy/approval, and assurance evidence;
  • settlement, failure, refund, dispute, replay, and audit evidence refs;
  • x420 as an opaque placeholder/variant reference only until primary-source semantics are reviewed.

Boundary

BillingOS owns quote-to-cash artifacts such as quotes, orders, invoices, payments, refunds, write-offs, and reconciliation. Crypto payments may reference those artifacts but must not redefine or execute them. Provider-payment integrations own concrete SDK/runtime execution and must depend on this contract surface rather than inventing their own policy envelope.

This package never stores private keys, seed phrases, API keys, bearer tokens, webhook secrets, provider secrets, raw signatures, or executable transfer instructions.

Public entrypoints

  • @lssm-tech/lib.crypto-payments-spec — root barrel
  • @lssm-tech/lib.crypto-payments-spec/types — contract schemas and types
  • @lssm-tech/lib.crypto-payments-spec/validation — semantic validation helpers
  • @lssm-tech/lib.crypto-payments-spec/fixtures — safe synthetic fixtures

Commands

  • bun run test
  • bun run typecheck
  • bun run lint:check
  • bun run build

Relationships

THIS PACKAGElib.crypto-payments-spec8 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

1 declarations

  • zod

    catalog:

Declared capabilities

Lib Crypto Payments Spec

Provider-neutral crypto wallet governance and HTTP-native agent payment protocol contracts.

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • testbun test
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit