@aibtc/tx-schemas 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aibtcdev
+
+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/README.md

@@ -0,0 +1,73 @@
+# @aibtc/tx-schemas
+
+Shared zod schemas for AIBTC payment state models, first-party relay RPC schemas,
+and external x402 HTTP schemas.
+
+## Install
+
+```bash
+npm install @aibtc/tx-schemas zod
+```
+
+## Package Shape
+
+- `@aibtc/tx-schemas` exports the full surface
+- `@aibtc/tx-schemas/core` exports canonical payment enums, terminal reasons, and shared primitives
+- `@aibtc/tx-schemas/rpc` exports internal relay service-binding schemas
+- `@aibtc/tx-schemas/http` exports external x402 facilitator and polling schemas
+
+## Usage
+
+```ts
+import { PaymentStateSchema, PaymentStateCategoryByState } from "@aibtc/tx-schemas/core";
+import { RpcSubmitPaymentResultSchema } from "@aibtc/tx-schemas/rpc";
+import { HttpSettleRequestSchema } from "@aibtc/tx-schemas/http";
+import { TERMINAL_REASONS } from "@aibtc/tx-schemas/terminal-reasons";
+
+const state = PaymentStateSchema.parse("confirmed");
+const category = PaymentStateCategoryByState[state];
+const terminalReasons = TERMINAL_REASONS;
+
+const rpcResult = RpcSubmitPaymentResultSchema.parse({
+  accepted: true,
+  paymentId: "pay_01J7QZXK5XRGBVMK3N9RTNF4WW",
+  status: "queued",
+});
+
+const settleRequest = HttpSettleRequestSchema.parse({
+  paymentPayload: {
+    x402Version: 2,
+    payload: { transaction: "0x1234" },
+  },
+  paymentRequirements: {
+    scheme: "exact",
+    network: "stacks:2147483648",
+    amount: "1000000",
+    asset: "STX",
+    payTo: "ST000000000000000000002AMW42H",
+  },
+});
+```
+
+## Subpath Imports
+
+- `@aibtc/tx-schemas`
+- `@aibtc/tx-schemas/core`
+- `@aibtc/tx-schemas/core/enums`
+- `@aibtc/tx-schemas/core/schemas`
+- `@aibtc/tx-schemas/core/primitives`
+- `@aibtc/tx-schemas/terminal-reasons`
+- `@aibtc/tx-schemas/core/terminal-reasons`
+- `@aibtc/tx-schemas/rpc`
+- `@aibtc/tx-schemas/http`
+
+## Schema Rules
+
+- Canonical payment states live in `core` and are the only shared payment-state source of truth.
+- `rpc` and `http` may differ in field names and transport ergonomics, but they must reuse the same state semantics.
+- The default protected-resource delivery invariant is `deliver-only-on-confirmed`.
+- Any product that delivers on in-flight states should document that as an application exception, not a canonical package rule.
+
+More detail lives in [docs/package-schemas.md](docs/package-schemas.md),
+[docs/x402-approval-spec.md](docs/x402-approval-spec.md), and
+[docs/x402-state-machines.md](docs/x402-state-machines.md).

package/dist/core/enums.d.ts

@@ -0,0 +1,161 @@
+import { z } from "zod";
+export declare const PAYMENT_STATES: readonly ["requires_payment", "submitted", "queued", "broadcasting", "mempool", "confirmed", "failed", "replaced", "not_found"];
+export declare const TRACKED_PAYMENT_STATES: readonly ["submitted", "queued", "broadcasting", "mempool", "confirmed", "failed", "replaced", "not_found"];
+export declare const PAYMENT_STATE_CATEGORIES: readonly ["pre-payment", "in-flight", "terminal-success", "terminal-failure"];
+export declare const PRE_PAYMENT_STATES: readonly ["requires_payment"];
+export declare const IN_FLIGHT_STATES: readonly ["submitted", "queued", "broadcasting", "mempool"];
+export declare const TERMINAL_SUCCESS_STATES: readonly ["confirmed"];
+export declare const TERMINAL_FAILURE_STATES: readonly ["failed", "replaced", "not_found"];
+export declare const PaymentStateSchema: z.ZodEnum<{
+    requires_payment: "requires_payment";
+    submitted: "submitted";
+    queued: "queued";
+    broadcasting: "broadcasting";
+    mempool: "mempool";
+    confirmed: "confirmed";
+    failed: "failed";
+    replaced: "replaced";
+    not_found: "not_found";
+}>;
+export declare const TrackedPaymentStateSchema: z.ZodEnum<{
+    submitted: "submitted";
+    queued: "queued";
+    broadcasting: "broadcasting";
+    mempool: "mempool";
+    confirmed: "confirmed";
+    failed: "failed";
+    replaced: "replaced";
+    not_found: "not_found";
+}>;
+export declare const PaymentStateCategorySchema: z.ZodEnum<{
+    "pre-payment": "pre-payment";
+    "in-flight": "in-flight";
+    "terminal-success": "terminal-success";
+    "terminal-failure": "terminal-failure";
+}>;
+export declare const InFlightPaymentStateSchema: z.ZodEnum<{
+    submitted: "submitted";
+    queued: "queued";
+    broadcasting: "broadcasting";
+    mempool: "mempool";
+}>;
+export declare const TerminalFailureStateSchema: z.ZodEnum<{
+    failed: "failed";
+    replaced: "replaced";
+    not_found: "not_found";
+}>;
+export declare const PAYMENT_STATE_TO_CATEGORY: {
+    readonly requires_payment: "pre-payment";
+    readonly submitted: "in-flight";
+    readonly queued: "in-flight";
+    readonly broadcasting: "in-flight";
+    readonly mempool: "in-flight";
+    readonly confirmed: "terminal-success";
+    readonly failed: "terminal-failure";
+    readonly replaced: "terminal-failure";
+    readonly not_found: "terminal-failure";
+};
+export declare const PAYMENT_STATE_DEFAULT_DELIVERY: {
+    readonly requires_payment: false;
+    readonly submitted: false;
+    readonly queued: false;
+    readonly broadcasting: false;
+    readonly mempool: false;
+    readonly confirmed: true;
+    readonly failed: false;
+    readonly replaced: false;
+    readonly not_found: false;
+};
+export declare const PaymentStateCategoryByState: {
+    readonly requires_payment: "pre-payment";
+    readonly submitted: "in-flight";
+    readonly queued: "in-flight";
+    readonly broadcasting: "in-flight";
+    readonly mempool: "in-flight";
+    readonly confirmed: "terminal-success";
+    readonly failed: "terminal-failure";
+    readonly replaced: "terminal-failure";
+    readonly not_found: "terminal-failure";
+};
+export declare const paymentStateCategoryByState: {
+    readonly requires_payment: "pre-payment";
+    readonly submitted: "in-flight";
+    readonly queued: "in-flight";
+    readonly broadcasting: "in-flight";
+    readonly mempool: "in-flight";
+    readonly confirmed: "terminal-success";
+    readonly failed: "terminal-failure";
+    readonly replaced: "terminal-failure";
+    readonly not_found: "terminal-failure";
+};
+export declare const PaymentStateDefaultDeliveryByState: {
+    readonly requires_payment: false;
+    readonly submitted: false;
+    readonly queued: false;
+    readonly broadcasting: false;
+    readonly mempool: false;
+    readonly confirmed: true;
+    readonly failed: false;
+    readonly replaced: false;
+    readonly not_found: false;
+};
+export declare const paymentStateDefaultDeliveryByState: {
+    readonly requires_payment: false;
+    readonly submitted: false;
+    readonly queued: false;
+    readonly broadcasting: false;
+    readonly mempool: false;
+    readonly confirmed: true;
+    readonly failed: false;
+    readonly replaced: false;
+    readonly not_found: false;
+};
+export declare const PAYMENT_STATE_TRANSITIONS: {
+    readonly requires_payment: readonly [];
+    readonly submitted: readonly ["queued", "failed"];
+    readonly queued: readonly ["queued", "broadcasting", "failed"];
+    readonly broadcasting: readonly ["queued", "mempool", "failed"];
+    readonly mempool: readonly ["mempool", "confirmed", "failed", "replaced"];
+    readonly confirmed: readonly [];
+    readonly failed: readonly [];
+    readonly replaced: readonly [];
+    readonly not_found: readonly [];
+};
+export declare const PaymentStateTransitionMap: {
+    readonly requires_payment: readonly [];
+    readonly submitted: readonly ["queued", "failed"];
+    readonly queued: readonly ["queued", "broadcasting", "failed"];
+    readonly broadcasting: readonly ["queued", "mempool", "failed"];
+    readonly mempool: readonly ["mempool", "confirmed", "failed", "replaced"];
+    readonly confirmed: readonly [];
+    readonly failed: readonly [];
+    readonly replaced: readonly [];
+    readonly not_found: readonly [];
+};
+export declare const paymentStateTransitionMap: {
+    readonly requires_payment: readonly [];
+    readonly submitted: readonly ["queued", "failed"];
+    readonly queued: readonly ["queued", "broadcasting", "failed"];
+    readonly broadcasting: readonly ["queued", "mempool", "failed"];
+    readonly mempool: readonly ["mempool", "confirmed", "failed", "replaced"];
+    readonly confirmed: readonly [];
+    readonly failed: readonly [];
+    readonly replaced: readonly [];
+    readonly not_found: readonly [];
+};
+export declare const ProtectedResourceDeliverableStateSchema: z.ZodLiteral<"confirmed">;
+export declare const CanonicalDomainBoundary: {
+    readonly defaultProtectedResourceDelivery: {
+        readonly defaultRule: "deliver-only-on-confirmed";
+        readonly deliverableStates: readonly ["confirmed"];
+    };
+    readonly transportBoundaries: {
+        readonly sharedDomain: readonly ["state", "category", "terminal-reason"];
+        readonly rpc: readonly ["service-binding request/response shapes", "internal relay error codes"];
+        readonly http: readonly ["x402 request/response shapes", "polling and error envelopes"];
+    };
+};
+export type PaymentState = z.infer<typeof PaymentStateSchema>;
+export type TrackedPaymentState = z.infer<typeof TrackedPaymentStateSchema>;
+export type PaymentStateCategory = z.infer<typeof PaymentStateCategorySchema>;
+//# sourceMappingURL=enums.d.ts.map

package/dist/core/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/core/enums.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,iIAUjB,CAAC;AAEX,eAAO,MAAM,sBAAsB,6GASzB,CAAC;AAEX,eAAO,MAAM,wBAAwB,+EAK3B,CAAC;AAEX,eAAO,MAAM,kBAAkB,+BAAgC,CAAC;AAEhE,eAAO,MAAM,gBAAgB,6DAKnB,CAAC;AAEX,eAAO,MAAM,uBAAuB,wBAAyB,CAAC;AAE9D,eAAO,MAAM,uBAAuB,8CAI1B,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;;;;;EAAyB,CAAC;AACzD,eAAO,MAAM,yBAAyB;;;;;;;;;EAAiC,CAAC;AACxE,eAAO,MAAM,0BAA0B;;;;;EAAmC,CAAC;AAC3E,eAAO,MAAM,0BAA0B;;;;;EAA2B,CAAC;AACnE,eAAO,MAAM,0BAA0B;;;;EAAkC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;;;;;;;;;CAUiE,CAAC;AAExG,eAAO,MAAM,8BAA8B;;;;;;;;;;CAU0B,CAAC;AAEtE,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA4B,CAAC;AACrE,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA4B,CAAC;AACrE,eAAO,MAAM,kCAAkC;;;;;;;;;;CAAiC,CAAC;AACjF,eAAO,MAAM,kCAAkC;;;;;;;;;;CAAiC,CAAC;AAEjF,eAAO,MAAM,yBAAyB;;;;;;;;;;CAUkE,CAAC;AAEzG,eAAO,MAAM,yBAAyB;;;;;;;;;;CAA4B,CAAC;AACnE,eAAO,MAAM,yBAAyB;;;;;;;;;;CAA4B,CAAC;AACnE,eAAO,MAAM,uCAAuC,2BAAyB,CAAC;AAC9E,eAAO,MAAM,uBAAuB;;;;;;;;;;CAU1B,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/core/enums.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+export const PAYMENT_STATES = [
+    "requires_payment",
+    "submitted",
+    "queued",
+    "broadcasting",
+    "mempool",
+    "confirmed",
+    "failed",
+    "replaced",
+    "not_found",
+];
+export const TRACKED_PAYMENT_STATES = [
+    "submitted",
+    "queued",
+    "broadcasting",
+    "mempool",
+    "confirmed",
+    "failed",
+    "replaced",
+    "not_found",
+];
+export const PAYMENT_STATE_CATEGORIES = [
+    "pre-payment",
+    "in-flight",
+    "terminal-success",
+    "terminal-failure",
+];
+export const PRE_PAYMENT_STATES = ["requires_payment"];
+export const IN_FLIGHT_STATES = [
+    "submitted",
+    "queued",
+    "broadcasting",
+    "mempool",
+];
+export const TERMINAL_SUCCESS_STATES = ["confirmed"];
+export const TERMINAL_FAILURE_STATES = [
+    "failed",
+    "replaced",
+    "not_found",
+];
+export const PaymentStateSchema = z.enum(PAYMENT_STATES);
+export const TrackedPaymentStateSchema = z.enum(TRACKED_PAYMENT_STATES);
+export const PaymentStateCategorySchema = z.enum(PAYMENT_STATE_CATEGORIES);
+export const InFlightPaymentStateSchema = z.enum(IN_FLIGHT_STATES);
+export const TerminalFailureStateSchema = z.enum(TERMINAL_FAILURE_STATES);
+export const PAYMENT_STATE_TO_CATEGORY = {
+    requires_payment: "pre-payment",
+    submitted: "in-flight",
+    queued: "in-flight",
+    broadcasting: "in-flight",
+    mempool: "in-flight",
+    confirmed: "terminal-success",
+    failed: "terminal-failure",
+    replaced: "terminal-failure",
+    not_found: "terminal-failure",
+};
+export const PAYMENT_STATE_DEFAULT_DELIVERY = {
+    requires_payment: false,
+    submitted: false,
+    queued: false,
+    broadcasting: false,
+    mempool: false,
+    confirmed: true,
+    failed: false,
+    replaced: false,
+    not_found: false,
+};
+export const PaymentStateCategoryByState = PAYMENT_STATE_TO_CATEGORY;
+export const paymentStateCategoryByState = PAYMENT_STATE_TO_CATEGORY;
+export const PaymentStateDefaultDeliveryByState = PAYMENT_STATE_DEFAULT_DELIVERY;
+export const paymentStateDefaultDeliveryByState = PAYMENT_STATE_DEFAULT_DELIVERY;
+export const PAYMENT_STATE_TRANSITIONS = {
+    requires_payment: [],
+    submitted: ["queued", "failed"],
+    queued: ["queued", "broadcasting", "failed"],
+    broadcasting: ["queued", "mempool", "failed"],
+    mempool: ["mempool", "confirmed", "failed", "replaced"],
+    confirmed: [],
+    failed: [],
+    replaced: [],
+    not_found: [],
+};
+export const PaymentStateTransitionMap = PAYMENT_STATE_TRANSITIONS;
+export const paymentStateTransitionMap = PAYMENT_STATE_TRANSITIONS;
+export const ProtectedResourceDeliverableStateSchema = z.literal("confirmed");
+export const CanonicalDomainBoundary = {
+    defaultProtectedResourceDelivery: {
+        defaultRule: "deliver-only-on-confirmed",
+        deliverableStates: ["confirmed"],
+    },
+    transportBoundaries: {
+        sharedDomain: ["state", "category", "terminal-reason"],
+        rpc: ["service-binding request/response shapes", "internal relay error codes"],
+        http: ["x402 request/response shapes", "polling and error envelopes"],
+    },
+};
+//# sourceMappingURL=enums.js.map

package/dist/core/enums.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./enums.js";
+export * from "./payment.js";
+export * from "./primitives.js";
+export * from "./schemas.js";
+export * from "./terminal-reasons.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from "./enums.js";
+export * from "./payment.js";
+export * from "./primitives.js";
+export * from "./schemas.js";
+export * from "./terminal-reasons.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/dist/core/payment.d.ts

@@ -0,0 +1,267 @@
+import { z } from "zod";
+export declare const RequiresPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"requires_payment">;
+    category: z.ZodLiteral<"pre-payment">;
+}, z.core.$strip>;
+export declare const SubmittedPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const QueuedPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BroadcastingPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MempoolPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ConfirmedPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    category: z.ZodLiteral<"terminal-success">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    blockHeight: z.ZodOptional<z.ZodNumber>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    explorerUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FailedPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        invalid_transaction: "invalid_transaction";
+        not_sponsored: "not_sponsored";
+        sender_nonce_stale: "sender_nonce_stale";
+        sender_nonce_gap: "sender_nonce_gap";
+        sender_nonce_duplicate: "sender_nonce_duplicate";
+        queue_unavailable: "queue_unavailable";
+        sponsor_failure: "sponsor_failure";
+        broadcast_failure: "broadcast_failure";
+        chain_abort: "chain_abort";
+        internal_error: "internal_error";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ReplacedPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"replaced">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        nonce_replacement: "nonce_replacement";
+        superseded: "superseded";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const NotFoundPaymentStatusSchema: z.ZodObject<{
+    state: z.ZodLiteral<"not_found">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    reason: z.ZodEnum<{
+        expired: "expired";
+        unknown_payment_identity: "unknown_payment_identity";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PaymentStatusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    state: z.ZodLiteral<"requires_payment">;
+    category: z.ZodLiteral<"pre-payment">;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    category: z.ZodLiteral<"terminal-success">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    blockHeight: z.ZodOptional<z.ZodNumber>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    explorerUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        invalid_transaction: "invalid_transaction";
+        not_sponsored: "not_sponsored";
+        sender_nonce_stale: "sender_nonce_stale";
+        sender_nonce_gap: "sender_nonce_gap";
+        sender_nonce_duplicate: "sender_nonce_duplicate";
+        queue_unavailable: "queue_unavailable";
+        sponsor_failure: "sponsor_failure";
+        broadcast_failure: "broadcast_failure";
+        chain_abort: "chain_abort";
+        internal_error: "internal_error";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"replaced">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        nonce_replacement: "nonce_replacement";
+        superseded: "superseded";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"not_found">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    reason: z.ZodEnum<{
+        expired: "expired";
+        unknown_payment_identity: "unknown_payment_identity";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "state">;
+export declare const TrackedPaymentStatusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"submitted" | "queued" | "broadcasting" | "mempool">;
+    category: z.ZodLiteral<"in-flight">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    category: z.ZodLiteral<"terminal-success">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    blockHeight: z.ZodOptional<z.ZodNumber>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    explorerUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        invalid_transaction: "invalid_transaction";
+        not_sponsored: "not_sponsored";
+        sender_nonce_stale: "sender_nonce_stale";
+        sender_nonce_gap: "sender_nonce_gap";
+        sender_nonce_duplicate: "sender_nonce_duplicate";
+        queue_unavailable: "queue_unavailable";
+        sponsor_failure: "sponsor_failure";
+        broadcast_failure: "broadcast_failure";
+        chain_abort: "chain_abort";
+        internal_error: "internal_error";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"replaced">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        nonce_replacement: "nonce_replacement";
+        superseded: "superseded";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"not_found">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    reason: z.ZodEnum<{
+        expired: "expired";
+        unknown_payment_identity: "unknown_payment_identity";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "state">;
+export declare const TerminalPaymentStatusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    state: z.ZodLiteral<"confirmed">;
+    category: z.ZodLiteral<"terminal-success">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    blockHeight: z.ZodOptional<z.ZodNumber>;
+    confirmedAt: z.ZodOptional<z.ZodString>;
+    explorerUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        invalid_transaction: "invalid_transaction";
+        not_sponsored: "not_sponsored";
+        sender_nonce_stale: "sender_nonce_stale";
+        sender_nonce_gap: "sender_nonce_gap";
+        sender_nonce_duplicate: "sender_nonce_duplicate";
+        queue_unavailable: "queue_unavailable";
+        sponsor_failure: "sponsor_failure";
+        broadcast_failure: "broadcast_failure";
+        chain_abort: "chain_abort";
+        internal_error: "internal_error";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"replaced">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    txid: z.ZodOptional<z.ZodString>;
+    reason: z.ZodEnum<{
+        nonce_replacement: "nonce_replacement";
+        superseded: "superseded";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    state: z.ZodLiteral<"not_found">;
+    category: z.ZodLiteral<"terminal-failure">;
+    paymentId: z.ZodString;
+    reason: z.ZodEnum<{
+        expired: "expired";
+        unknown_payment_identity: "unknown_payment_identity";
+    }>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "state">;
+export type PaymentStatus = z.infer<typeof PaymentStatusSchema>;
+export type TrackedPaymentStatus = z.infer<typeof TrackedPaymentStatusSchema>;
+export type TerminalPaymentStatus = z.infer<typeof TerminalPaymentStatusSchema>;
+//# sourceMappingURL=payment.d.ts.map

package/dist/core/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/core/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;iBAAoC,CAAC;AAC9E,eAAO,MAAM,yBAAyB;;;;;iBAAiC,CAAC;AACxE,eAAO,MAAM,+BAA+B;;;;;iBAAuC,CAAC;AACpF,eAAO,MAAM,0BAA0B;;;;;iBAAkC,CAAC;AAE1E,eAAO,MAAM,4BAA4B;;;;;;;;iBAQvC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;iBAQpC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAOtC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;iBAMtC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAU9B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BASrC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAKtC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}