@x402jp/delivery-receipt-seller 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,3 @@
1
- # Temporary Holding Version
1
+ # @x402jp/delivery-receipt-seller
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ x402 の Delivery Receipt(売り手側の署名・記録・再取得の処理)。使い方・仕様は https://github.com/kato9292929/delivery-receipt を参照。
@@ -0,0 +1,54 @@
1
+ import type { ChainVerifier, FindPaymentInput, FindPaymentResult } from "./types.js";
2
+ /** keccak256("AuthorizationUsed(address,bytes32)") */
3
+ export declare const AUTHORIZATION_USED_TOPIC = "0x98de503528ee59b575ef0c0a2576a82497bfc029a5685b209e9ec333479b10a5";
4
+ /** keccak256("Transfer(address,address,uint256)") */
5
+ export declare const ERC20_TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
6
+ export declare const DEFAULT_SOLANA_RPC_URL = "https://api.mainnet-beta.solana.com";
7
+ export declare const DEFAULT_BASE_RPC_URL = "https://mainnet.base.org";
8
+ type FetchFn = typeof fetch;
9
+ export interface RpcVerifierOptions {
10
+ rpcUrl?: string;
11
+ fetch?: FetchFn;
12
+ timeoutMs?: number;
13
+ }
14
+ /**
15
+ * Solana: getTransaction(payment_id, jsonParsed). Settled when the tx succeeded,
16
+ * contains the payer's signature, and the payTo owner / token account received
17
+ * at least `amount` of `asset` (computed from pre/post token balances).
18
+ */
19
+ export declare class SolanaRpcVerifier implements ChainVerifier {
20
+ private readonly rpcUrl;
21
+ private readonly fetchFn;
22
+ private readonly timeoutMs;
23
+ constructor(opts?: RpcVerifierOptions);
24
+ findPayment(input: FindPaymentInput): Promise<FindPaymentResult>;
25
+ }
26
+ export interface BaseRpcVerifierOptions extends RpcVerifierOptions {
27
+ /** How far back to search for the AuthorizationUsed log (default ~8 days of 2s blocks). */
28
+ lookbackBlocks?: number;
29
+ /** Max block span per eth_getLogs call (default 10000). */
30
+ chunkBlocks?: number;
31
+ }
32
+ /**
33
+ * EVM (Base): find USDC `AuthorizationUsed(authorizer, nonce)` via eth_getLogs
34
+ * (newest blocks first, in chunks), confirm the same tx moved >= amount from the
35
+ * payer to payTo, then read the block timestamp.
36
+ */
37
+ export declare class BaseRpcVerifier implements ChainVerifier {
38
+ private readonly rpcUrl;
39
+ private readonly fetchFn;
40
+ private readonly timeoutMs;
41
+ private readonly lookback;
42
+ private readonly chunk;
43
+ constructor(opts?: BaseRpcVerifierOptions);
44
+ private rpc;
45
+ findPayment(input: FindPaymentInput): Promise<FindPaymentResult>;
46
+ }
47
+ export interface DefaultChainVerifierOptions {
48
+ solanaRpcUrl?: string;
49
+ baseRpcUrl?: string;
50
+ fetch?: FetchFn;
51
+ }
52
+ /** Dispatch by network: Solana mainnet/devnet -> SolanaRpcVerifier, eip155:8453 -> BaseRpcVerifier. */
53
+ export declare function createDefaultChainVerifier(opts?: DefaultChainVerifierOptions): ChainVerifier;
54
+ export {};
package/dist/chain.js ADDED
@@ -0,0 +1,135 @@
1
+ import { isEvmNetwork, isSolanaNetwork, evmChainId, normalizeNetwork } from "./payment.js";
2
+ /** keccak256("AuthorizationUsed(address,bytes32)") */
3
+ export const AUTHORIZATION_USED_TOPIC = "0x98de503528ee59b575ef0c0a2576a82497bfc029a5685b209e9ec333479b10a5";
4
+ /** keccak256("Transfer(address,address,uint256)") */
5
+ export const ERC20_TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
6
+ export const DEFAULT_SOLANA_RPC_URL = "https://api.mainnet-beta.solana.com";
7
+ export const DEFAULT_BASE_RPC_URL = "https://mainnet.base.org";
8
+ async function jsonRpc(fetchFn, url, method, params, timeoutMs) {
9
+ const res = await fetchFn(url, {
10
+ method: "POST",
11
+ headers: { "content-type": "application/json" },
12
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
13
+ signal: AbortSignal.timeout(timeoutMs),
14
+ });
15
+ if (!res.ok)
16
+ throw new Error(`${method}: HTTP ${res.status}`);
17
+ const out = (await res.json());
18
+ if (out.error)
19
+ throw new Error(`${method}: ${out.error.message ?? "rpc error"}`);
20
+ return out.result;
21
+ }
22
+ /**
23
+ * Solana: getTransaction(payment_id, jsonParsed). Settled when the tx succeeded,
24
+ * contains the payer's signature, and the payTo owner / token account received
25
+ * at least `amount` of `asset` (computed from pre/post token balances).
26
+ */
27
+ export class SolanaRpcVerifier {
28
+ rpcUrl;
29
+ fetchFn;
30
+ timeoutMs;
31
+ constructor(opts = {}) {
32
+ this.rpcUrl = opts.rpcUrl || process.env.SOLANA_RPC_URL || DEFAULT_SOLANA_RPC_URL;
33
+ this.fetchFn = opts.fetch ?? fetch;
34
+ this.timeoutMs = opts.timeoutMs ?? 5000;
35
+ }
36
+ async findPayment(input) {
37
+ const tx = await jsonRpc(this.fetchFn, this.rpcUrl, "getTransaction", [input.payment_id, { encoding: "jsonParsed", maxSupportedTransactionVersion: 0, commitment: "confirmed" }], this.timeoutMs);
38
+ if (!tx || !tx.meta || tx.meta.err !== null || !tx.transaction)
39
+ return { settled: false };
40
+ const sigs = tx.transaction.signatures;
41
+ if (sigs[0] !== input.payment_id || !sigs.includes(input.payer))
42
+ return { settled: false };
43
+ const keys = tx.transaction.message.accountKeys.map((k) => (typeof k === "string" ? k : k.pubkey));
44
+ const pre = new Map();
45
+ for (const b of tx.meta.preTokenBalances ?? []) {
46
+ if (b.mint === input.asset)
47
+ pre.set(b.accountIndex, BigInt(b.uiTokenAmount.amount));
48
+ }
49
+ let received = 0n;
50
+ for (const b of tx.meta.postTokenBalances ?? []) {
51
+ if (b.mint !== input.asset)
52
+ continue;
53
+ if (b.owner !== input.payTo && keys[b.accountIndex] !== input.payTo)
54
+ continue;
55
+ received += BigInt(b.uiTokenAmount.amount) - (pre.get(b.accountIndex) ?? 0n);
56
+ }
57
+ if (received < BigInt(input.amount))
58
+ return { settled: false };
59
+ return { settled: true, at: tx.blockTime ? new Date(tx.blockTime * 1000) : undefined };
60
+ }
61
+ }
62
+ const pad32 = (addr) => "0x" + addr.toLowerCase().replace(/^0x/, "").padStart(64, "0");
63
+ /**
64
+ * EVM (Base): find USDC `AuthorizationUsed(authorizer, nonce)` via eth_getLogs
65
+ * (newest blocks first, in chunks), confirm the same tx moved >= amount from the
66
+ * payer to payTo, then read the block timestamp.
67
+ */
68
+ export class BaseRpcVerifier {
69
+ rpcUrl;
70
+ fetchFn;
71
+ timeoutMs;
72
+ lookback;
73
+ chunk;
74
+ constructor(opts = {}) {
75
+ this.rpcUrl = opts.rpcUrl || process.env.BASE_RPC_URL || DEFAULT_BASE_RPC_URL;
76
+ this.fetchFn = opts.fetch ?? fetch;
77
+ this.timeoutMs = opts.timeoutMs ?? 5000;
78
+ this.lookback = opts.lookbackBlocks ?? 350_000;
79
+ this.chunk = opts.chunkBlocks ?? 10_000;
80
+ }
81
+ rpc(method, params) {
82
+ return jsonRpc(this.fetchFn, this.rpcUrl, method, params, this.timeoutMs);
83
+ }
84
+ async findPayment(input) {
85
+ const latest = BigInt(await this.rpc("eth_blockNumber", []));
86
+ const floor = latest > BigInt(this.lookback) ? latest - BigInt(this.lookback) : 0n;
87
+ let found;
88
+ for (let to = latest; to >= floor && !found; to -= BigInt(this.chunk)) {
89
+ const from = to - BigInt(this.chunk) + 1n > floor ? to - BigInt(this.chunk) + 1n : floor;
90
+ const logs = await this.rpc("eth_getLogs", [
91
+ {
92
+ address: input.asset,
93
+ topics: [AUTHORIZATION_USED_TOPIC, pad32(input.payer), input.payment_id.toLowerCase()],
94
+ fromBlock: "0x" + from.toString(16),
95
+ toBlock: "0x" + to.toString(16),
96
+ },
97
+ ]);
98
+ found = logs[0];
99
+ if (from === floor)
100
+ break;
101
+ }
102
+ if (!found)
103
+ return { settled: false };
104
+ const receipt = await this.rpc("eth_getTransactionReceipt", [
105
+ found.transactionHash,
106
+ ]);
107
+ if (!receipt || receipt.status !== "0x1")
108
+ return { settled: false };
109
+ const paid = receipt.logs.some((l) => l.address.toLowerCase() === input.asset.toLowerCase() &&
110
+ l.topics[0] === ERC20_TRANSFER_TOPIC &&
111
+ l.topics[1]?.toLowerCase() === pad32(input.payer) &&
112
+ l.topics[2]?.toLowerCase() === pad32(input.payTo) &&
113
+ BigInt(l.data) >= BigInt(input.amount));
114
+ if (!paid)
115
+ return { settled: false };
116
+ const block = await this.rpc("eth_getBlockByNumber", [found.blockNumber, false]);
117
+ return { settled: true, at: block ? new Date(Number(BigInt(block.timestamp)) * 1000) : undefined };
118
+ }
119
+ }
120
+ /** Dispatch by network: Solana mainnet/devnet -> SolanaRpcVerifier, eip155:8453 -> BaseRpcVerifier. */
121
+ export function createDefaultChainVerifier(opts = {}) {
122
+ const solana = new SolanaRpcVerifier({ rpcUrl: opts.solanaRpcUrl, fetch: opts.fetch });
123
+ const base = new BaseRpcVerifier({ rpcUrl: opts.baseRpcUrl, fetch: opts.fetch });
124
+ return {
125
+ async findPayment(input) {
126
+ const network = normalizeNetwork(input.network);
127
+ if (isSolanaNetwork(network))
128
+ return solana.findPayment(input);
129
+ if (isEvmNetwork(network) && evmChainId(network) === 8453)
130
+ return base.findPayment(input);
131
+ throw new Error(`no default chain verifier for ${network}`);
132
+ },
133
+ };
134
+ }
135
+ //# sourceMappingURL=chain.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}
package/dist/core.d.ts ADDED
@@ -0,0 +1,88 @@
1
+ import { type Delivery, type Receipt, type WellKnown } from "@x402jp/delivery-receipt-verify";
2
+ import type { ChainVerifier, DeliveryRecord, GeneratedBody, PaymentRequirement, ReceiptStore, SellerResponse, SettleResponse } from "./types.js";
3
+ export interface PreviousKey {
4
+ key_id: string;
5
+ /** base64url raw 32-byte Ed25519 public key */
6
+ public_key: string;
7
+ /** ISO 8601; receipts issued at/after this instant are rejected by verifiers. */
8
+ revoked_at?: string;
9
+ }
10
+ export interface ReceiptSellerOptions {
11
+ /** base64/base64url 32-byte Ed25519 seed or PKCS8 PEM. Default: process.env.RECEIPT_SIGNING_KEY. */
12
+ signingKey?: string;
13
+ /** Default: process.env.RECEIPT_KEY_ID, else first 16 hex of sha256(public key). */
14
+ keyId?: string;
15
+ /** Older keys kept in the well-known document (optionally revoked). */
16
+ previousKeys?: PreviousKey[];
17
+ store: ReceiptStore;
18
+ /** Seconds; default 604800 (7 days); values below 86400 are rejected. */
19
+ refetchWindowS?: number;
20
+ /** Default: Solana/Base JSON-RPC verifiers (SOLANA_RPC_URL / BASE_RPC_URL). */
21
+ chain?: ChainVerifier;
22
+ solanaRpcUrl?: string;
23
+ baseRpcUrl?: string;
24
+ now?: () => Date;
25
+ /** Called on non-fatal errors (e.g. store write failure). Default: console.error. */
26
+ onError?: (err: unknown, context: string) => void;
27
+ }
28
+ export interface IssueReceiptInput {
29
+ payment_id: string;
30
+ network: string;
31
+ resource: string;
32
+ body: Uint8Array;
33
+ delivery: Delivery;
34
+ issuedAt?: Date;
35
+ }
36
+ export interface FirstDeliveryInput {
37
+ requirement: PaymentRequirement;
38
+ resource: string;
39
+ /** Raw PAYMENT-SIGNATURE / X-PAYMENT header of the paid request. */
40
+ paymentHeader: string | null;
41
+ /** Decoded PAYMENT-RESPONSE / X-PAYMENT-RESPONSE header. */
42
+ settle: SettleResponse | null;
43
+ body: Uint8Array;
44
+ contentType: string;
45
+ }
46
+ export interface PreparedDelivery {
47
+ record: DeliveryRecord;
48
+ receipt: Receipt;
49
+ /** Value for the X-Delivery-Receipt header. */
50
+ header: string;
51
+ }
52
+ export interface RefetchRequest {
53
+ /** Raw PAYMENT-SIGNATURE / X-PAYMENT header re-sent by the buyer. */
54
+ paymentHeader: string | null;
55
+ /** Value of X-Payment-Refetch. */
56
+ paymentId: string;
57
+ resource: string;
58
+ requirement: PaymentRequirement;
59
+ /** Calls the real handler (without payment) for the chain path. */
60
+ generate: () => Promise<GeneratedBody>;
61
+ }
62
+ export interface ReceiptSeller {
63
+ readonly keyId: string;
64
+ /** base64url raw Ed25519 public key */
65
+ readonly publicKey: string;
66
+ readonly refetchWindowS: number;
67
+ /** Store TTL: refetchWindowS + 1 day grace, so an expired refetch still finds its record and gets 410. */
68
+ readonly retentionS: number;
69
+ readonly store: ReceiptStore;
70
+ readonly chain: ChainVerifier;
71
+ /** The /.well-known/x402-receipt.json document. */
72
+ wellKnown(): WellKnown;
73
+ /** Sign a receipt for exactly these body bytes. */
74
+ issueReceipt(input: IssueReceiptInput): {
75
+ receipt: Receipt;
76
+ header: string;
77
+ };
78
+ /** Derive payment_id / payer and build record + receipt for a settled first delivery (no I/O). */
79
+ prepareFirstDelivery(input: FirstDeliveryInput): PreparedDelivery | null;
80
+ /** prepareFirstDelivery + store.put. Returns null (and reports via onError) when nothing could be recorded. */
81
+ recordFirstDelivery(input: FirstDeliveryInput): Promise<PreparedDelivery | null>;
82
+ /** Serve a refetch. Never touches the facilitator (/verify, /settle). */
83
+ handleRefetch(input: RefetchRequest): Promise<SellerResponse>;
84
+ }
85
+ /** Extra retention beyond the refetch window. */
86
+ export declare const RETENTION_GRACE_S = 86400;
87
+ export declare const EXPOSE_HEADERS: string;
88
+ export declare function createReceiptSeller(opts: ReceiptSellerOptions): ReceiptSeller;
package/dist/core.js ADDED
@@ -0,0 +1,251 @@
1
+ import { DEFAULT_REFETCH_WINDOW_S, MIN_REFETCH_WINDOW_S, RECEIPT_HEADER, REFETCH_HEADER, encodeReceipt, sha256Hex, } from "@x402jp/delivery-receipt-verify";
2
+ import { createDefaultChainVerifier } from "./chain.js";
3
+ import { deriveKeyId, loadSigningKey, signPayload } from "./keys.js";
4
+ import { checkEvmSigner, decodePaymentHeader, getEvmAuthorization, isEvmNetwork, isSolanaNetwork, normalizeNetwork, solanaPayerSignatures, } from "./payment.js";
5
+ /** Extra retention beyond the refetch window. */
6
+ export const RETENTION_GRACE_S = 86_400;
7
+ export const EXPOSE_HEADERS = [RECEIPT_HEADER, "PAYMENT-RESPONSE", "X-PAYMENT-RESPONSE"].join(", ");
8
+ function jsonResponse(status, obj) {
9
+ return {
10
+ status,
11
+ headers: { "content-type": "application/json", "cache-control": "no-store", "access-control-expose-headers": EXPOSE_HEADERS },
12
+ body: new Uint8Array(Buffer.from(JSON.stringify(obj))),
13
+ };
14
+ }
15
+ const refused = (detail) => jsonResponse(402, { error: "refetch_refused", detail });
16
+ const expired = () => jsonResponse(410, { error: "refetch_expired" });
17
+ export function createReceiptSeller(opts) {
18
+ const keyInput = opts.signingKey ?? process.env.RECEIPT_SIGNING_KEY;
19
+ if (!keyInput || keyInput.trim() === "")
20
+ throw new Error("RECEIPT_SIGNING_KEY is not set");
21
+ const key = loadSigningKey(keyInput);
22
+ const keyId = opts.keyId || process.env.RECEIPT_KEY_ID || deriveKeyId(key.publicKeyRaw);
23
+ const refetchWindowS = opts.refetchWindowS ?? DEFAULT_REFETCH_WINDOW_S;
24
+ if (!Number.isFinite(refetchWindowS) || refetchWindowS < MIN_REFETCH_WINDOW_S) {
25
+ throw new Error(`refetchWindowS must be >= ${MIN_REFETCH_WINDOW_S}`);
26
+ }
27
+ const retentionS = refetchWindowS + RETENTION_GRACE_S;
28
+ if (!opts.store)
29
+ throw new Error("store is required");
30
+ const store = opts.store;
31
+ const chain = opts.chain ?? createDefaultChainVerifier({ solanaRpcUrl: opts.solanaRpcUrl, baseRpcUrl: opts.baseRpcUrl });
32
+ const now = opts.now ?? (() => new Date());
33
+ const onError = opts.onError ?? ((err, ctx) => console.error(`[delivery-receipt] ${ctx}:`, err));
34
+ const previousKeys = (opts.previousKeys ?? []).filter((k) => k.key_id !== keyId);
35
+ const isExpired = (anchor) => now().getTime() - anchor.getTime() > refetchWindowS * 1000;
36
+ function issueReceipt(input) {
37
+ const payload = {
38
+ v: 1,
39
+ payment_id: input.payment_id,
40
+ network: normalizeNetwork(input.network),
41
+ resource: input.resource,
42
+ body_sha256: sha256Hex(input.body),
43
+ content_length: input.body.byteLength,
44
+ issued_at: (input.issuedAt ?? now()).toISOString(),
45
+ delivery: input.delivery,
46
+ key_id: keyId,
47
+ };
48
+ const receipt = { ...payload, sig: signPayload(payload, key.privateKey) };
49
+ return { receipt, header: encodeReceipt(receipt) };
50
+ }
51
+ function prepareFirstDelivery(input) {
52
+ if (!input.settle || input.settle.success !== true)
53
+ return null;
54
+ const network = normalizeNetwork(input.requirement.network);
55
+ const p = decodePaymentHeader(input.paymentHeader);
56
+ if (!p)
57
+ return null;
58
+ let paymentId;
59
+ let payer;
60
+ if (isSolanaNetwork(network)) {
61
+ if (typeof input.settle.transaction !== "string" || !input.settle.transaction)
62
+ return null;
63
+ const sigs = solanaPayerSignatures(p);
64
+ if (sigs.length === 0)
65
+ return null;
66
+ paymentId = input.settle.transaction;
67
+ // The fee payer (facilitator) slot is empty in the buyer's tx, so the present signature is the payer's.
68
+ payer = sigs[0];
69
+ }
70
+ else if (isEvmNetwork(network)) {
71
+ const got = getEvmAuthorization(p);
72
+ if (!got)
73
+ return null;
74
+ paymentId = got.authorization.nonce.toLowerCase();
75
+ payer = got.authorization.from.toLowerCase();
76
+ }
77
+ else {
78
+ return null;
79
+ }
80
+ const issuedAt = now();
81
+ const { receipt, header } = issueReceipt({
82
+ payment_id: paymentId,
83
+ network,
84
+ resource: input.resource,
85
+ body: input.body,
86
+ delivery: "first",
87
+ issuedAt,
88
+ });
89
+ const record = {
90
+ payment_id: paymentId,
91
+ network,
92
+ resource: input.resource,
93
+ payer,
94
+ body: Buffer.from(input.body).toString("base64"),
95
+ content_type: input.contentType,
96
+ body_sha256: receipt.body_sha256,
97
+ issued_at: receipt.issued_at,
98
+ };
99
+ return { record, receipt, header };
100
+ }
101
+ async function recordFirstDelivery(input) {
102
+ let prepared;
103
+ try {
104
+ prepared = prepareFirstDelivery(input);
105
+ }
106
+ catch (e) {
107
+ onError(e, "prepare receipt");
108
+ return null;
109
+ }
110
+ if (!prepared)
111
+ return null;
112
+ try {
113
+ await store.put(prepared.record, retentionS);
114
+ }
115
+ catch (e) {
116
+ // Without a record we cannot honor a refetch, so do not hand out a receipt.
117
+ onError(e, "store.put");
118
+ return null;
119
+ }
120
+ return prepared;
121
+ }
122
+ function refetchOk(body, contentType, paymentId, network, resource) {
123
+ const { header } = issueReceipt({ payment_id: paymentId, network, resource, body, delivery: "refetch" });
124
+ return {
125
+ status: 200,
126
+ headers: {
127
+ "content-type": contentType,
128
+ "cache-control": "private, no-store",
129
+ [RECEIPT_HEADER.toLowerCase()]: header,
130
+ "access-control-expose-headers": EXPOSE_HEADERS,
131
+ },
132
+ body,
133
+ };
134
+ }
135
+ async function handleRefetch(input) {
136
+ const { requirement, resource } = input;
137
+ const network = normalizeNetwork(requirement.network);
138
+ const paymentId = input.paymentId.trim();
139
+ if (!paymentId)
140
+ return refused(`empty ${REFETCH_HEADER}`);
141
+ const p = decodePaymentHeader(input.paymentHeader);
142
+ if (!p)
143
+ return refused("payment header missing or malformed");
144
+ // 1. The payment header must belong to the signer of payment_id.
145
+ let candidates;
146
+ let lookupId = paymentId;
147
+ if (isEvmNetwork(network)) {
148
+ const check = await checkEvmSigner(p, paymentId, requirement);
149
+ if (!check.ok)
150
+ return refused(check.detail);
151
+ candidates = [check.payer];
152
+ lookupId = paymentId.toLowerCase();
153
+ }
154
+ else if (isSolanaNetwork(network)) {
155
+ candidates = solanaPayerSignatures(p);
156
+ if (candidates.length === 0)
157
+ return refused("no valid payer signature in transaction");
158
+ }
159
+ else {
160
+ return refused(`unsupported network ${network}`);
161
+ }
162
+ // 2. Record path.
163
+ const record = await store.get(lookupId);
164
+ if (record) {
165
+ if (record.network !== network || record.resource !== resource)
166
+ return refused("record is for another resource");
167
+ if (!candidates.includes(record.payer))
168
+ return refused("payer does not match record");
169
+ if (isExpired(new Date(record.issued_at)))
170
+ return expired();
171
+ const body = new Uint8Array(Buffer.from(record.body, "base64"));
172
+ return refetchOk(body, record.content_type, record.payment_id, network, resource);
173
+ }
174
+ // 3. Chain path: no record, but maybe the payment settled anyway.
175
+ let found = null;
176
+ let payer = "";
177
+ try {
178
+ for (const c of candidates) {
179
+ const r = await chain.findPayment({
180
+ network,
181
+ payment_id: lookupId,
182
+ payer: c,
183
+ payTo: requirement.payTo,
184
+ asset: requirement.asset,
185
+ amount: requirement.amount,
186
+ });
187
+ if (r.settled) {
188
+ found = r;
189
+ payer = c;
190
+ break;
191
+ }
192
+ }
193
+ }
194
+ catch (e) {
195
+ onError(e, "chain.findPayment");
196
+ return jsonResponse(503, { error: "refetch_unavailable" });
197
+ }
198
+ if (!found)
199
+ return refused("payment not found on chain");
200
+ const anchor = found.at ?? now();
201
+ if (isExpired(anchor))
202
+ return expired();
203
+ const gen = await input.generate();
204
+ if (gen.status !== 200) {
205
+ return { status: gen.status, headers: { "content-type": gen.contentType }, body: gen.body };
206
+ }
207
+ const newRecord = {
208
+ payment_id: lookupId,
209
+ network,
210
+ resource,
211
+ payer,
212
+ body: Buffer.from(gen.body).toString("base64"),
213
+ content_type: gen.contentType,
214
+ body_sha256: sha256Hex(gen.body),
215
+ // Anchor the window at settlement time so later refetches do not extend it.
216
+ issued_at: anchor.toISOString(),
217
+ };
218
+ try {
219
+ await store.put(newRecord, retentionS);
220
+ }
221
+ catch (e) {
222
+ onError(e, "store.put (chain path)");
223
+ }
224
+ return refetchOk(gen.body, gen.contentType, lookupId, network, resource);
225
+ }
226
+ return {
227
+ keyId,
228
+ publicKey: key.publicKey,
229
+ refetchWindowS,
230
+ retentionS,
231
+ store,
232
+ chain,
233
+ wellKnown() {
234
+ const keys = [
235
+ { key_id: keyId, alg: "Ed25519", public_key: key.publicKey },
236
+ ...previousKeys.map((k) => ({
237
+ key_id: k.key_id,
238
+ alg: "Ed25519",
239
+ public_key: k.public_key,
240
+ ...(k.revoked_at ? { revoked_at: k.revoked_at } : {}),
241
+ })),
242
+ ];
243
+ return { keys, refetch_window_s: refetchWindowS, refetch_header: REFETCH_HEADER };
244
+ },
245
+ issueReceipt,
246
+ prepareFirstDelivery,
247
+ recordFirstDelivery,
248
+ handleRefetch,
249
+ };
250
+ }
251
+ //# sourceMappingURL=core.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Express (or any connect-style) adapter. Typed structurally against node:http so
3
+ * the package does not depend on express itself.
4
+ *
5
+ * app.get("/.well-known/x402-receipt.json", wellKnownRoute(seller));
6
+ * app.use("/api/report", receiptRefetch(seller, opts)); // BEFORE the x402 gate
7
+ * app.use("/api/report", x402Gate);
8
+ * app.use("/api/report", receiptRecorder(seller, opts)); // AFTER the x402 gate
9
+ * app.get("/api/report", handler);
10
+ */
11
+ import type { IncomingMessage, ServerResponse } from "node:http";
12
+ import { type ReceiptSeller } from "./core.js";
13
+ import type { PaymentRequirement } from "./types.js";
14
+ export type Req = IncomingMessage & {
15
+ originalUrl?: string;
16
+ };
17
+ export type Res = ServerResponse;
18
+ export type Next = (err?: unknown) => void;
19
+ export type Middleware = (req: Req, res: Res, next: Next) => void;
20
+ type ResourceOpt = string | ((req: Req) => string);
21
+ export interface ReceiptRefetchOptions {
22
+ resource: ResourceOpt;
23
+ requirement: PaymentRequirement;
24
+ /** Produce the body with the real handler, without payment (chain path only). */
25
+ generate: (req: Req) => Promise<{
26
+ status?: number;
27
+ body: Uint8Array | string;
28
+ contentType?: string;
29
+ }>;
30
+ }
31
+ export interface ReceiptRecorderOptions {
32
+ resource: ResourceOpt;
33
+ requirement: PaymentRequirement;
34
+ }
35
+ /** Handles `X-Payment-Refetch` requests; otherwise calls next(). Mount before the x402 gate. */
36
+ export declare function receiptRefetch(seller: ReceiptSeller, opts: ReceiptRefetchOptions): Middleware;
37
+ /**
38
+ * Records + signs paid 200 responses. Mount after the x402 gate.
39
+ *
40
+ * It buffers the handler's body (res.write/res.end). Two gate styles are supported:
41
+ * - the gate settled before calling next() (PAYMENT-RESPONSE already set): the
42
+ * record is written, then the body is released;
43
+ * - the gate settles after the handler (it intercepts res.end itself, like
44
+ * x402-express): the receipt is attached when the gate writes the head, and the
45
+ * response's output (head + body) is held until the record write completes, so
46
+ * no byte leaves before the record exists. This path relies on Node's
47
+ * OutgoingMessage#_send, which has been stable for many major versions; prefer
48
+ * a gate that settles before calling next() (or the web adapter) when possible.
49
+ */
50
+ export declare function receiptRecorder(seller: ReceiptSeller, opts: ReceiptRecorderOptions): Middleware;
51
+ /** GET /.well-known/x402-receipt.json */
52
+ export declare function wellKnownRoute(seller: ReceiptSeller): (req: Req, res: Res) => void;
53
+ export {};