@shielded-x402/shared-types 0.1.3 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shielded-x402
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/crypto-spec.d.ts

@@ -1,12 +1,13 @@
 export declare const CRYPTO_SPEC: {
     readonly version: "v0.1.0";
     readonly hashFunction: "keccak256";
-    readonly merkleTreeDepth: 32;
+    readonly merkleTreeDepth: 24;
     readonly noteEncoding: "abi-packed-v1";
     readonly nullifierDerivation: "keccak256(nullifierSecret, noteCommitment)";
     readonly merchantCommitmentDerivation: "keccak256(payAmount, merchantRho, merchantPkHash)";
     readonly changeCommitmentDerivation: "keccak256(changeAmount, changeRho, changePkHash)";
     readonly challengeDomainSeparator: "shielded-x402:v1:challenge";
+    readonly challengeDomainHash: "0xe32e24a51c351093d339c0035177dc2da5c1b8b9563e414393edd75506dcc055";
     readonly commitmentDomainSeparator: "shielded-x402:v1:commitment";
     readonly outputDomainSeparator: "shielded-x402:v1:output";
     readonly nullifierDomainSeparator: "shielded-x402:v1:nullifier";

package/dist/crypto-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-spec.d.ts","sourceRoot":"","sources":["../src/crypto-spec.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;CAYd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC"}
+{"version":3,"file":"crypto-spec.d.ts","sourceRoot":"","sources":["../src/crypto-spec.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAad,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC"}

package/dist/crypto-spec.js

@@ -1,12 +1,13 @@
 export const CRYPTO_SPEC = {
     version: 'v0.1.0',
     hashFunction: 'keccak256',
-    merkleTreeDepth: 32,
+    merkleTreeDepth: 24,
     noteEncoding: 'abi-packed-v1',
     nullifierDerivation: 'keccak256(nullifierSecret, noteCommitment)',
     merchantCommitmentDerivation: 'keccak256(payAmount, merchantRho, merchantPkHash)',
     changeCommitmentDerivation: 'keccak256(changeAmount, changeRho, changePkHash)',
     challengeDomainSeparator: 'shielded-x402:v1:challenge',
+    challengeDomainHash: '0xe32e24a51c351093d339c0035177dc2da5c1b8b9563e414393edd75506dcc055',
     commitmentDomainSeparator: 'shielded-x402:v1:commitment',
     outputDomainSeparator: 'shielded-x402:v1:output',
     nullifierDomainSeparator: 'shielded-x402:v1:nullifier'

package/dist/crypto-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-spec.js","sourceRoot":"","sources":["../src/crypto-spec.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,QAAQ;IACjB,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,eAAe;IAC7B,mBAAmB,EAAE,4CAA4C;IACjE,4BAA4B,EAAE,mDAAmD;IACjF,0BAA0B,EAAE,kDAAkD;IAC9E,wBAAwB,EAAE,4BAA4B;IACtD,yBAAyB,EAAE,6BAA6B;IACxD,qBAAqB,EAAE,yBAAyB;IAChD,wBAAwB,EAAE,4BAA4B;CAC9C,CAAC"}
+{"version":3,"file":"crypto-spec.js","sourceRoot":"","sources":["../src/crypto-spec.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,QAAQ;IACjB,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,eAAe;IAC7B,mBAAmB,EAAE,4CAA4C;IACjE,4BAA4B,EAAE,mDAAmD;IACjF,0BAA0B,EAAE,kDAAkD;IAC9E,wBAAwB,EAAE,4BAA4B;IACtD,mBAAmB,EAAE,oEAAoE;IACzF,yBAAyB,EAAE,6BAA6B;IACxD,qBAAqB,EAAE,yBAAyB;IAChD,wBAAwB,EAAE,4BAA4B;CAC9C,CAAC"}

package/dist/types.d.ts

@@ -26,12 +26,40 @@ export interface ShieldedPaymentResponse {
     txHint?: string;
 }
 export interface PaymentRequirement {
-    rail: 'shielded-usdc';
+    x402Version?: 2;
+    scheme: 'exact' | string;
+    network: string;
+    asset: Hex | string;
+    payTo: Hex;
+    rail: 'shielded-usdc' | string;
     amount: string;
     challengeNonce: string;
     challengeExpiry: string;
     merchantPubKey: Hex;
     verifyingContract: Hex;
+    maxTimeoutSeconds?: number;
+    description?: string;
+    mimeType?: string;
+    outputSchema?: string;
+    extra?: Record<string, string> & {
+        rail: 'shielded-usdc' | string;
+        challengeNonce: string;
+        challengeExpiry: string;
+        merchantPubKey: Hex;
+        verifyingContract: Hex;
+    };
+}
+export interface X402PaymentRequired {
+    x402Version: 2;
+    accepts: Array<Record<string, unknown>>;
+    error?: string;
+}
+export interface X402PaymentSignaturePayload {
+    x402Version: 2;
+    accepted: PaymentRequirement;
+    payload: ShieldedPaymentResponse;
+    challengeNonce: Hex;
+    signature: Hex;
 }
 export interface AgentRecord {
     did: string;
@@ -47,4 +75,41 @@ export interface ReputationSignal {
     uptime: number;
     attestationRefs: string[];
 }
+export interface RelayerMerchantRequest {
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+    bodyBase64?: string;
+    challengeUrl?: string;
+}
+export interface RelayerPayRequest {
+    merchantRequest: RelayerMerchantRequest;
+    requirement: PaymentRequirement;
+    paymentSignatureHeader: string;
+    idempotencyKey?: string;
+}
+export interface RelayerChallengeRequest {
+    merchantRequest: RelayerMerchantRequest;
+    merchantPaymentRequiredHeader?: string;
+}
+export interface RelayerChallengeResponse {
+    requirement: PaymentRequirement;
+    paymentRequiredHeader: string;
+    upstreamRequirementHash: Hex;
+}
+export type RelayerSettlementStatus = 'RECEIVED' | 'VERIFIED' | 'SENT_ONCHAIN' | 'CONFIRMED' | 'PAID_MERCHANT' | 'DONE' | 'FAILED';
+export interface RelayerMerchantResult {
+    status: number;
+    headers: Record<string, string>;
+    bodyBase64: string;
+    payoutReference?: string;
+}
+export interface RelayerPayResponse {
+    settlementId: string;
+    status: RelayerSettlementStatus;
+    nullifier: Hex;
+    settlementTxHash?: Hex;
+    merchantResult?: RelayerMerchantResult;
+    failureReason?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,EAAE,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,GAAG,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,GAAG,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,kBAAkB,EAAE,GAAG,CAAC;IACxB,gBAAgB,EAAE,GAAG,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,GAAG,CAAC;IACX,YAAY,EAAE,GAAG,EAAE,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,kBAAkB,EAAE,GAAG,CAAC;IACxB,gBAAgB,EAAE,GAAG,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC;IACnB,gBAAgB,EAAE,GAAG,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,GAAG,CAAC;IACpB,iBAAiB,EAAE,GAAG,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,GAAG,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/x402.d.ts

@@ -1,7 +1,20 @@
+import type { PaymentRequirement, X402PaymentRequired, X402PaymentSignaturePayload } from './types.js';
 export declare const X402_HEADERS: {
-    readonly paymentResponse: "PAYMENT-RESPONSE";
+    readonly paymentRequired: "PAYMENT-REQUIRED";
     readonly paymentSignature: "PAYMENT-SIGNATURE";
-    readonly challengeNonce: "X-CHALLENGE-NONCE";
-    readonly paymentRequirement: "x-payment-requirement";
+    readonly paymentResponse: "PAYMENT-RESPONSE";
+};
+export declare const RELAYER_ROUTES: {
+    readonly challenge: "/v1/relay/challenge";
+    readonly pay: "/v1/relay/pay";
+    readonly statusPrefix: "/v1/relay/status";
 };
+export declare function encodeX402Header<T>(value: T): string;
+export declare function decodeX402Header<T>(rawHeader: string): T;
+export declare function buildPaymentRequiredHeader(requirement: PaymentRequirement): string;
+export declare function parsePaymentRequiredHeader(rawHeader: string): PaymentRequirement;
+export declare function parsePaymentRequiredEnvelope(rawHeader: string): X402PaymentRequired;
+export declare function buildPaymentSignatureHeader(payload: X402PaymentSignaturePayload): string;
+export declare function parsePaymentSignatureHeader(rawHeader: string): X402PaymentSignaturePayload;
+export declare function normalizeRequirement(requirement: PaymentRequirement): PaymentRequirement;
 //# sourceMappingURL=x402.d.ts.map

package/dist/x402.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;CAKf,CAAC"}
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAUX,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAGxD;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,CAkBlF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAOhF;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAMnF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAExF;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,2BAA2B,CAM1F;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,kBAAkB,GAAG,kBAAkB,CA6BxF"}

package/dist/x402.js

@@ -1,7 +1,96 @@
 export const X402_HEADERS = {
-    paymentResponse: 'PAYMENT-RESPONSE',
+    paymentRequired: 'PAYMENT-REQUIRED',
     paymentSignature: 'PAYMENT-SIGNATURE',
-    challengeNonce: 'X-CHALLENGE-NONCE',
-    paymentRequirement: 'x-payment-requirement'
+    paymentResponse: 'PAYMENT-RESPONSE'
 };
+export const RELAYER_ROUTES = {
+    challenge: '/v1/relay/challenge',
+    pay: '/v1/relay/pay',
+    statusPrefix: '/v1/relay/status'
+};
+function toBase64(value) {
+    return Buffer.from(value, 'utf8').toString('base64');
+}
+function fromBase64(value) {
+    return Buffer.from(value, 'base64').toString('utf8');
+}
+export function encodeX402Header(value) {
+    return toBase64(JSON.stringify(value));
+}
+export function decodeX402Header(rawHeader) {
+    const decoded = fromBase64(rawHeader.trim());
+    return JSON.parse(decoded);
+}
+export function buildPaymentRequiredHeader(requirement) {
+    const envelope = {
+        x402Version: 2,
+        accepts: [
+            {
+                ...requirement,
+                x402Version: 2,
+                extra: requirement.extra ?? {
+                    rail: requirement.rail,
+                    challengeNonce: requirement.challengeNonce,
+                    challengeExpiry: requirement.challengeExpiry,
+                    merchantPubKey: requirement.merchantPubKey,
+                    verifyingContract: requirement.verifyingContract
+                }
+            }
+        ]
+    };
+    return encodeX402Header(envelope);
+}
+export function parsePaymentRequiredHeader(rawHeader) {
+    const envelope = parsePaymentRequiredEnvelope(rawHeader);
+    const accepted = envelope.accepts[0];
+    if (!accepted || typeof accepted !== 'object') {
+        throw new Error('x402 PAYMENT-REQUIRED has no accepted payment requirements');
+    }
+    return normalizeRequirement(accepted);
+}
+export function parsePaymentRequiredEnvelope(rawHeader) {
+    const envelope = decodeX402Header(rawHeader);
+    if (envelope.x402Version !== 2) {
+        throw new Error('unsupported x402 version in PAYMENT-REQUIRED');
+    }
+    return envelope;
+}
+export function buildPaymentSignatureHeader(payload) {
+    return encodeX402Header(payload);
+}
+export function parsePaymentSignatureHeader(rawHeader) {
+    const envelope = decodeX402Header(rawHeader);
+    if (envelope.x402Version !== 2) {
+        throw new Error('unsupported x402 version in PAYMENT-SIGNATURE');
+    }
+    return envelope;
+}
+export function normalizeRequirement(requirement) {
+    const extra = requirement.extra ?? undefined;
+    const rail = requirement.rail ?? extra?.rail;
+    const challengeNonce = requirement.challengeNonce ?? extra?.challengeNonce;
+    const challengeExpiry = requirement.challengeExpiry ?? extra?.challengeExpiry;
+    const merchantPubKey = requirement.merchantPubKey ?? extra?.merchantPubKey;
+    const verifyingContract = requirement.verifyingContract ?? extra?.verifyingContract;
+    if (!rail || !challengeNonce || !challengeExpiry || !merchantPubKey || !verifyingContract) {
+        throw new Error('payment requirement missing shielded rail metadata');
+    }
+    return {
+        ...requirement,
+        x402Version: 2,
+        rail,
+        challengeNonce,
+        challengeExpiry,
+        merchantPubKey,
+        verifyingContract,
+        extra: {
+            ...(extra ?? {}),
+            rail,
+            challengeNonce,
+            challengeExpiry,
+            merchantPubKey,
+            verifyingContract
+        }
+    };
+}
 //# sourceMappingURL=x402.js.map

package/dist/x402.js.map

@@ -1 +1 @@
-{"version":3,"file":"x402.js","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EAAE,mBAAmB;IACrC,cAAc,EAAE,mBAAmB;IACnC,kBAAkB,EAAE,uBAAuB;CACnC,CAAC"}
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shielded-x402/shared-types",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",