lib.crypto-payments-spec
Provider-neutral crypto wallet governance and HTTP-native agent payment protocol contracts.
@lssm-tech/lib.crypto-payments-specbun add @lssm-tech/lib.crypto-payments-specManifest 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 Requiredand 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 testbun run typecheckbun run lint:checkbun run build
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
1 declarations
zodcatalog:
Declared capabilities
Provider-neutral crypto wallet governance and HTTP-native agent payment protocol contracts.
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit