@routedock/routedock 0.3.0 → 0.4.0

package/dist/client.d.cts

@@ -1,15 +1,82 @@
-import { g as RouteDockLogger, h as RouteDockManifest, n as SessionOptions, m as SessionHandle } from './logger-D8_Q2ytp.cjs';
-export { A as AssetConfig, D as DEFAULT_MAX_SESSION_DURATION_MS, a as DisputeStatus, E as EndpointDescriptor, b as EstimateCostResult, P as PaymentMode, c as PaymentResult, d as PreflightResult, e as PricingConfig, R as RouteDockLogFields, f as RouteDockLogLevel, S as SLAConfig, i as SessionCloseFailedPayload, j as SessionCloseResult, k as SessionEvent, l as SessionEventPayloadMap, o as SessionPricingConfig, p as SessionState, q as SessionStats, r as SessionTimeoutPayload, s as StreamOptions, V as VaultMode, t as consoleLogger, u as createConsoleLogger, v as noopLogger, w as resolveLogger } from './logger-D8_Q2ytp.cjs';
-export { R as RouteDockChannelStateError, a as RouteDockClientVersionError, b as RouteDockDisputeError, c as RouteDockError, d as RouteDockErrorCode, e as RouteDockErrorOptions, f as RouteDockFacilitatorError, g as RouteDockManifestError, h as RouteDockManifestSunsetError, i as RouteDockManifestTimeoutError, j as RouteDockNetworkError, k as RouteDockNoSupportedModeError, l as RouteDockPolicyRejectError, m as RouteDockPolicyRejectedError, n as RouteDockRefundWindowError, o as RouteDockSessionError, p as RouteDockSignatureError, q as RouteDockTrustlineError, r as RouteDockVoucherMonotonicityError, S as SessionStore, s as SupabaseSessionStore, t as getEligibleAssets, u as httpStatusToError, v as isAssetEligible, w as normalizeManifestAssets, x as parseRetryAfterMs, y as resolveAssetContract, z as selectAsset, A as wrapFetchError, B as wrapMppError } from './SessionStore-B4-Hi4H8.cjs';
-import { R as RetryPolicy } from './RouteDockClient-go9aopfF.cjs';
-export { D as DEFAULT_RETRY_POLICY, a as DailySpend, I as InMemorySpendStore, b as InMemorySpendStoreOptions, M as ModeSelectOptions, N as NulthAuthSignature, c as NulthClientConfig, d as NulthPolicyError, e as NulthPolicyState, f as NulthProof, g as NulthSignerConfig, h as NulthStellarSigner, i as NulthVaultConfig, P as PaymentAuthContext, j as RouteDockClient, k as RouteDockClientConfig, S as SpendCap, l as SpendStore, V as VaultConfig, m as assertEndpointActive, n as assertManifestValid, o as assertNulthVaultManifest, p as backoffDelayMs, q as configureManifestCache, r as createNulthSigner, s as createPolicyState, t as decodeAuthSignature, u as fetchLedgerSequence, v as fetchManifest, w as invalidateManifest, x as paymentContextFromManifest, y as prepareNulthSigner, z as rankProvidersByLatency, A as selectMode, B as setNulthPaymentContext, C as usdcToMicros, E as withRetry } from './RouteDockClient-go9aopfF.cjs';
-export { F as FileSpendStore, M as MppChargeClient, O as OnChainProviderInfo, a as OnChainRegistry, P as ProviderRecord, b as ProviderRegistry, c as ProviderRegistryConfig, X as X402Client, u as usdcToUnits } from './ProviderRegistry-D-0rqK0N.cjs';
+import { R as RouteDockManifest, n as SessionOptions, m as SessionHandle } from './types-DXaS5Wip.cjs';
+export { A as AssetConfig, D as DEFAULT_MAX_SESSION_DURATION_MS, a as DisputeStatus, E as EndpointDescriptor, b as EstimateCostResult, P as PaymentMode, c as PaymentRequest, d as PaymentResult, e as PreflightComplianceFlags, f as PreflightModeCost, g as PreflightResult, h as PricingConfig, S as SLAConfig, i as SessionCloseFailedPayload, j as SessionCloseResult, k as SessionEvent, l as SessionEventPayloadMap, o as SessionPricingConfig, p as SessionState, q as SessionStats, r as SessionTimeoutPayload, s as StreamOptions, U as UrlPreflightResult, V as VaultMode } from './types-DXaS5Wip.cjs';
+export { R as RouteDockChannelStateError, a as RouteDockClientVersionError, b as RouteDockDisputeError, c as RouteDockError, d as RouteDockErrorCode, e as RouteDockErrorOptions, f as RouteDockFacilitatorError, g as RouteDockManifestError, h as RouteDockManifestSunsetError, i as RouteDockManifestTimeoutError, j as RouteDockNetworkError, k as RouteDockNoSupportedModeError, l as RouteDockPaymentRejectedError, m as RouteDockPolicyRejectError, n as RouteDockPolicyRejectedError, o as RouteDockRefundWindowError, p as RouteDockSessionError, q as RouteDockSignatureError, r as RouteDockTrustlineError, s as RouteDockVoucherMonotonicityError, S as SessionStore, t as SupabaseSessionStore, u as getEligibleAssets, v as httpStatusToError, w as isAssetEligible, x as normalizeManifestAssets, y as parseRetryAfterMs, z as paymentRejectedError, A as resolveAssetContract, B as selectAsset, C as wrapFetchError, D as wrapMppError } from './SessionStore-DkLBxFQu.cjs';
+import { R as RetryPolicy } from './RouteDockClient-6rmgkbYb.cjs';
+export { D as DEFAULT_RETRY_POLICY, M as ModeSelectOptions, N as NulthVaultConfig, a as RouteDockClient, b as RouteDockClientConfig, S as SpendCap, V as VaultConfig, X as X402Client, c as X402PreSignContext, d as X402PreSignDecision, e as X402PreSignHook, f as assertEndpointActive, g as assertNulthVaultManifest, h as backoffDelayMs, i as configureManifestCache, j as createNulthSigner, k as fetchLedgerSequence, l as fetchManifest, m as invalidateManifest, p as prepareNulthSigner, r as rankProvidersByLatency, s as selectMode, u as usdcToMicros, w as withRetry } from './RouteDockClient-6rmgkbYb.cjs';
+import { b as RouteDockLogger } from './logger-DVa7VT4c.cjs';
+export { R as RouteDockLogFields, a as RouteDockLogLevel, c as consoleLogger, d as createConsoleLogger, n as noopLogger, r as resolveLogger } from './logger-DVa7VT4c.cjs';
+export { M as MppChargeClient, O as OnChainProviderInfo, a as OnChainRegistry, P as ProviderRecord, b as ProviderRegistry, c as ProviderRegistryConfig, d as assertManifestValid, u as usdcToUnits } from './ProviderRegistry-D9KqyuH-.cjs';
+import { AssembledTransaction } from '@stellar/stellar-sdk/contract';
+import { handleSimulationResult, ClientStellarSigner } from '@x402/stellar';
+import { Network, SchemeNetworkClient, PaymentRequirements, PaymentPayloadResult } from '@x402/core/types';
+import { NulthStellarSigner } from '@routedock/nulth-sdk';
+export { NulthAuthSignature, NulthClientConfig, NulthPolicyError, NulthPolicyState, NulthProof, NulthSignerConfig, NulthStellarSigner, PaymentAuthContext, USDC_DECIMALS, createPolicyState, decodeAuthSignature, paymentContextFromManifest, setNulthPaymentContext, usdcToStroops } from '@routedock/nulth-sdk';
 import { Keypair } from '@stellar/stellar-sdk';
-export { USDC_DECIMALS, usdcToStroops } from '@routedock/nulth-sdk';
+export { D as DailySpend, I as InMemorySpendStore, a as InMemorySpendStoreOptions, S as SpendStore } from './SpendStore-s_dfcemj.cjs';
 import 'mppx';
 import '@supabase/supabase-js';
-import '@x402/stellar';
-import '@stellar/stellar-sdk/contract';
+
+/**
+ * Nulth-aware x402 scheme for Stellar (#552).
+ *
+ * `ExactStellarScheme` builds the `transfer` transaction correctly for a Nulth
+ * payer but signs it with stellar-sdk's default `authorizeEntry`, which reads the
+ * credential address as an ed25519 key and therefore throws
+ * `invalid version byte. expected 48, got 16` for the `C...` account contract —
+ * the proof could never reach the network. Everything else here mirrors the
+ * upstream scheme: the transaction, the expiry window, the signer assertions and
+ * the re-simulation that widens the footprint to cover `__check_auth`.
+ */
+/** The transfer the scheme assembles, one field per payment requirement. */
+interface NulthTransfer {
+    /** SAC contract holding the funds */
+    asset: string;
+    /** Nulth account contract paying */
+    from: string;
+    payTo: string;
+    /** Stroops, as the accepted requirement reports them */
+    amount: string;
+    networkPassphrase: string;
+    rpcUrl: string;
+}
+/** The subset of `AssembledTransaction` the scheme drives. */
+interface NulthPaymentTransaction {
+    /** The assembled envelope the payload carries. */
+    readonly built?: {
+        toXDR(): string;
+    };
+    /** The latest simulation, which the resource footprint is read from. */
+    readonly simulation?: Parameters<typeof handleSimulationResult>[0];
+    /** Accounts holding an address credential that is still unsigned. */
+    needsNonInvokerSigningBy(): string[];
+    signAuthEntries(options: NulthSignAuthEntriesOptions): Promise<void>;
+    simulate(): Promise<unknown>;
+}
+/** `AssembledTransaction.signAuthEntries`' options, as the scheme uses them. */
+type NulthSignAuthEntriesOptions = NonNullable<Parameters<AssembledTransaction<unknown>['signAuthEntries']>[0]>;
+/**
+ * The two steps that need a network. They are injectable because a unit test
+ * cannot reach Soroban RPC, and the proof-carrying part of the scheme is the
+ * credential write, not the round trip.
+ */
+interface NulthSchemeIo {
+    expirationLedger(network: Network, maxTimeoutSeconds: number): Promise<number>;
+    assemble(transfer: NulthTransfer): Promise<NulthPaymentTransaction>;
+}
+declare class NulthStellarScheme implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly io;
+    readonly scheme = "exact";
+    constructor(signer: NulthStellarSigner, io?: NulthSchemeIo);
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<PaymentPayloadResult>;
+    private validateRequirements;
+}
+/**
+ * Choose the scheme for a signer. A signer from `createNulthSigner` carries the
+ * Nulth marker and pays from a contract account, so it must not be wrapped in the
+ * stock ed25519 scheme; every other signer keeps `ExactStellarScheme` unchanged.
+ */
+declare function selectStellarScheme(signer: ClientStellarSigner): SchemeNetworkClient;
 
 /**
  * MppSessionClient — uses @stellar/mpp channel/client for off-chain
@@ -20,6 +87,9 @@ import '@stellar/stellar-sdk/contract';
  * @stellar/mpp library handles the 402 challenge-response cycle.
  */
 
+/** Polling parameters for on-chain transaction confirmation. */
+declare const TX_CONFIRM_INTERVAL_MS = 1000;
+declare const TX_CONFIRM_TIMEOUT_MS = 30000;
 /** A WebSocket socket as consumed by the mpp-session-ws stream. */
 interface WebSocketLike {
     readyState: number;
@@ -65,4 +135,4 @@ declare class MppSessionClient {
     private streamWebSocket;
 }
 
-export { MppSessionClient, RetryPolicy, RouteDockLogger, RouteDockManifest, SessionHandle, SessionOptions, type WebSocketFactory, type WebSocketHandlers, type WebSocketLike };
+export { MppSessionClient, type NulthPaymentTransaction, type NulthSchemeIo, type NulthSignAuthEntriesOptions, NulthStellarScheme, type NulthTransfer, RetryPolicy, RouteDockLogger, RouteDockManifest, SessionHandle, SessionOptions, TX_CONFIRM_INTERVAL_MS, TX_CONFIRM_TIMEOUT_MS, type WebSocketFactory, type WebSocketHandlers, type WebSocketLike, selectStellarScheme };

package/dist/client.d.ts

@@ -1,15 +1,82 @@
-import { g as RouteDockLogger, h as RouteDockManifest, n as SessionOptions, m as SessionHandle } from './logger-D8_Q2ytp.js';
-export { A as AssetConfig, D as DEFAULT_MAX_SESSION_DURATION_MS, a as DisputeStatus, E as EndpointDescriptor, b as EstimateCostResult, P as PaymentMode, c as PaymentResult, d as PreflightResult, e as PricingConfig, R as RouteDockLogFields, f as RouteDockLogLevel, S as SLAConfig, i as SessionCloseFailedPayload, j as SessionCloseResult, k as SessionEvent, l as SessionEventPayloadMap, o as SessionPricingConfig, p as SessionState, q as SessionStats, r as SessionTimeoutPayload, s as StreamOptions, V as VaultMode, t as consoleLogger, u as createConsoleLogger, v as noopLogger, w as resolveLogger } from './logger-D8_Q2ytp.js';
-export { R as RouteDockChannelStateError, a as RouteDockClientVersionError, b as RouteDockDisputeError, c as RouteDockError, d as RouteDockErrorCode, e as RouteDockErrorOptions, f as RouteDockFacilitatorError, g as RouteDockManifestError, h as RouteDockManifestSunsetError, i as RouteDockManifestTimeoutError, j as RouteDockNetworkError, k as RouteDockNoSupportedModeError, l as RouteDockPolicyRejectError, m as RouteDockPolicyRejectedError, n as RouteDockRefundWindowError, o as RouteDockSessionError, p as RouteDockSignatureError, q as RouteDockTrustlineError, r as RouteDockVoucherMonotonicityError, S as SessionStore, s as SupabaseSessionStore, t as getEligibleAssets, u as httpStatusToError, v as isAssetEligible, w as normalizeManifestAssets, x as parseRetryAfterMs, y as resolveAssetContract, z as selectAsset, A as wrapFetchError, B as wrapMppError } from './SessionStore-BaYiegP0.js';
-import { R as RetryPolicy } from './RouteDockClient-Bh86bVly.js';
-export { D as DEFAULT_RETRY_POLICY, a as DailySpend, I as InMemorySpendStore, b as InMemorySpendStoreOptions, M as ModeSelectOptions, N as NulthAuthSignature, c as NulthClientConfig, d as NulthPolicyError, e as NulthPolicyState, f as NulthProof, g as NulthSignerConfig, h as NulthStellarSigner, i as NulthVaultConfig, P as PaymentAuthContext, j as RouteDockClient, k as RouteDockClientConfig, S as SpendCap, l as SpendStore, V as VaultConfig, m as assertEndpointActive, n as assertManifestValid, o as assertNulthVaultManifest, p as backoffDelayMs, q as configureManifestCache, r as createNulthSigner, s as createPolicyState, t as decodeAuthSignature, u as fetchLedgerSequence, v as fetchManifest, w as invalidateManifest, x as paymentContextFromManifest, y as prepareNulthSigner, z as rankProvidersByLatency, A as selectMode, B as setNulthPaymentContext, C as usdcToMicros, E as withRetry } from './RouteDockClient-Bh86bVly.js';
-export { F as FileSpendStore, M as MppChargeClient, O as OnChainProviderInfo, a as OnChainRegistry, P as ProviderRecord, b as ProviderRegistry, c as ProviderRegistryConfig, X as X402Client, u as usdcToUnits } from './ProviderRegistry-CA_TdREG.js';
+import { R as RouteDockManifest, n as SessionOptions, m as SessionHandle } from './types-DXaS5Wip.js';
+export { A as AssetConfig, D as DEFAULT_MAX_SESSION_DURATION_MS, a as DisputeStatus, E as EndpointDescriptor, b as EstimateCostResult, P as PaymentMode, c as PaymentRequest, d as PaymentResult, e as PreflightComplianceFlags, f as PreflightModeCost, g as PreflightResult, h as PricingConfig, S as SLAConfig, i as SessionCloseFailedPayload, j as SessionCloseResult, k as SessionEvent, l as SessionEventPayloadMap, o as SessionPricingConfig, p as SessionState, q as SessionStats, r as SessionTimeoutPayload, s as StreamOptions, U as UrlPreflightResult, V as VaultMode } from './types-DXaS5Wip.js';
+export { R as RouteDockChannelStateError, a as RouteDockClientVersionError, b as RouteDockDisputeError, c as RouteDockError, d as RouteDockErrorCode, e as RouteDockErrorOptions, f as RouteDockFacilitatorError, g as RouteDockManifestError, h as RouteDockManifestSunsetError, i as RouteDockManifestTimeoutError, j as RouteDockNetworkError, k as RouteDockNoSupportedModeError, l as RouteDockPaymentRejectedError, m as RouteDockPolicyRejectError, n as RouteDockPolicyRejectedError, o as RouteDockRefundWindowError, p as RouteDockSessionError, q as RouteDockSignatureError, r as RouteDockTrustlineError, s as RouteDockVoucherMonotonicityError, S as SessionStore, t as SupabaseSessionStore, u as getEligibleAssets, v as httpStatusToError, w as isAssetEligible, x as normalizeManifestAssets, y as parseRetryAfterMs, z as paymentRejectedError, A as resolveAssetContract, B as selectAsset, C as wrapFetchError, D as wrapMppError } from './SessionStore-_ZkoBzFY.js';
+import { R as RetryPolicy } from './RouteDockClient-CnAkxwrW.js';
+export { D as DEFAULT_RETRY_POLICY, M as ModeSelectOptions, N as NulthVaultConfig, a as RouteDockClient, b as RouteDockClientConfig, S as SpendCap, V as VaultConfig, X as X402Client, c as X402PreSignContext, d as X402PreSignDecision, e as X402PreSignHook, f as assertEndpointActive, g as assertNulthVaultManifest, h as backoffDelayMs, i as configureManifestCache, j as createNulthSigner, k as fetchLedgerSequence, l as fetchManifest, m as invalidateManifest, p as prepareNulthSigner, r as rankProvidersByLatency, s as selectMode, u as usdcToMicros, w as withRetry } from './RouteDockClient-CnAkxwrW.js';
+import { b as RouteDockLogger } from './logger-DVa7VT4c.js';
+export { R as RouteDockLogFields, a as RouteDockLogLevel, c as consoleLogger, d as createConsoleLogger, n as noopLogger, r as resolveLogger } from './logger-DVa7VT4c.js';
+export { M as MppChargeClient, O as OnChainProviderInfo, a as OnChainRegistry, P as ProviderRecord, b as ProviderRegistry, c as ProviderRegistryConfig, d as assertManifestValid, u as usdcToUnits } from './ProviderRegistry-DVi2uzgk.js';
+import { AssembledTransaction } from '@stellar/stellar-sdk/contract';
+import { handleSimulationResult, ClientStellarSigner } from '@x402/stellar';
+import { Network, SchemeNetworkClient, PaymentRequirements, PaymentPayloadResult } from '@x402/core/types';
+import { NulthStellarSigner } from '@routedock/nulth-sdk';
+export { NulthAuthSignature, NulthClientConfig, NulthPolicyError, NulthPolicyState, NulthProof, NulthSignerConfig, NulthStellarSigner, PaymentAuthContext, USDC_DECIMALS, createPolicyState, decodeAuthSignature, paymentContextFromManifest, setNulthPaymentContext, usdcToStroops } from '@routedock/nulth-sdk';
 import { Keypair } from '@stellar/stellar-sdk';
-export { USDC_DECIMALS, usdcToStroops } from '@routedock/nulth-sdk';
+export { D as DailySpend, I as InMemorySpendStore, a as InMemorySpendStoreOptions, S as SpendStore } from './SpendStore-BUclV02i.js';
 import 'mppx';
 import '@supabase/supabase-js';
-import '@x402/stellar';
-import '@stellar/stellar-sdk/contract';
+
+/**
+ * Nulth-aware x402 scheme for Stellar (#552).
+ *
+ * `ExactStellarScheme` builds the `transfer` transaction correctly for a Nulth
+ * payer but signs it with stellar-sdk's default `authorizeEntry`, which reads the
+ * credential address as an ed25519 key and therefore throws
+ * `invalid version byte. expected 48, got 16` for the `C...` account contract —
+ * the proof could never reach the network. Everything else here mirrors the
+ * upstream scheme: the transaction, the expiry window, the signer assertions and
+ * the re-simulation that widens the footprint to cover `__check_auth`.
+ */
+/** The transfer the scheme assembles, one field per payment requirement. */
+interface NulthTransfer {
+    /** SAC contract holding the funds */
+    asset: string;
+    /** Nulth account contract paying */
+    from: string;
+    payTo: string;
+    /** Stroops, as the accepted requirement reports them */
+    amount: string;
+    networkPassphrase: string;
+    rpcUrl: string;
+}
+/** The subset of `AssembledTransaction` the scheme drives. */
+interface NulthPaymentTransaction {
+    /** The assembled envelope the payload carries. */
+    readonly built?: {
+        toXDR(): string;
+    };
+    /** The latest simulation, which the resource footprint is read from. */
+    readonly simulation?: Parameters<typeof handleSimulationResult>[0];
+    /** Accounts holding an address credential that is still unsigned. */
+    needsNonInvokerSigningBy(): string[];
+    signAuthEntries(options: NulthSignAuthEntriesOptions): Promise<void>;
+    simulate(): Promise<unknown>;
+}
+/** `AssembledTransaction.signAuthEntries`' options, as the scheme uses them. */
+type NulthSignAuthEntriesOptions = NonNullable<Parameters<AssembledTransaction<unknown>['signAuthEntries']>[0]>;
+/**
+ * The two steps that need a network. They are injectable because a unit test
+ * cannot reach Soroban RPC, and the proof-carrying part of the scheme is the
+ * credential write, not the round trip.
+ */
+interface NulthSchemeIo {
+    expirationLedger(network: Network, maxTimeoutSeconds: number): Promise<number>;
+    assemble(transfer: NulthTransfer): Promise<NulthPaymentTransaction>;
+}
+declare class NulthStellarScheme implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly io;
+    readonly scheme = "exact";
+    constructor(signer: NulthStellarSigner, io?: NulthSchemeIo);
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<PaymentPayloadResult>;
+    private validateRequirements;
+}
+/**
+ * Choose the scheme for a signer. A signer from `createNulthSigner` carries the
+ * Nulth marker and pays from a contract account, so it must not be wrapped in the
+ * stock ed25519 scheme; every other signer keeps `ExactStellarScheme` unchanged.
+ */
+declare function selectStellarScheme(signer: ClientStellarSigner): SchemeNetworkClient;
 
 /**
  * MppSessionClient — uses @stellar/mpp channel/client for off-chain
@@ -20,6 +87,9 @@ import '@stellar/stellar-sdk/contract';
  * @stellar/mpp library handles the 402 challenge-response cycle.
  */
 
+/** Polling parameters for on-chain transaction confirmation. */
+declare const TX_CONFIRM_INTERVAL_MS = 1000;
+declare const TX_CONFIRM_TIMEOUT_MS = 30000;
 /** A WebSocket socket as consumed by the mpp-session-ws stream. */
 interface WebSocketLike {
     readyState: number;
@@ -65,4 +135,4 @@ declare class MppSessionClient {
     private streamWebSocket;
 }
 
-export { MppSessionClient, RetryPolicy, RouteDockLogger, RouteDockManifest, SessionHandle, SessionOptions, type WebSocketFactory, type WebSocketHandlers, type WebSocketLike };
+export { MppSessionClient, type NulthPaymentTransaction, type NulthSchemeIo, type NulthSignAuthEntriesOptions, NulthStellarScheme, type NulthTransfer, RetryPolicy, RouteDockLogger, RouteDockManifest, SessionHandle, SessionOptions, TX_CONFIRM_INTERVAL_MS, TX_CONFIRM_TIMEOUT_MS, type WebSocketFactory, type WebSocketHandlers, type WebSocketLike, selectStellarScheme };