@paysentry/core

Core types, configuration, and shared utilities for PaySentry — the open-source control plane for AI agent payments.

Install

``bash
npm install @paysentry/core
`

Usage

`typescript
import { createTransaction, type AgentTransaction } from '@paysentry/core';

const tx = createTransaction({
agentId: 'research-agent',
recipient: 'https://api.provider.com/data',
amount: 0.05,
currency: 'USDC',
purpose: 'Market data API call',
protocol: 'x402',
});
`

What's included

| Export | Description |
|--------|-------------|
| AgentTransaction | Protocol-agnostic transaction type |
| PaymentProtocol | 'x402' \| 'acp' \| 'ap2' \| 'stripe' |
| TransactionStatus | Lifecycle states |
| PolicyResult | Policy evaluation result |
| createTransaction() | Factory with defaults + ID generation |
| validateTransaction()` | Runtime validation |

Part of PaySentry

This is one of 5 packages in the PaySentry monorepo:

- @paysentry/core — Types & utilities (this package)
- @paysentry/observe — Spend tracking, analytics, alerts
- @paysentry/control — Policy engine, spending limits, approval workflows
- @paysentry/protect — Provenance, disputes, recovery
- @paysentry/sandbox — Mock protocols for testing without real money

License

MIT