@aibtc/tx-schemas 0.1.0

package/dist/rpc/schemas.d.ts

@@ -0,0 +1,339 @@
+import { z } from "zod";
+export declare const RPC_ERROR_CODES: readonly ["INVALID_TRANSACTION", "NOT_SPONSORED", "SENDER_NONCE_STALE", "SENDER_NONCE_DUPLICATE", "SENDER_NONCE_GAP", "NONCE_CONFLICT", "SPONSOR_NONCE_STALE", "SPONSOR_NONCE_DUPLICATE", "BROADCAST_FAILED", "TX_BROADCAST_ERROR", "SETTLEMENT_FAILED", "INTERNAL_ERROR", "INSUFFICIENT_FUNDS", "CLIENT_NONCE_CONFLICT", "CLIENT_BAD_NONCE", "TOO_MUCH_CHAINING"];
+export declare const RpcErrorCodeSchema: z.ZodEnum<{
+    INVALID_TRANSACTION: "INVALID_TRANSACTION";
+    NOT_SPONSORED: "NOT_SPONSORED";
+    SENDER_NONCE_STALE: "SENDER_NONCE_STALE";
+    SENDER_NONCE_DUPLICATE: "SENDER_NONCE_DUPLICATE";
+    SENDER_NONCE_GAP: "SENDER_NONCE_GAP";
+    NONCE_CONFLICT: "NONCE_CONFLICT";
+    SPONSOR_NONCE_STALE: "SPONSOR_NONCE_STALE";
+    SPONSOR_NONCE_DUPLICATE: "SPONSOR_NONCE_DUPLICATE";
+    BROADCAST_FAILED: "BROADCAST_FAILED";
+    TX_BROADCAST_ERROR: "TX_BROADCAST_ERROR";
+    SETTLEMENT_FAILED: "SETTLEMENT_FAILED";
+    INTERNAL_ERROR: "INTERNAL_ERROR";
+    INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+    CLIENT_NONCE_CONFLICT: "CLIENT_NONCE_CONFLICT";
+    CLIENT_BAD_NONCE: "CLIENT_BAD_NONCE";
+    TOO_MUCH_CHAINING: "TOO_MUCH_CHAINING";
+}>;
+export declare const RpcSettleOptionsSchema: z.ZodObject<{
+    expectedRecipient: z.ZodString;
+    minAmount: z.ZodString;
+    tokenType: z.ZodOptional<z.ZodString>;
+    expectedSender: z.ZodOptional<z.ZodString>;
+    resource: z.ZodOptional<z.ZodString>;
+    method: z.ZodOptional<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>>;
+    maxTimeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const RpcSenderNonceInfoSchema: z.ZodObject<{
+    provided: z.ZodNumber;
+    expected: z.ZodNumber;
+    healthy: z.ZodBoolean;
+    warning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const RpcSubmitPaymentWarningSchema: z.ZodObject<{
+    code: z.ZodLiteral<"SENDER_NONCE_GAP">;
+    detail: z.ZodString;
+    senderNonce: z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        lastSeen: z.ZodNumber;
+    }, z.core.$strip>;
+    help: z.ZodString;
+    action: z.ZodString;
+}, z.core.$strip>;
+export declare const RpcSubmitPaymentRequestSchema: z.ZodObject<{
+    txHex: z.ZodString;
+    settle: z.ZodOptional<z.ZodObject<{
+        expectedRecipient: z.ZodString;
+        minAmount: z.ZodString;
+        tokenType: z.ZodOptional<z.ZodString>;
+        expectedSender: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        method: z.ZodOptional<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>>;
+        maxTimeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const RpcSubmitPaymentAcceptedSchema: z.ZodObject<{
+    accepted: z.ZodLiteral<true>;
+    paymentId: z.ZodString;
+    status: z.ZodUnion<readonly [z.ZodEnum<{
+        submitted: "submitted";
+        queued: "queued";
+        broadcasting: "broadcasting";
+        mempool: "mempool";
+    }>, z.ZodLiteral<"queued_with_warning">]>;
+    senderNonce: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warning: z.ZodOptional<z.ZodObject<{
+        code: z.ZodLiteral<"SENDER_NONCE_GAP">;
+        detail: z.ZodString;
+        senderNonce: z.ZodObject<{
+            provided: z.ZodNumber;
+            expected: z.ZodNumber;
+            lastSeen: z.ZodNumber;
+        }, z.core.$strip>;
+        help: z.ZodString;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+    checkStatusUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const RpcSubmitPaymentRejectedSchema: z.ZodObject<{
+    accepted: z.ZodLiteral<false>;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<{
+        INVALID_TRANSACTION: "INVALID_TRANSACTION";
+        NOT_SPONSORED: "NOT_SPONSORED";
+        SENDER_NONCE_STALE: "SENDER_NONCE_STALE";
+        SENDER_NONCE_DUPLICATE: "SENDER_NONCE_DUPLICATE";
+        SENDER_NONCE_GAP: "SENDER_NONCE_GAP";
+        NONCE_CONFLICT: "NONCE_CONFLICT";
+        SPONSOR_NONCE_STALE: "SPONSOR_NONCE_STALE";
+        SPONSOR_NONCE_DUPLICATE: "SPONSOR_NONCE_DUPLICATE";
+        BROADCAST_FAILED: "BROADCAST_FAILED";
+        TX_BROADCAST_ERROR: "TX_BROADCAST_ERROR";
+        SETTLEMENT_FAILED: "SETTLEMENT_FAILED";
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+        INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+        CLIENT_NONCE_CONFLICT: "CLIENT_NONCE_CONFLICT";
+        CLIENT_BAD_NONCE: "CLIENT_BAD_NONCE";
+        TOO_MUCH_CHAINING: "TOO_MUCH_CHAINING";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodString>;
+    senderNonce: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const RpcSubmitPaymentResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    accepted: z.ZodLiteral<true>;
+    paymentId: z.ZodString;
+    status: z.ZodUnion<readonly [z.ZodEnum<{
+        submitted: "submitted";
+        queued: "queued";
+        broadcasting: "broadcasting";
+        mempool: "mempool";
+    }>, z.ZodLiteral<"queued_with_warning">]>;
+    senderNonce: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warning: z.ZodOptional<z.ZodObject<{
+        code: z.ZodLiteral<"SENDER_NONCE_GAP">;
+        detail: z.ZodString;
+        senderNonce: z.ZodObject<{
+            provided: z.ZodNumber;
+            expected: z.ZodNumber;
+            lastSeen: z.ZodNumber;
+        }, z.core.$strip>;
+        help: z.ZodString;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+    checkStatusUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    accepted: z.ZodLiteral<false>;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<{
+        INVALID_TRANSACTION: "INVALID_TRANSACTION";
+        NOT_SPONSORED: "NOT_SPONSORED";
+        SENDER_NONCE_STALE: "SENDER_NONCE_STALE";
+        SENDER_NONCE_DUPLICATE: "SENDER_NONCE_DUPLICATE";
+        SENDER_NONCE_GAP: "SENDER_NONCE_GAP";
+        NONCE_CONFLICT: "NONCE_CONFLICT";
+        SPONSOR_NONCE_STALE: "SPONSOR_NONCE_STALE";
+        SPONSOR_NONCE_DUPLICATE: "SPONSOR_NONCE_DUPLICATE";
+        BROADCAST_FAILED: "BROADCAST_FAILED";
+        TX_BROADCAST_ERROR: "TX_BROADCAST_ERROR";
+        SETTLEMENT_FAILED: "SETTLEMENT_FAILED";
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+        INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+        CLIENT_NONCE_CONFLICT: "CLIENT_NONCE_CONFLICT";
+        CLIENT_BAD_NONCE: "CLIENT_BAD_NONCE";
+        TOO_MUCH_CHAINING: "TOO_MUCH_CHAINING";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodString>;
+    senderNonce: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "accepted">;
+export declare const RpcCheckPaymentRequestSchema: z.ZodObject<{
+    paymentId: z.ZodString;
+}, z.core.$strip>;
+export declare const RpcCheckPaymentResultSchema: z.ZodObject<{
+    paymentId: z.ZodString;
+    status: z.ZodEnum<{
+        submitted: "submitted";
+        queued: "queued";
+        broadcasting: "broadcasting";
+        mempool: "mempool";
+        confirmed: "confirmed";
+        failed: "failed";
+        replaced: "replaced";
+        not_found: "not_found";
+    }>;
+    txid: z.ZodOptional<z.ZodString>;
+    blockHeight: z.ZodOptional<z.ZodNumber>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    explorerUrl: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodEnum<{
+        INVALID_TRANSACTION: "INVALID_TRANSACTION";
+        NOT_SPONSORED: "NOT_SPONSORED";
+        SENDER_NONCE_STALE: "SENDER_NONCE_STALE";
+        SENDER_NONCE_DUPLICATE: "SENDER_NONCE_DUPLICATE";
+        SENDER_NONCE_GAP: "SENDER_NONCE_GAP";
+        NONCE_CONFLICT: "NONCE_CONFLICT";
+        SPONSOR_NONCE_STALE: "SPONSOR_NONCE_STALE";
+        SPONSOR_NONCE_DUPLICATE: "SPONSOR_NONCE_DUPLICATE";
+        BROADCAST_FAILED: "BROADCAST_FAILED";
+        TX_BROADCAST_ERROR: "TX_BROADCAST_ERROR";
+        SETTLEMENT_FAILED: "SETTLEMENT_FAILED";
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+        INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+        CLIENT_NONCE_CONFLICT: "CLIENT_NONCE_CONFLICT";
+        CLIENT_BAD_NONCE: "CLIENT_BAD_NONCE";
+        TOO_MUCH_CHAINING: "TOO_MUCH_CHAINING";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    senderNonceInfo: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RpcSubmitPaymentRequest = z.infer<typeof RpcSubmitPaymentRequestSchema>;
+export type RpcSubmitPaymentResult = z.infer<typeof RpcSubmitPaymentResultSchema>;
+export type RpcCheckPaymentRequest = z.infer<typeof RpcCheckPaymentRequestSchema>;
+export type RpcCheckPaymentResult = z.infer<typeof RpcCheckPaymentResultSchema>;
+export declare const SubmitPaymentRpcResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    accepted: z.ZodLiteral<true>;
+    paymentId: z.ZodString;
+    status: z.ZodUnion<readonly [z.ZodEnum<{
+        submitted: "submitted";
+        queued: "queued";
+        broadcasting: "broadcasting";
+        mempool: "mempool";
+    }>, z.ZodLiteral<"queued_with_warning">]>;
+    senderNonce: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warning: z.ZodOptional<z.ZodObject<{
+        code: z.ZodLiteral<"SENDER_NONCE_GAP">;
+        detail: z.ZodString;
+        senderNonce: z.ZodObject<{
+            provided: z.ZodNumber;
+            expected: z.ZodNumber;
+            lastSeen: z.ZodNumber;
+        }, z.core.$strip>;
+        help: z.ZodString;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+    checkStatusUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    accepted: z.ZodLiteral<false>;
+    error: z.ZodString;
+    code: z.ZodOptional<z.ZodEnum<{
+        INVALID_TRANSACTION: "INVALID_TRANSACTION";
+        NOT_SPONSORED: "NOT_SPONSORED";
+        SENDER_NONCE_STALE: "SENDER_NONCE_STALE";
+        SENDER_NONCE_DUPLICATE: "SENDER_NONCE_DUPLICATE";
+        SENDER_NONCE_GAP: "SENDER_NONCE_GAP";
+        NONCE_CONFLICT: "NONCE_CONFLICT";
+        SPONSOR_NONCE_STALE: "SPONSOR_NONCE_STALE";
+        SPONSOR_NONCE_DUPLICATE: "SPONSOR_NONCE_DUPLICATE";
+        BROADCAST_FAILED: "BROADCAST_FAILED";
+        TX_BROADCAST_ERROR: "TX_BROADCAST_ERROR";
+        SETTLEMENT_FAILED: "SETTLEMENT_FAILED";
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+        INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+        CLIENT_NONCE_CONFLICT: "CLIENT_NONCE_CONFLICT";
+        CLIENT_BAD_NONCE: "CLIENT_BAD_NONCE";
+        TOO_MUCH_CHAINING: "TOO_MUCH_CHAINING";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    help: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodString>;
+    senderNonce: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "accepted">;
+export declare const CheckPaymentRpcResponseSchema: z.ZodObject<{
+    paymentId: z.ZodString;
+    status: z.ZodEnum<{
+        submitted: "submitted";
+        queued: "queued";
+        broadcasting: "broadcasting";
+        mempool: "mempool";
+        confirmed: "confirmed";
+        failed: "failed";
+        replaced: "replaced";
+        not_found: "not_found";
+    }>;
+    txid: z.ZodOptional<z.ZodString>;
+    blockHeight: z.ZodOptional<z.ZodNumber>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    explorerUrl: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    errorCode: z.ZodOptional<z.ZodEnum<{
+        INVALID_TRANSACTION: "INVALID_TRANSACTION";
+        NOT_SPONSORED: "NOT_SPONSORED";
+        SENDER_NONCE_STALE: "SENDER_NONCE_STALE";
+        SENDER_NONCE_DUPLICATE: "SENDER_NONCE_DUPLICATE";
+        SENDER_NONCE_GAP: "SENDER_NONCE_GAP";
+        NONCE_CONFLICT: "NONCE_CONFLICT";
+        SPONSOR_NONCE_STALE: "SPONSOR_NONCE_STALE";
+        SPONSOR_NONCE_DUPLICATE: "SPONSOR_NONCE_DUPLICATE";
+        BROADCAST_FAILED: "BROADCAST_FAILED";
+        TX_BROADCAST_ERROR: "TX_BROADCAST_ERROR";
+        SETTLEMENT_FAILED: "SETTLEMENT_FAILED";
+        INTERNAL_ERROR: "INTERNAL_ERROR";
+        INSUFFICIENT_FUNDS: "INSUFFICIENT_FUNDS";
+        CLIENT_NONCE_CONFLICT: "CLIENT_NONCE_CONFLICT";
+        CLIENT_BAD_NONCE: "CLIENT_BAD_NONCE";
+        TOO_MUCH_CHAINING: "TOO_MUCH_CHAINING";
+    }>>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    senderNonceInfo: z.ZodOptional<z.ZodObject<{
+        provided: z.ZodNumber;
+        expected: z.ZodNumber;
+        healthy: z.ZodBoolean;
+        warning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/rpc/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/rpc/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,eAAe,oWAiBlB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;EAA0B,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAQjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;iBAUxC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;iBAGxC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOzC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAGvC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;iBAEvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWtC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAA+B,CAAC;AAC3E,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC"}

package/dist/rpc/schemas.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { InFlightPaymentStateSchema, TrackedPaymentStateSchema } from "../core/enums.js";
+import { AmountStringSchema, NonNegativeIntegerSchema, PaymentIdSchema, PositiveIntegerSchema, StacksAddressSchema, TransactionHexSchema, TransactionIdSchema, UrlSchema, } from "../core/primitives.js";
+export const RPC_ERROR_CODES = [
+    "INVALID_TRANSACTION",
+    "NOT_SPONSORED",
+    "SENDER_NONCE_STALE",
+    "SENDER_NONCE_DUPLICATE",
+    "SENDER_NONCE_GAP",
+    "NONCE_CONFLICT",
+    "SPONSOR_NONCE_STALE",
+    "SPONSOR_NONCE_DUPLICATE",
+    "BROADCAST_FAILED",
+    "TX_BROADCAST_ERROR",
+    "SETTLEMENT_FAILED",
+    "INTERNAL_ERROR",
+    "INSUFFICIENT_FUNDS",
+    "CLIENT_NONCE_CONFLICT",
+    "CLIENT_BAD_NONCE",
+    "TOO_MUCH_CHAINING",
+];
+export const RpcErrorCodeSchema = z.enum(RPC_ERROR_CODES);
+export const RpcSettleOptionsSchema = z.object({
+    expectedRecipient: StacksAddressSchema,
+    minAmount: AmountStringSchema,
+    tokenType: z.string().min(1).optional(),
+    expectedSender: StacksAddressSchema.optional(),
+    resource: z.string().min(1).optional(),
+    method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional(),
+    maxTimeoutSeconds: PositiveIntegerSchema.optional(),
+});
+export const RpcSenderNonceInfoSchema = z.object({
+    provided: NonNegativeIntegerSchema,
+    expected: NonNegativeIntegerSchema,
+    healthy: z.boolean(),
+    warning: z.string().optional(),
+});
+export const RpcSubmitPaymentWarningSchema = z.object({
+    code: z.literal("SENDER_NONCE_GAP"),
+    detail: z.string().min(1),
+    senderNonce: z.object({
+        provided: NonNegativeIntegerSchema,
+        expected: NonNegativeIntegerSchema,
+        lastSeen: NonNegativeIntegerSchema,
+    }),
+    help: z.string().min(1),
+    action: z.string().min(1),
+});
+export const RpcSubmitPaymentRequestSchema = z.object({
+    txHex: TransactionHexSchema,
+    settle: RpcSettleOptionsSchema.optional(),
+});
+export const RpcSubmitPaymentAcceptedSchema = z.object({
+    accepted: z.literal(true),
+    paymentId: PaymentIdSchema,
+    status: z.union([InFlightPaymentStateSchema, z.literal("queued_with_warning")]),
+    senderNonce: RpcSenderNonceInfoSchema.optional(),
+    warning: RpcSubmitPaymentWarningSchema.optional(),
+    checkStatusUrl: UrlSchema.optional(),
+});
+export const RpcSubmitPaymentRejectedSchema = z.object({
+    accepted: z.literal(false),
+    error: z.string().min(1),
+    code: RpcErrorCodeSchema.optional(),
+    retryable: z.boolean().optional(),
+    help: z.string().min(1).optional(),
+    action: z.string().min(1).optional(),
+    senderNonce: RpcSenderNonceInfoSchema.optional(),
+});
+export const RpcSubmitPaymentResultSchema = z.discriminatedUnion("accepted", [
+    RpcSubmitPaymentAcceptedSchema,
+    RpcSubmitPaymentRejectedSchema,
+]);
+export const RpcCheckPaymentRequestSchema = z.object({
+    paymentId: PaymentIdSchema,
+});
+export const RpcCheckPaymentResultSchema = z.object({
+    paymentId: PaymentIdSchema,
+    status: TrackedPaymentStateSchema,
+    txid: TransactionIdSchema.optional(),
+    blockHeight: NonNegativeIntegerSchema.optional(),
+    confirmedAt: z.string().datetime({ offset: true }).optional(),
+    explorerUrl: UrlSchema.optional(),
+    error: z.string().min(1).optional(),
+    errorCode: RpcErrorCodeSchema.optional(),
+    retryable: z.boolean().optional(),
+    senderNonceInfo: RpcSenderNonceInfoSchema.optional(),
+});
+export const SubmitPaymentRpcResponseSchema = RpcSubmitPaymentResultSchema;
+export const CheckPaymentRpcResponseSchema = RpcCheckPaymentResultSchema;
+//# sourceMappingURL=schemas.js.map

package/dist/rpc/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/rpc/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,GACV,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,wBAAwB;IACxB,kBAAkB;IAClB,gBAAgB;IAChB,qBAAqB;IACrB,yBAAyB;IACzB,kBAAkB;IAClB,oBAAoB;IACpB,mBAAmB;IACnB,gBAAgB;IAChB,oBAAoB;IACpB,uBAAuB;IACvB,kBAAkB;IAClB,mBAAmB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpE,iBAAiB,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,wBAAwB;IAClC,QAAQ,EAAE,wBAAwB;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,wBAAwB;KACnC,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,oBAAoB;IAC3B,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACzB,SAAS,EAAE,eAAe;IAC1B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/E,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,OAAO,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IACjD,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE;IAC3E,8BAA8B;IAC9B,8BAA8B;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,eAAe;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,eAAe;IAC1B,MAAM,EAAE,yBAAyB;IACjC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,eAAe,EAAE,wBAAwB,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,8BAA8B,GAAG,4BAA4B,CAAC;AAC3E,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC"}

package/docs/package-schemas.md

@@ -0,0 +1,52 @@
+# Package Schemas
+
+`@aibtc/tx-schemas` is a single-package ESM library with one semantic source of truth and explicit transport adapters.
+
+## Export Strategy
+
+- `@aibtc/tx-schemas` exports the full public surface.
+- `@aibtc/tx-schemas/core` exports canonical payment states, categories, terminal reasons, and shared primitives.
+- `@aibtc/tx-schemas/core/enums` exports only state/category enums and maps.
+- `@aibtc/tx-schemas/core/schemas` exports the canonical payment-status schema unions.
+- `@aibtc/tx-schemas/terminal-reasons` exports terminal-reason enums and mappings.
+- `@aibtc/tx-schemas/rpc` exports internal first-party RPC schemas.
+- `@aibtc/tx-schemas/http` exports external HTTP schemas.
+
+## Naming Rules
+
+- `state` means the canonical domain payment state.
+- `category` means the canonical domain grouping derived from `state`.
+- `reason` means a terminal domain reason and is only valid for terminal failure states.
+- `status` is reserved for transport-level wire fields already used by the relay and service APIs.
+
+This keeps domain semantics stable even when transports choose different field names.
+
+## Transport Boundaries
+
+- `src/core` owns canonical semantics only.
+- `src/rpc` owns first-party service-binding request and response shapes.
+- `src/http` owns x402/HTTP request and response shapes plus polling/error envelopes.
+
+RPC and HTTP may differ in field names, envelopes, and transport-specific error codes.
+
+RPC and HTTP may not redefine:
+
+- payment states
+- payment categories
+- terminal success versus terminal failure
+- the meaning of `replaced` and `not_found`
+
+## Delivery Semantics
+
+The approval spec establishes these package-level semantics:
+
+- `confirmed` is the only canonical terminal-success state.
+- `submitted`, `queued`, `broadcasting`, and `mempool` are in-flight states.
+- `failed`, `replaced`, and `not_found` are terminal-failure states.
+- resource delivery during in-flight states is transport/product policy, not a new domain state
+
+## Documented Assumptions
+
+- Terminal reasons are normalized from the repo docs into stable package enums. Current relay/service error codes stay transport-specific in `rpc`.
+- `paymentId` is treated as a relay-owned identifier with a `pay_` prefix because first-party polling endpoints require that prefix.
+- Address and URL primitives are intentionally light-touch. This package validates shared API schemas, not chain-specific checksum rules.