@keelcodes/settlement 0.1.0

package/dist/a2a.js

@@ -0,0 +1,254 @@
+import { SettlementError, assertCaip2, } from './types.js';
+/**
+ * x402 Payments Extension for the Agent-to-Agent (A2A) protocol, v0.1
+ * (https://github.com/google-a2a/a2a-x402).
+ *
+ * A2A carries payment state in the `metadata` of its `Message` objects under
+ * `x402.payment.*` keys and layers a six-state payment machine on top of the
+ * A2A task state. Keel models the transport-neutral part the extension fixes:
+ * the metadata keys, the status machine, the data structures and the error
+ * codes. The scheme-specific `PaymentPayload.payload` blob stays opaque.
+ *
+ * The v0.1 examples spell `network` as a bare name (`"base"`); Keel requires a
+ * CAIP-2 id (`eip155:8453`) everywhere it carries a chain, and validates it on
+ * the way in.
+ */
+export const A2A_X402_EXTENSION_URI = 'https://github.com/google-a2a/a2a-x402/v0.1';
+/** Clients request extension activation and servers echo it back here. */
+export const A2A_EXTENSIONS_HEADER = 'X-A2A-Extensions';
+/** `Message.metadata` keys defined by the extension. */
+export const A2A_METADATA_KEYS = {
+    status: 'x402.payment.status',
+    required: 'x402.payment.required',
+    payload: 'x402.payment.payload',
+    receipts: 'x402.payment.receipts',
+    error: 'x402.payment.error',
+};
+/**
+ * Legal status transitions. The spec's diagram omits `payment-submitted →
+ * payment-failed`, but §8 requires the server to report `payment-failed` when a
+ * submitted payload fails verification, so that edge is allowed too.
+ */
+const A2A_TRANSITIONS = {
+    'payment-required': ['payment-rejected', 'payment-submitted'],
+    'payment-submitted': ['payment-verified', 'payment-failed'],
+    'payment-verified': ['payment-completed', 'payment-failed'],
+    'payment-rejected': [],
+    'payment-completed': [],
+    'payment-failed': [],
+};
+export function isTerminalA2AStatus(status) {
+    return A2A_TRANSITIONS[status].length === 0;
+}
+export function canTransitionA2A(from, to) {
+    return A2A_TRANSITIONS[from].includes(to);
+}
+/** Guards a status change — an out-of-order status write is a protocol bug. */
+export function assertA2ATransition(from, to) {
+    if (!canTransitionA2A(from, to)) {
+        throw new SettlementError('invalid-transition', `A2A payment cannot go ${from} -> ${to}`);
+    }
+}
+/** Error codes the extension defines for `x402.payment.error`. */
+export const A2A_ERROR_CODES = [
+    'INSUFFICIENT_FUNDS',
+    'INVALID_SIGNATURE',
+    'EXPIRED_PAYMENT',
+    'DUPLICATE_NONCE',
+    'NETWORK_MISMATCH',
+    'INVALID_AMOUNT',
+    'SETTLEMENT_FAILED',
+];
+export function isA2AErrorCode(value) {
+    return A2A_ERROR_CODES.includes(value);
+}
+const STATUS_VALUES = new Set(Object.keys(A2A_TRANSITIONS));
+function requireObject(value, field) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new SettlementError('malformed-payload', `${field} must be an object`);
+    }
+    return value;
+}
+function requireString(value, field) {
+    if (typeof value !== 'string' || value === '') {
+        throw new SettlementError('missing-field', `${field} must be a non-empty string`);
+    }
+    return value;
+}
+function requireInteger(value, field) {
+    if (typeof value !== 'number' || !Number.isInteger(value)) {
+        throw new SettlementError('missing-field', `${field} must be an integer`);
+    }
+    return value;
+}
+function assertA2ARequirement(value, index) {
+    const raw = requireObject(value, `accepts[${index}]`);
+    const amount = requireString(raw['maxAmountRequired'], `accepts[${index}].maxAmountRequired`);
+    if (!/^\d+$/.test(amount)) {
+        throw new SettlementError('malformed-payload', `accepts[${index}].maxAmountRequired must be atomic units, got ${amount}`);
+    }
+    const requirement = {
+        scheme: requireString(raw['scheme'], `accepts[${index}].scheme`),
+        network: assertCaip2(raw['network'], `accepts[${index}].network`),
+        asset: requireString(raw['asset'], `accepts[${index}].asset`),
+        payTo: requireString(raw['payTo'], `accepts[${index}].payTo`),
+        maxAmountRequired: amount,
+    };
+    for (const field of ['resource', 'description']) {
+        const fieldValue = raw[field];
+        if (fieldValue !== undefined)
+            requirement[field] = requireString(fieldValue, `accepts[${index}].${field}`);
+    }
+    const timeout = raw['maxTimeoutSeconds'];
+    if (timeout !== undefined) {
+        if (typeof timeout !== 'number' || !Number.isFinite(timeout)) {
+            throw new SettlementError('malformed-payload', `accepts[${index}].maxTimeoutSeconds must be a number`);
+        }
+        requirement.maxTimeoutSeconds = timeout;
+    }
+    const extra = raw['extra'];
+    if (extra !== undefined)
+        requirement.extra = requireObject(extra, `accepts[${index}].extra`);
+    return requirement;
+}
+/** Parses an `x402PaymentRequiredResponse` (the `x402.payment.required` value). */
+export function parsePaymentRequiredResponse(value) {
+    const raw = requireObject(value, 'x402PaymentRequiredResponse');
+    const x402Version = requireInteger(raw['x402Version'], 'x402PaymentRequiredResponse.x402Version');
+    const accepts = raw['accepts'];
+    if (!Array.isArray(accepts) || accepts.length === 0) {
+        throw new SettlementError('missing-field', 'x402PaymentRequiredResponse.accepts must be a non-empty array');
+    }
+    return { x402Version, accepts: accepts.map((entry, index) => assertA2ARequirement(entry, index)) };
+}
+/** Parses a `PaymentPayload` envelope; the scheme payload stays opaque. */
+export function parsePaymentPayload(value) {
+    const raw = requireObject(value, 'PaymentPayload');
+    return {
+        x402Version: requireInteger(raw['x402Version'], 'PaymentPayload.x402Version'),
+        network: requireString(raw['network'], 'PaymentPayload.network'),
+        scheme: requireString(raw['scheme'], 'PaymentPayload.scheme'),
+        payload: requireObject(raw['payload'], 'PaymentPayload.payload'),
+    };
+}
+/** Parses an `x402SettleResponse` receipt. */
+export function parseSettleResponse(value) {
+    const raw = requireObject(value, 'x402SettleResponse');
+    if (typeof raw['success'] !== 'boolean') {
+        throw new SettlementError('missing-field', 'x402SettleResponse.success must be a boolean');
+    }
+    const response = {
+        success: raw['success'],
+        network: requireString(raw['network'], 'x402SettleResponse.network'),
+    };
+    for (const field of ['transaction', 'payer', 'errorReason']) {
+        const fieldValue = raw[field];
+        if (fieldValue !== undefined) {
+            if (typeof fieldValue !== 'string') {
+                throw new SettlementError('malformed-payload', `x402SettleResponse.${field} must be a string`);
+            }
+            response[field] = fieldValue;
+        }
+    }
+    return response;
+}
+/** Reads the `x402.payment.*` keys out of a message metadata record. */
+export function parsePaymentMetadata(metadata) {
+    const status = metadata[A2A_METADATA_KEYS.status];
+    if (status === undefined) {
+        throw new SettlementError('missing-field', `${A2A_METADATA_KEYS.status} is required`);
+    }
+    if (typeof status !== 'string' || !STATUS_VALUES.has(status)) {
+        throw new SettlementError('malformed-payload', `unknown A2A payment status ${JSON.stringify(status)}`);
+    }
+    const parsed = { status: status };
+    const required = metadata[A2A_METADATA_KEYS.required];
+    if (required !== undefined)
+        parsed.required = parsePaymentRequiredResponse(required);
+    const payload = metadata[A2A_METADATA_KEYS.payload];
+    if (payload !== undefined)
+        parsed.payload = parsePaymentPayload(payload);
+    const receipts = metadata[A2A_METADATA_KEYS.receipts];
+    if (receipts !== undefined) {
+        if (!Array.isArray(receipts)) {
+            throw new SettlementError('malformed-payload', `${A2A_METADATA_KEYS.receipts} must be an array`);
+        }
+        parsed.receipts = receipts.map((entry) => parseSettleResponse(entry));
+    }
+    const error = metadata[A2A_METADATA_KEYS.error];
+    if (error !== undefined)
+        parsed.error = requireString(error, A2A_METADATA_KEYS.error);
+    return parsed;
+}
+/** Serialises the payment fields back into a `Message.metadata` record. */
+export function buildPaymentMetadata(entry) {
+    const metadata = { [A2A_METADATA_KEYS.status]: entry.status };
+    if (entry.required !== undefined)
+        metadata[A2A_METADATA_KEYS.required] = entry.required;
+    if (entry.payload !== undefined)
+        metadata[A2A_METADATA_KEYS.payload] = entry.payload;
+    if (entry.receipts !== undefined)
+        metadata[A2A_METADATA_KEYS.receipts] = entry.receipts;
+    if (entry.error !== undefined)
+        metadata[A2A_METADATA_KEYS.error] = entry.error;
+    return metadata;
+}
+/** Builds the client-side intent from the requirement the client accepted. */
+export function a2aIntent(requirement, args) {
+    const intent = {
+        id: args.id,
+        protocol: 'x402',
+        network: requirement.network,
+        asset: requirement.asset,
+        amount: BigInt(requirement.maxAmountRequired),
+        payer: args.payer,
+        payee: requirement.payTo,
+    };
+    if (args.reference !== undefined)
+        intent.reference = args.reference;
+    if (args.now !== undefined && requirement.maxTimeoutSeconds !== undefined) {
+        intent.expiresAt = new Date(args.now.getTime() + requirement.maxTimeoutSeconds * 1000).toISOString();
+    }
+    return intent;
+}
+/** The anti-tamper gate: a merchant may ask for any `payTo` it likes. */
+export function verifyA2ARequirement(requirement, intent) {
+    const mismatches = [];
+    if (requirement.network !== intent.network) {
+        mismatches.push(`network ${requirement.network} != ${intent.network}`);
+    }
+    if (requirement.asset.toLowerCase() !== intent.asset.toLowerCase()) {
+        mismatches.push(`asset ${requirement.asset} != ${intent.asset}`);
+    }
+    if (requirement.payTo.toLowerCase() !== intent.payee.toLowerCase()) {
+        mismatches.push(`payTo ${requirement.payTo} != ${intent.payee}`);
+    }
+    if (BigInt(requirement.maxAmountRequired) !== intent.amount) {
+        mismatches.push(`maxAmountRequired ${requirement.maxAmountRequired} != ${intent.amount.toString()}`);
+    }
+    if (mismatches.length > 0) {
+        throw new SettlementError('requirement-mismatch', `offered requirement does not match intent ${intent.id}: ${mismatches.join('; ')}`);
+    }
+}
+/** Turns a successful A2A settle response into a receipt, re-checking terms. */
+export function receiptFromA2A(args) {
+    const { intent, requirement, response } = args;
+    if (!response.success) {
+        throw new SettlementError('unsuccessful-settlement', `A2A settlement failed: ${response.errorReason ?? 'no reason given'}`);
+    }
+    verifyA2ARequirement(requirement, intent);
+    return {
+        id: response.transaction ?? `${intent.id}@${args.settledAt}`,
+        protocol: 'x402',
+        network: intent.network,
+        asset: intent.asset,
+        amount: intent.amount,
+        payer: response.payer ?? intent.payer,
+        payee: intent.payee,
+        transaction: response.transaction,
+        settledAt: args.settledAt,
+        intentId: intent.id,
+        proof: { requirement, response },
+    };
+}
+//# sourceMappingURL=a2a.js.map

package/dist/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../src/a2a.ts"],"names":[],"mappings":"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"}

package/dist/erc8183.d.ts

@@ -0,0 +1,108 @@
+import { type Caip2, type SettlementReceipt } from './types.js';
+/**
+ * ERC-8183 (https://eips.ethereum.org/EIPS/eip-8183) — Agentic Commerce: a job
+ * with an escrowed budget and a single evaluator who attests completion.
+ *
+ * State machine: `Open → Funded → Submitted → Completed | Rejected | Expired`,
+ * with a dispute detour: `Funded | Submitted → Disputed → Completed | Rejected`.
+ * This module models the lifecycle the spec fixes — the legal transitions and
+ * *who* may trigger each one — as a pure reducer, so an orchestrator can
+ * validate an action (or fold on-chain events) without a chain client.
+ *
+ * Disputes compose with that machine rather than bypass it: only a party may
+ * raise one, only the arbiter may resolve it, and the resolution is an explicit
+ * `release` (→ `Completed`) or `refund` (→ `Rejected`). A job in `Disputed` has
+ * no path to `complete`/`reject`/`claimRefund`, so arbitration cannot be skipped.
+ *
+ * The spec's `hook` and `optParams` are deliberately absent: hooks are an
+ * optional extension whose callbacks are a chain concern, not core state.
+ */
+export type EscrowJobStatus = 'Open' | 'Funded' | 'Submitted' | 'Disputed' | 'Completed' | 'Rejected' | 'Expired';
+export type EscrowJobAction = 'setProvider' | 'setBudget' | 'fund' | 'submit' | 'complete' | 'reject' | 'raiseDispute' | 'resolveDispute' | 'claimRefund';
+export type EscrowRole = 'client' | 'provider' | 'evaluator' | 'arbiter';
+/** How arbitration settles a disputed escrow. */
+export type EscrowResolution = 'release' | 'refund';
+/** `provider` is unset until `setProvider`; the spec uses `address(0)`. */
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export interface EscrowJob {
+    id: string;
+    client: string;
+    provider: string;
+    evaluator: string;
+    /** Third party who resolves disputes; unset until configured. */
+    arbiter?: string;
+    description: string;
+    /** Atomic units of the escrowed ERC-20. */
+    budget: bigint;
+    /** Unix seconds; anyone may refund once `now >= expiredAt`. */
+    expiredAt: number;
+    status: EscrowJobStatus;
+    hook?: string;
+    /** `submit` payload — a hash/CID/commitment to the delivered work. */
+    deliverable?: string;
+    /** Attestation reason carried by `complete` / `reject` / `resolveDispute`. */
+    reason?: string;
+    /** Why a party raised the dispute; set by `raiseDispute`. */
+    disputeReason?: string;
+    /** How arbitration settled the job; set by `resolveDispute`. */
+    resolution?: EscrowResolution;
+}
+export declare function isTerminalJobStatus(status: EscrowJobStatus): boolean;
+export declare function isProviderSet(job: EscrowJob): boolean;
+export declare function isArbiterSet(job: EscrowJob): boolean;
+/**
+ * Who may trigger an action given the job's current status. `reject` moves
+ * between roles: the client rejects while `Open`, the evaluator afterwards.
+ *
+ * A dispute may be raised by any party to the job (client, provider or
+ * evaluator) but resolved only by the arbiter — that separation is what makes
+ * arbitration meaningful rather than a party ruling on its own case.
+ */
+export declare function allowedActors(job: EscrowJob, action: EscrowJobAction): readonly EscrowRole[] | 'anyone';
+export declare function canApplyJobAction(job: EscrowJob, action: EscrowJobAction, actor: string): boolean;
+export interface EscrowActionInput {
+    actor: string;
+    /** Unix seconds; required for `claimRefund`, which is time-gated. */
+    now?: number;
+    /** `setProvider`. */
+    provider?: string;
+    /** `setBudget` — atomic units. */
+    amount?: bigint;
+    /** `fund` — the budget the client is willing to escrow (front-run guard). */
+    expectedBudget?: bigint;
+    /** `submit`. */
+    deliverable?: string;
+    /** `complete` / `reject` / `raiseDispute` / `resolveDispute`. */
+    reason?: string;
+    /** `resolveDispute` — release the escrow to the provider, or refund the client. */
+    outcome?: EscrowResolution;
+}
+/**
+ * Applies one action, returning the next job state. Pure: the caller decides
+ * whether the job is local state or a projection of on-chain events.
+ */
+export declare function applyJobAction(job: EscrowJob, action: EscrowJobAction, input: EscrowActionInput): EscrowJob;
+/**
+ * How escrow moves on a terminal status: released to the provider on
+ * `Completed`, refunded to the client on `Rejected` / `Expired`.
+ *
+ * A dispute resolved to `release` lands on `Completed` and one resolved to
+ * `refund` lands on `Rejected`, so the outcome of arbitration is read here just
+ * like any other settlement. `Disputed` itself moves nothing — it is not
+ * terminal.
+ */
+export declare function escrowOutcome(status: EscrowJobStatus): 'release' | 'refund' | 'none';
+export interface EscrowReceiptArgs {
+    network: Caip2;
+    asset: string;
+    /** ISO-8601 timestamp of settlement. */
+    settledAt: string;
+    transaction?: string;
+}
+/**
+ * Receipt for a completed job — the escrow released to the provider. A dispute
+ * resolved to `release` yields the same receipt; its `proof.resolution` records
+ * that the release came via arbitration rather than the evaluator's attestation.
+ */
+export declare function receiptFromEscrow(job: EscrowJob, args: EscrowReceiptArgs): SettlementReceipt;
+//# sourceMappingURL=erc8183.d.ts.map

package/dist/erc8183.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc8183.d.ts","sourceRoot":"","sources":["../src/erc8183.ts"],"names":[],"mappings":"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"}

package/dist/erc8183.js

@@ -0,0 +1,206 @@
+import { SettlementError } from './types.js';
+/** `provider` is unset until `setProvider`; the spec uses `address(0)`. */
+export const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+const TRANSITIONS = {
+    Open: ['setProvider', 'setBudget', 'fund', 'reject'],
+    Funded: ['submit', 'reject', 'raiseDispute', 'claimRefund'],
+    Submitted: ['complete', 'reject', 'raiseDispute', 'claimRefund'],
+    Disputed: ['resolveDispute'],
+    Completed: [],
+    Rejected: [],
+    Expired: [],
+};
+const TERMINAL = ['Completed', 'Rejected', 'Expired'];
+export function isTerminalJobStatus(status) {
+    return TERMINAL.includes(status);
+}
+export function isProviderSet(job) {
+    const provider = job.provider.toLowerCase();
+    return provider !== '' && provider !== ZERO_ADDRESS;
+}
+export function isArbiterSet(job) {
+    const arbiter = (job.arbiter ?? '').toLowerCase();
+    return arbiter !== '' && arbiter !== ZERO_ADDRESS;
+}
+/**
+ * Who may trigger an action given the job's current status. `reject` moves
+ * between roles: the client rejects while `Open`, the evaluator afterwards.
+ *
+ * A dispute may be raised by any party to the job (client, provider or
+ * evaluator) but resolved only by the arbiter — that separation is what makes
+ * arbitration meaningful rather than a party ruling on its own case.
+ */
+export function allowedActors(job, action) {
+    switch (action) {
+        case 'setProvider':
+            return ['client'];
+        case 'setBudget':
+            return ['client', 'provider'];
+        case 'fund':
+            return ['client'];
+        case 'submit':
+            return ['provider'];
+        case 'complete':
+            return ['evaluator'];
+        case 'reject':
+            return job.status === 'Open' ? ['client'] : ['evaluator'];
+        case 'raiseDispute':
+            return ['client', 'provider', 'evaluator'];
+        case 'resolveDispute':
+            return ['arbiter'];
+        case 'claimRefund':
+            return 'anyone';
+    }
+}
+function addressOf(job, role) {
+    if (role === 'client')
+        return job.client;
+    if (role === 'provider')
+        return job.provider;
+    if (role === 'arbiter')
+        return job.arbiter ?? '';
+    return job.evaluator;
+}
+function actorAllowed(job, action, actor) {
+    const actors = allowedActors(job, action);
+    if (actors === 'anyone')
+        return true;
+    const address = actor.toLowerCase();
+    return actors.some((role) => addressOf(job, role).toLowerCase() === address);
+}
+export function canApplyJobAction(job, action, actor) {
+    return TRANSITIONS[job.status].includes(action) && actorAllowed(job, action, actor);
+}
+function requireAddress(value, field) {
+    if (typeof value !== 'string' || value === '') {
+        throw new SettlementError('missing-field', `${field} must be a non-empty address`);
+    }
+    return value;
+}
+/**
+ * Applies one action, returning the next job state. Pure: the caller decides
+ * whether the job is local state or a projection of on-chain events.
+ */
+export function applyJobAction(job, action, input) {
+    if (!TRANSITIONS[job.status].includes(action)) {
+        throw new SettlementError('invalid-transition', `job ${job.id} is ${job.status}; cannot ${action}`);
+    }
+    if (!actorAllowed(job, action, input.actor)) {
+        throw new SettlementError('unauthorized-actor', `${action} is not allowed for ${input.actor} on job ${job.id} (${job.status})`);
+    }
+    switch (action) {
+        case 'setProvider': {
+            if (isProviderSet(job)) {
+                throw new SettlementError('precondition-failed', `job ${job.id} already has a provider`);
+            }
+            return { ...job, provider: requireAddress(input.provider, 'provider') };
+        }
+        case 'setBudget': {
+            if (input.amount === undefined || input.amount <= 0n) {
+                throw new SettlementError('precondition-failed', `job ${job.id} needs a positive budget`);
+            }
+            return { ...job, budget: input.amount };
+        }
+        case 'fund': {
+            if (!isProviderSet(job)) {
+                throw new SettlementError('precondition-failed', `job ${job.id} has no provider to fund`);
+            }
+            if (job.budget <= 0n) {
+                throw new SettlementError('precondition-failed', `job ${job.id} has no budget to fund`);
+            }
+            if (input.expectedBudget === undefined || input.expectedBudget !== job.budget) {
+                throw new SettlementError('precondition-failed', `fund expectedBudget does not match job ${job.id} budget ${job.budget.toString()}`);
+            }
+            return { ...job, status: 'Funded' };
+        }
+        case 'submit': {
+            const deliverable = input.deliverable;
+            if (typeof deliverable !== 'string' || deliverable === '') {
+                throw new SettlementError('missing-field', `submit needs a deliverable`);
+            }
+            return { ...job, status: 'Submitted', deliverable };
+        }
+        case 'complete':
+            return input.reason === undefined
+                ? { ...job, status: 'Completed' }
+                : { ...job, status: 'Completed', reason: input.reason };
+        case 'reject':
+            return input.reason === undefined
+                ? { ...job, status: 'Rejected' }
+                : { ...job, status: 'Rejected', reason: input.reason };
+        case 'raiseDispute': {
+            // Nothing to arbitrate unless someone is empowered to resolve it.
+            if (!isArbiterSet(job)) {
+                throw new SettlementError('precondition-failed', `job ${job.id} has no arbiter to resolve a dispute`);
+            }
+            if (typeof input.reason !== 'string' || input.reason === '') {
+                throw new SettlementError('missing-field', 'raiseDispute needs a reason');
+            }
+            return { ...job, status: 'Disputed', disputeReason: input.reason };
+        }
+        case 'resolveDispute': {
+            const outcome = input.outcome;
+            if (outcome !== 'release' && outcome !== 'refund') {
+                throw new SettlementError('missing-field', 'resolveDispute needs an outcome of release or refund');
+            }
+            const resolved = {
+                ...job,
+                status: outcome === 'release' ? 'Completed' : 'Rejected',
+                resolution: outcome,
+            };
+            return input.reason === undefined ? resolved : { ...resolved, reason: input.reason };
+        }
+        case 'claimRefund': {
+            if (input.now === undefined || input.now < job.expiredAt) {
+                throw new SettlementError('precondition-failed', `job ${job.id} has not expired`);
+            }
+            return { ...job, status: 'Expired' };
+        }
+    }
+}
+/**
+ * How escrow moves on a terminal status: released to the provider on
+ * `Completed`, refunded to the client on `Rejected` / `Expired`.
+ *
+ * A dispute resolved to `release` lands on `Completed` and one resolved to
+ * `refund` lands on `Rejected`, so the outcome of arbitration is read here just
+ * like any other settlement. `Disputed` itself moves nothing — it is not
+ * terminal.
+ */
+export function escrowOutcome(status) {
+    if (status === 'Completed')
+        return 'release';
+    if (status === 'Rejected' || status === 'Expired')
+        return 'refund';
+    return 'none';
+}
+/**
+ * Receipt for a completed job — the escrow released to the provider. A dispute
+ * resolved to `release` yields the same receipt; its `proof.resolution` records
+ * that the release came via arbitration rather than the evaluator's attestation.
+ */
+export function receiptFromEscrow(job, args) {
+    if (job.status !== 'Completed') {
+        throw new SettlementError('unsuccessful-settlement', `job ${job.id} is ${job.status}, not Completed`);
+    }
+    return {
+        id: args.transaction ?? `${job.id}@${args.settledAt}`,
+        protocol: 'erc8183',
+        network: args.network,
+        asset: args.asset,
+        amount: job.budget,
+        payer: job.client,
+        payee: job.provider,
+        transaction: args.transaction,
+        settledAt: args.settledAt,
+        intentId: job.id,
+        proof: {
+            jobId: job.id,
+            deliverable: job.deliverable,
+            reason: job.reason,
+            resolution: job.resolution,
+            disputeReason: job.disputeReason,
+        },
+    };
+}
+//# sourceMappingURL=erc8183.js.map

package/dist/erc8183.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc8183.js","sourceRoot":"","sources":["../src/erc8183.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { authScheme, base64Decode, base64Encode, decodeJsonPayload, encodeJsonPayload, formatAuthHeader, parseAuthHeader, } from './wire.js';
+export type { AuthHeader } from './wire.js';
+export { MPP_RECEIPT_HEADER, MPP_SCHEME, MPP_STATUS, classifyMppResponse, decodeMppRequest, encodeMppRequest, formatCredential, formatWwwAuthenticate, mppIntent, parseCredential, parseWwwAuthenticate, } from './mpp.js';
+export type { MppChallenge, MppCredential, MppIntentArgs, MppProblemCode, MppResponseKind, } from './mpp.js';
+export { X402_HEADERS, X402_VERSION, encodePaymentSignature, formatPaymentRequired, formatSettlementResponse, intentFromRequirement, parsePaymentRequired, parsePaymentSignature, parseSettlementResponse, selectRequirement, verifyRequirement, } from './x402.js';
+export type { IntentFromRequirementArgs, RequirementFilter, X402PaymentRequired, X402Requirements, X402Resource, X402SettlementResponse, } from './x402.js';
+export { A2A_ERROR_CODES, A2A_EXTENSIONS_HEADER, A2A_METADATA_KEYS, A2A_X402_EXTENSION_URI, a2aIntent, assertA2ATransition, buildPaymentMetadata, canTransitionA2A, isA2AErrorCode, isTerminalA2AStatus, parsePaymentMetadata, parsePaymentPayload, parsePaymentRequiredResponse, parseSettleResponse, receiptFromA2A, verifyA2ARequirement, } from './a2a.js';
+export type { A2AErrorCode, A2AIntentArgs, A2APaymentMetadata, A2APaymentPayload, A2APaymentRequiredResponse, A2APaymentRequirements, A2APaymentStatus, A2AReceiptArgs, A2ASettleResponse, } from './a2a.js';
+export { ZERO_ADDRESS, applyJobAction, allowedActors, canApplyJobAction, escrowOutcome, isArbiterSet, isProviderSet, isTerminalJobStatus, receiptFromEscrow, } from './erc8183.js';
+export type { EscrowActionInput, EscrowJob, EscrowJobAction, EscrowJobStatus, EscrowReceiptArgs, EscrowResolution, EscrowRole, } from './erc8183.js';
+export { RAIL_KIND_ORDER, formatUnits, parseUnits, resolveRailAsset, selectRail, } from './rails.js';
+export type { PaymentRail, RailAsset, RailConstraints, RailKind, RailSelection, RoutePlan, } from './rails.js';
+export { receiptFromMpp, receiptFromX402 } from './receipts.js';
+export type { MppReceiptArgs, X402ReceiptArgs } from './receipts.js';
+export { Ledger } from './ledger.js';
+export type { AssetRef } from './ledger.js';
+export { WebhookDispatcher, matchesWebhook, webhookEventFromLedgerEvent } from './webhooks.js';
+export type { WebhookAttempt, WebhookDelivery, WebhookDispatcherOptions, WebhookEvent, WebhookEventType, WebhookRequest, WebhookResponse, WebhookSigner, WebhookSubscription, WebhookTransport, } from './webhooks.js';
+export { SettlementError, assertCaip2, isCaip2 } from './types.js';
+export type { Caip2, IntentStatus, LedgerEntry, LedgerEvent, PaymentIntent, Protocol, Reconciliation, SettlementErrorCode, SettlementReceipt, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { authScheme, base64Decode, base64Encode, decodeJsonPayload, encodeJsonPayload, formatAuthHeader, parseAuthHeader, } from './wire.js';
+export { MPP_RECEIPT_HEADER, MPP_SCHEME, MPP_STATUS, classifyMppResponse, decodeMppRequest, encodeMppRequest, formatCredential, formatWwwAuthenticate, mppIntent, parseCredential, parseWwwAuthenticate, } from './mpp.js';
+export { X402_HEADERS, X402_VERSION, encodePaymentSignature, formatPaymentRequired, formatSettlementResponse, intentFromRequirement, parsePaymentRequired, parsePaymentSignature, parseSettlementResponse, selectRequirement, verifyRequirement, } from './x402.js';
+export { A2A_ERROR_CODES, A2A_EXTENSIONS_HEADER, A2A_METADATA_KEYS, A2A_X402_EXTENSION_URI, a2aIntent, assertA2ATransition, buildPaymentMetadata, canTransitionA2A, isA2AErrorCode, isTerminalA2AStatus, parsePaymentMetadata, parsePaymentPayload, parsePaymentRequiredResponse, parseSettleResponse, receiptFromA2A, verifyA2ARequirement, } from './a2a.js';
+export { ZERO_ADDRESS, applyJobAction, allowedActors, canApplyJobAction, escrowOutcome, isArbiterSet, isProviderSet, isTerminalJobStatus, receiptFromEscrow, } from './erc8183.js';
+export { RAIL_KIND_ORDER, formatUnits, parseUnits, resolveRailAsset, selectRail, } from './rails.js';
+export { receiptFromMpp, receiptFromX402 } from './receipts.js';
+export { Ledger } from './ledger.js';
+export { WebhookDispatcher, matchesWebhook, webhookEventFromLedgerEvent } from './webhooks.js';
+export { SettlementError, assertCaip2, isCaip2 } from './types.js';
+//# sourceMappingURL=index.js.map