@piprail/sdk 1.21.1 → 1.22.0

package/dist/index.d.cts

@@ -5079,8 +5079,13 @@ interface SpendRemaining {
     remainingFormatted?: string;
 }
 interface PipRailClientOptions {
-    /** Wallet for the chosen chain family. */
-    wallet: WalletInput;
+    /**
+     * Wallet for the chosen chain family. **Optional** — omit it for a READ-ONLY
+     * client that can `quote`, `discover`, `estimateCost`, and `register` (402 Index)
+     * with no key. Paying, planning, or signing then throws {@link WalletRequiredError}
+     * until a wallet is provided. Supplying a wallet is byte-identical to before.
+     */
+    wallet?: WalletInput;
     /** Which chain to pay on. EVM ('bnb'|'base'|…), 'solana', 'ton', 'stellar',
      *  'xrpl', 'tron', 'sui', 'near', 'aptos', or 'algorand'. */
     chain: ChainSelector;
@@ -6392,6 +6397,14 @@ declare class UnsupportedSchemeError extends PipRailError {
 declare class NonReplayableBodyError extends PipRailError {
     readonly code = "NON_REPLAYABLE_BODY";
 }
+/**
+ * A wallet-bound operation was called on a READ-ONLY client — one built with no
+ * `wallet`. Read-only clients still `quote`, `discover`, and `register` (402 Index);
+ * paying, planning, or signing needs a wallet. Pass `wallet` to enable them.
+ */
+declare class WalletRequiredError extends PipRailError {
+    readonly code = "WALLET_REQUIRED";
+}
 /**
  * The chosen chain belongs to one family (EVM, Solana, TON, Stellar, XRPL, Tron,
  * Sui, NEAR, Aptos, Algorand) but the wallet, payTo, or token was given in another family's form
@@ -6780,4 +6793,4 @@ declare const PERMIT2_WITNESS_TYPES: {
     }];
 };
 
-export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ChallengeTriage, type ChallengeVerdict, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DeclineReasonCode, type DeliverAttempt, type DeliverReceiptOptions, type DeliverResult, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactPaymentPayloadAny, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, PERMIT2_ADDRESS, PERMIT2_PROXY_CHAIN_IDS, PERMIT2_WITNESS_TYPES, PIPRAIL_AGENT_GUIDE, type PaidReceipt, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, type PaymentScheme, PaymentTimeoutError, type Permit2Authorization, type Permit2PaymentPayload, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, type PolicyDenyCode, REGISTER_ATTRIBUTION, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SessionBudget, type SettleOutcome, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendRemaining, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, UnsupportedSchemeError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, X402_EXACT_PERMIT2_PROXY, type XrplToken, agentGuide, appendAttribution, buildBazaarExtension, buildChallengeHeader, buildExactAuthorization, buildExactSignatureHeader, buildOpenApi, buildReceiptHeader, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, classifyChallenge, createPaymentGate, decorateOutcome, deliverReceipt, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, explainDecline, formatSpendReport, getDirectoryInfo, isPermit2ProxyChain, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseReceipt, parseSettleResponse, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, summarizePlan, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };
+export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ChallengeTriage, type ChallengeVerdict, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DeclineReasonCode, type DeliverAttempt, type DeliverReceiptOptions, type DeliverResult, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactPaymentPayloadAny, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, PERMIT2_ADDRESS, PERMIT2_PROXY_CHAIN_IDS, PERMIT2_WITNESS_TYPES, PIPRAIL_AGENT_GUIDE, type PaidReceipt, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, type PaymentScheme, PaymentTimeoutError, type Permit2Authorization, type Permit2PaymentPayload, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, type PolicyDenyCode, REGISTER_ATTRIBUTION, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SessionBudget, type SettleOutcome, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendRemaining, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, UnsupportedSchemeError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, WalletRequiredError, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, X402_EXACT_PERMIT2_PROXY, type XrplToken, agentGuide, appendAttribution, buildBazaarExtension, buildChallengeHeader, buildExactAuthorization, buildExactSignatureHeader, buildOpenApi, buildReceiptHeader, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, classifyChallenge, createPaymentGate, decorateOutcome, deliverReceipt, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, explainDecline, formatSpendReport, getDirectoryInfo, isPermit2ProxyChain, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseReceipt, parseSettleResponse, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, summarizePlan, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };

package/dist/index.d.ts

@@ -5079,8 +5079,13 @@ interface SpendRemaining {
     remainingFormatted?: string;
 }
 interface PipRailClientOptions {
-    /** Wallet for the chosen chain family. */
-    wallet: WalletInput;
+    /**
+     * Wallet for the chosen chain family. **Optional** — omit it for a READ-ONLY
+     * client that can `quote`, `discover`, `estimateCost`, and `register` (402 Index)
+     * with no key. Paying, planning, or signing then throws {@link WalletRequiredError}
+     * until a wallet is provided. Supplying a wallet is byte-identical to before.
+     */
+    wallet?: WalletInput;
     /** Which chain to pay on. EVM ('bnb'|'base'|…), 'solana', 'ton', 'stellar',
      *  'xrpl', 'tron', 'sui', 'near', 'aptos', or 'algorand'. */
     chain: ChainSelector;
@@ -6392,6 +6397,14 @@ declare class UnsupportedSchemeError extends PipRailError {
 declare class NonReplayableBodyError extends PipRailError {
     readonly code = "NON_REPLAYABLE_BODY";
 }
+/**
+ * A wallet-bound operation was called on a READ-ONLY client — one built with no
+ * `wallet`. Read-only clients still `quote`, `discover`, and `register` (402 Index);
+ * paying, planning, or signing needs a wallet. Pass `wallet` to enable them.
+ */
+declare class WalletRequiredError extends PipRailError {
+    readonly code = "WALLET_REQUIRED";
+}
 /**
  * The chosen chain belongs to one family (EVM, Solana, TON, Stellar, XRPL, Tron,
  * Sui, NEAR, Aptos, Algorand) but the wallet, payTo, or token was given in another family's form
@@ -6780,4 +6793,4 @@ declare const PERMIT2_WITNESS_TYPES: {
     }];
 };
 
-export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ChallengeTriage, type ChallengeVerdict, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DeclineReasonCode, type DeliverAttempt, type DeliverReceiptOptions, type DeliverResult, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactPaymentPayloadAny, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, PERMIT2_ADDRESS, PERMIT2_PROXY_CHAIN_IDS, PERMIT2_WITNESS_TYPES, PIPRAIL_AGENT_GUIDE, type PaidReceipt, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, type PaymentScheme, PaymentTimeoutError, type Permit2Authorization, type Permit2PaymentPayload, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, type PolicyDenyCode, REGISTER_ATTRIBUTION, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SessionBudget, type SettleOutcome, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendRemaining, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, UnsupportedSchemeError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, X402_EXACT_PERMIT2_PROXY, type XrplToken, agentGuide, appendAttribution, buildBazaarExtension, buildChallengeHeader, buildExactAuthorization, buildExactSignatureHeader, buildOpenApi, buildReceiptHeader, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, classifyChallenge, createPaymentGate, decorateOutcome, deliverReceipt, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, explainDecline, formatSpendReport, getDirectoryInfo, isPermit2ProxyChain, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseReceipt, parseSettleResponse, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, summarizePlan, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };
+export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ChallengeTriage, type ChallengeVerdict, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DeclineReasonCode, type DeliverAttempt, type DeliverReceiptOptions, type DeliverResult, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactPaymentPayloadAny, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, PERMIT2_ADDRESS, PERMIT2_PROXY_CHAIN_IDS, PERMIT2_WITNESS_TYPES, PIPRAIL_AGENT_GUIDE, type PaidReceipt, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, type PaymentScheme, PaymentTimeoutError, type Permit2Authorization, type Permit2PaymentPayload, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, type PolicyDenyCode, REGISTER_ATTRIBUTION, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SessionBudget, type SettleOutcome, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendRemaining, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, UnsupportedSchemeError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, WalletRequiredError, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, X402_EXACT_PERMIT2_PROXY, type XrplToken, agentGuide, appendAttribution, buildBazaarExtension, buildChallengeHeader, buildExactAuthorization, buildExactSignatureHeader, buildOpenApi, buildReceiptHeader, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, classifyChallenge, createPaymentGate, decorateOutcome, deliverReceipt, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, explainDecline, formatSpendReport, getDirectoryInfo, isPermit2ProxyChain, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseReceipt, parseSettleResponse, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, summarizePlan, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };

package/dist/index.js

@@ -14,6 +14,7 @@ import {
   UnknownTokenError,
   UnsupportedNetworkError,
   UnsupportedSchemeError,
+  WalletRequiredError,
   WrongChainError,
   WrongFamilyError,
   floorUnits,
@@ -22,7 +23,7 @@ import {
   parseUnits,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-ILPABTI2.js";
+} from "./chunk-L6WQRHEZ.js";
 
 // src/drivers/registry.ts
 var byFamily = /* @__PURE__ */ new Map();
@@ -1795,7 +1796,7 @@ var loaders = {
   solana: async () => {
     let mod;
     try {
-      mod = await import("./solana-IBVUZS54.js");
+      mod = await import("./solana-KWNRY5NR.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Solana selected, but its packages aren't installed. Run: npm install @solana/web3.js @solana/spl-token bs58`,
@@ -1807,7 +1808,7 @@ var loaders = {
   ton: async () => {
     let mod;
     try {
-      mod = await import("./ton-CHJ26BVA.js");
+      mod = await import("./ton-QN5GTOCS.js");
     } catch (cause) {
       throw new MissingDriverError(
         `TON selected, but its packages aren't installed. Run: npm install @ton/ton @ton/core @ton/crypto`,
@@ -1819,7 +1820,7 @@ var loaders = {
   stellar: async () => {
     let mod;
     try {
-      mod = await import("./stellar-FIJPQZVW.js");
+      mod = await import("./stellar-YB7JXKK4.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Stellar selected, but its package isn't installed. Run: npm install @stellar/stellar-sdk`,
@@ -1831,7 +1832,7 @@ var loaders = {
   xrpl: async () => {
     let mod;
     try {
-      mod = await import("./xrpl-GTUPP6SK.js");
+      mod = await import("./xrpl-ECHK3GIX.js");
     } catch (cause) {
       throw new MissingDriverError(
         `XRPL selected, but its package isn't installed. Run: npm install xrpl`,
@@ -1843,7 +1844,7 @@ var loaders = {
   tron: async () => {
     let mod;
     try {
-      mod = await import("./tron-DD3JDROV.js");
+      mod = await import("./tron-QSNCDYRB.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Tron selected, but its package isn't installed. Run: npm install tronweb`,
@@ -1855,7 +1856,7 @@ var loaders = {
   sui: async () => {
     let mod;
     try {
-      mod = await import("./sui-B7AVN7NK.js");
+      mod = await import("./sui-IODKU2MA.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Sui selected, but its package isn't installed. Run: npm install @mysten/sui`,
@@ -1867,7 +1868,7 @@ var loaders = {
   near: async () => {
     let mod;
     try {
-      mod = await import("./near-LM7S3WUD.js");
+      mod = await import("./near-TWA4PYOD.js");
     } catch (cause) {
       throw new MissingDriverError(
         `NEAR selected, but its package isn't installed. Run: npm install near-api-js`,
@@ -1879,7 +1880,7 @@ var loaders = {
   aptos: async () => {
     let mod;
     try {
-      mod = await import("./aptos-SUXOVP7B.js");
+      mod = await import("./aptos-3TSKTI4D.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Aptos selected, but its package isn't installed. Run: npm install @aptos-labs/ts-sdk`,
@@ -1891,7 +1892,7 @@ var loaders = {
   algorand: async () => {
     let mod;
     try {
-      mod = await import("./algorand-F3OYB534.js");
+      mod = await import("./algorand-677ILBQS.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Algorand selected, but its package isn't installed. Run: npm install algosdk`,
@@ -2626,7 +2627,7 @@ var PipRailClient = class {
         chain: this.opts.chain,
         rpcUrl: this.opts.rpcUrl
       });
-      const wallet = net.bindWallet(this.opts.wallet);
+      const wallet = this.opts.wallet !== void 0 ? net.bindWallet(this.opts.wallet) : void 0;
       return { net, wallet };
     })();
   }
@@ -2792,6 +2793,11 @@ var PipRailClient = class {
       throw new InvalidEnvelopeError("402 response did not include a parseable x402 challenge.");
     }
     const { net, wallet } = await this.ensure();
+    if (!wallet) {
+      throw new WalletRequiredError(
+        "planPayment needs a wallet (it checks YOUR balance, gas, and recipient-readiness). This client is read-only \u2014 construct it with a `wallet` to plan or pay."
+      );
+    }
     return this.planFromChallenge(net, wallet, challenge, url, this.resolveSchemes());
   }
   /**
@@ -2943,6 +2949,7 @@ var PipRailClient = class {
    */
   async discoverySigner() {
     const { net, wallet } = await this.ensure();
+    if (!wallet) return null;
     return net.discoverySigner ? net.discoverySigner(wallet) : null;
   }
   /**
@@ -2964,6 +2971,11 @@ var PipRailClient = class {
     const schemes = this.resolveSchemes(init?.schemes);
     const resolved = await this.resolveChallenge(url, firstResponse, schemes);
     const { net, wallet, challenge } = resolved;
+    if (!wallet) {
+      throw new WalletRequiredError(
+        "Paying a 402 needs a wallet to sign + settle. This client is read-only \u2014 construct it with a `wallet` to pay (quote/discover/register still work without one)."
+      );
+    }
     let accept = resolved.accept;
     let quote = resolved.quote;
     const autoRoute = init?.autoRoute ?? this.opts.autoRoute ?? false;
@@ -4760,6 +4772,7 @@ export {
   UnknownTokenError,
   UnsupportedNetworkError,
   UnsupportedSchemeError,
+  WalletRequiredError,
   WrongChainError,
   WrongFamilyError,
   X402_EXACT_PERMIT2_PROXY,

package/dist/{near-ZJLZE26R.cjs → near-MG256A3E.cjs}

@@ -7,7 +7,7 @@
 
 
 
-var _chunkPA6YD3HLcjs = require('./chunk-PA6YD3HL.cjs');
+var _chunkU35MG4TFcjs = require('./chunk-U35MG4TF.cjs');
 
 // src/drivers/near/index.ts
 var _nearapijs = require('near-api-js');
@@ -53,18 +53,18 @@ async function payNear(params) {
     return res.hash;
   } catch (err) {
     if (isNearRegistrationError(err)) {
-      throw new (0, _chunkPA6YD3HLcjs.RecipientNotReadyError)(
+      throw new (0, _chunkU35MG4TFcjs.RecipientNotReadyError)(
         `NEAR recipient ${accept.payTo} isn't registered on token ${accept.asset} (NEP-145 storage_deposit) \u2014 register it once (\u22480.00125 NEAR) before it can receive. (NEAR: not registered)`,
         { cause: err }
       );
     }
     if (isNearAffordability(err)) {
-      throw new (0, _chunkPA6YD3HLcjs.InsufficientFundsError)(
+      throw new (0, _chunkU35MG4TFcjs.InsufficientFundsError)(
         err instanceof Error ? err.message : "Insufficient NEAR balance for the payment.",
         { cause: err }
       );
     }
-    throw _nullishCoalesce(_chunkPA6YD3HLcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    throw _nullishCoalesce(_chunkU35MG4TFcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 async function payNearNative(params) {
@@ -74,12 +74,12 @@ async function payNearNative(params) {
     return res.hash;
   } catch (err) {
     if (isNearAffordability(err)) {
-      throw new (0, _chunkPA6YD3HLcjs.InsufficientFundsError)(
+      throw new (0, _chunkU35MG4TFcjs.InsufficientFundsError)(
         err instanceof Error ? err.message : "Insufficient NEAR balance for the payment.",
         { cause: err }
       );
     }
-    throw _nullishCoalesce(_chunkPA6YD3HLcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    throw _nullishCoalesce(_chunkU35MG4TFcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 function isNearRegistrationError(err) {
@@ -216,22 +216,22 @@ function txNotFound(hash) {
 
 function assertNearWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
       `chain ${network} is NEAR; wallet must be { accountId, privateKey } (privateKey = ed25519:\u2026).`
     );
   }
   if ("walletClient" in wallet) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
       `chain ${network} is NEAR; a viem { walletClient } can't be used \u2014 pass { accountId, privateKey }.`
     );
   }
   if ("secretKey" in wallet || "signer" in wallet || "mnemonic" in wallet || "keyPair" in wallet || "secret" in wallet || "seed" in wallet || "keypair" in wallet) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
       `chain ${network} is NEAR; that looks like another family's wallet \u2014 pass { accountId, privateKey }.`
     );
   }
   if (!("accountId" in wallet) || !("privateKey" in wallet)) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
       `chain ${network} is NEAR; wallet must be { accountId, privateKey } (privateKey = ed25519:\u2026).`
     );
   }
@@ -239,13 +239,13 @@ function assertNearWallet(wallet, network) {
 }
 function resolveNearWallet(config) {
   if (!config.accountId || !config.privateKey) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)("NEAR wallet needs { accountId, privateKey } (privateKey = ed25519:\u2026).");
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)("NEAR wallet needs { accountId, privateKey } (privateKey = ed25519:\u2026).");
   }
   let signer;
   try {
     signer = _nearapijs.KeyPairSigner.fromSecretKey(config.privateKey);
   } catch (cause) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)("NEAR wallet { privateKey } is not a valid ed25519:\u2026 secret key.", {
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)("NEAR wallet { privateKey } is not a valid ed25519:\u2026 secret key.", {
       cause
     });
   }
@@ -312,16 +312,16 @@ function makeNearNetwork(preset, rpcUrl) {
         const info = preset.tokens[token.toUpperCase()];
         if (!info) {
           const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
-          throw new (0, _chunkPA6YD3HLcjs.UnknownTokenError)(
+          throw new (0, _chunkU35MG4TFcjs.UnknownTokenError)(
             `token "${token}" isn't built in for NEAR (known: ${known}). Pass { contractId, decimals } for a custom NEP-141.`
           );
         }
         return { asset: info.contractId, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkPA6YD3HLcjs.rejectForeignToken.call(void 0, token, "near", network);
+      _chunkU35MG4TFcjs.rejectForeignToken.call(void 0, token, "near", network);
       const t = token;
       if (!t.contractId || typeof t.decimals !== "number") {
-        throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+        throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
           `chain ${network} is NEAR; a custom token must be { contractId, decimals }.`
         );
       }
@@ -340,12 +340,12 @@ function makeNearNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+        throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
           `chain ${network} is NEAR, but payTo "${payTo}" looks like an EVM/Sui 0x address.`
         );
       }
       if (!isValidNearAccountId(payTo)) {
-        throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+        throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
           `chain ${network} is NEAR, but payTo "${payTo}" is not a valid NEAR account id.`
         );
       }
@@ -389,10 +389,10 @@ function makeNearNetwork(preset, rpcUrl) {
         if (tx && tx.success) return { height: "0" };
       } catch (e7) {
       }
-      throw new (0, _chunkPA6YD3HLcjs.ConfirmationTimeoutError)(`NEAR tx ${hash} not confirmed in time.`);
+      throw new (0, _chunkU35MG4TFcjs.ConfirmationTimeoutError)(`NEAR tx ${hash} not confirmed in time.`);
     },
     async estimateCost() {
-      return _chunkPA6YD3HLcjs.nativeCost.call(void 0, {
+      return _chunkU35MG4TFcjs.nativeCost.call(void 0, {
         symbol: "NEAR",
         decimals: NEAR_DECIMALS,
         fee: 1500000000000000000000n,

package/dist/{near-LM7S3WUD.js → near-TWA4PYOD.js}

@@ -7,7 +7,7 @@ import {
   nativeCost,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-ILPABTI2.js";
+} from "./chunk-L6WQRHEZ.js";
 
 // src/drivers/near/index.ts
 import { JsonRpcProvider, Account, actions } from "near-api-js";

package/dist/{solana-IBVUZS54.js → solana-KWNRY5NR.js}

@@ -7,7 +7,7 @@ import {
   nativeCost,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-ILPABTI2.js";
+} from "./chunk-L6WQRHEZ.js";
 
 // src/drivers/solana/index.ts
 import { Connection, PublicKey as PublicKey3 } from "@solana/web3.js";

package/dist/{solana-WG7RGDSI.cjs → solana-UEMHFQH5.cjs}

@@ -7,7 +7,7 @@
 
 
 
-var _chunkPA6YD3HLcjs = require('./chunk-PA6YD3HL.cjs');
+var _chunkU35MG4TFcjs = require('./chunk-U35MG4TF.cjs');
 
 // src/drivers/solana/index.ts
 var _web3js = require('@solana/web3.js');
@@ -229,15 +229,15 @@ function isEmptySig(sig) {
 async function payExactSolana(input) {
   const { connection, keypair, accept } = input;
   if (accept.asset === "native") {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)(
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)(
       "SVM exact is SPL-token only (TransferChecked); native SOL is not exact-payable. Pay via onchain-proof."
     );
   }
   if (!accept.extra.feePayer) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)("SVM exact rail must advertise extra.feePayer (the merchant sponsor key).");
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)("SVM exact rail must advertise extra.feePayer (the merchant sponsor key).");
   }
   if (accept.extra.decimals === void 0) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)("SVM exact rail must advertise extra.decimals for the TransferChecked.");
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)("SVM exact rail must advertise extra.decimals for the TransferChecked.");
   }
   let feePayer;
   let mint;
@@ -247,12 +247,12 @@ async function payExactSolana(input) {
     mint = new (0, _web3js.PublicKey)(accept.asset);
     payTo = new (0, _web3js.PublicKey)(accept.payTo);
   } catch (err) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)(
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)(
       `SVM exact: bad feePayer/asset/payTo (${err instanceof Error ? err.message : String(err)}).`
     );
   }
   if (feePayer.equals(payTo)) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)(
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)(
       "SVM exact: the fee payer must differ from payTo \u2014 payTo appears in the transfer instruction, which the fee payer must not (a scheme MUST-rule). Use a separate relayer key for the gate."
     );
   }
@@ -266,7 +266,7 @@ async function payExactSolana(input) {
     destInfo = "unknown";
   }
   if (destInfo === null) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)(
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)(
       `SVM exact: the recipient's token account for ${mint.toBase58()} doesn't exist yet \u2014 the exact rail can't create it. Pay via onchain-proof (which creates it), or have ${payTo.toBase58()} create its associated token account first.`
     );
   }
@@ -294,11 +294,11 @@ async function payExactSolana(input) {
   tx.sign([keypair]);
   const buyerIndex = message.staticAccountKeys.findIndex((k) => k.equals(keypair.publicKey));
   if (buyerIndex < 1 || buyerIndex >= message.header.numRequiredSignatures) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)("SVM exact: could not locate the buyer signer slot.");
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)("SVM exact: could not locate the buyer signer slot.");
   }
   const buyerSig = tx.signatures[buyerIndex];
   if (!buyerSig || isEmptySig(buyerSig)) {
-    throw new (0, _chunkPA6YD3HLcjs.UnsupportedSchemeError)("SVM exact: the wallet did not produce a buyer signature.");
+    throw new (0, _chunkU35MG4TFcjs.UnsupportedSchemeError)("SVM exact: the wallet did not produce a buyer signature.");
   }
   const transaction = Buffer.from(tx.serialize()).toString("base64");
   return {
@@ -325,15 +325,15 @@ async function verifyAndSettleExactSolana(input) {
     if (!accept.extra.feePayer) throw new Error("rail is missing extra.feePayer");
     railFeePayer = new (0, _web3js.PublicKey)(accept.extra.feePayer);
   } catch (err) {
-    throw new (0, _chunkPA6YD3HLcjs.SettlementError)(`SVM exact: rail has a bad payTo/asset/feePayer (${err instanceof Error ? err.message : String(err)}).`);
+    throw new (0, _chunkU35MG4TFcjs.SettlementError)(`SVM exact: rail has a bad payTo/asset/feePayer (${err instanceof Error ? err.message : String(err)}).`);
   }
   if (!railFeePayer.equals(feePayerKeypair.publicKey)) {
-    throw new (0, _chunkPA6YD3HLcjs.SettlementError)(
+    throw new (0, _chunkU35MG4TFcjs.SettlementError)(
       "SVM exact: the gate relayer key does not match the rail extra.feePayer \u2014 misconfigured rail."
     );
   }
   if (feePayerKeypair.publicKey.equals(payTo)) {
-    throw new (0, _chunkPA6YD3HLcjs.SettlementError)("SVM exact: the fee payer must differ from payTo \u2014 misconfigured rail.");
+    throw new (0, _chunkU35MG4TFcjs.SettlementError)("SVM exact: the fee payer must differ from payTo \u2014 misconfigured rail.");
   }
   const program = tokenProgramFor(accept);
   let tx;
@@ -457,7 +457,7 @@ async function verifyAndSettleExactSolana(input) {
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (/blockhash|block height|expired/i.test(msg)) return fail("payment_expired", `Settle broadcast rejected \u2014 blockhash expired: ${shorten(msg)}.`);
-    throw new (0, _chunkPA6YD3HLcjs.SettlementError)(
+    throw new (0, _chunkU35MG4TFcjs.SettlementError)(
       `SVM exact settle: the merchant fee payer failed to broadcast (${shorten(msg)}). The buyer's signed transaction is still valid \u2014 fund/fix the fee payer and the buyer can re-present it.`,
       { cause: err }
     );
@@ -467,7 +467,7 @@ async function verifyAndSettleExactSolana(input) {
     return fail("tx_reverted", `Settle tx ${txid} reverted on-chain (a post-simulate race).`);
   }
   if (confirmed === "timeout") {
-    throw new (0, _chunkPA6YD3HLcjs.SettlementError)(
+    throw new (0, _chunkU35MG4TFcjs.SettlementError)(
       `SVM exact settle: broadcast ${txid} but it did not confirm in time. It likely landed \u2014 re-verify by signature before re-presenting; do NOT re-pay.`
     );
   }
@@ -510,12 +510,12 @@ async function pollConfirmed(connection, signature) {
 
 function toKeypair(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
       `chain ${network} is Solana; wallet must be { secretKey } or { signer }.`
     );
   }
   if ("privateKey" in wallet || "walletClient" in wallet) {
-    throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+    throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
       `chain ${network} is Solana; an EVM wallet can't be used \u2014 pass { secretKey } or { signer }.`
     );
   }
@@ -527,7 +527,7 @@ function toKeypair(wallet, network) {
     const bytes = typeof sk === "string" ? _bs582.default.decode(sk) : sk;
     return _web3js.Keypair.fromSecretKey(bytes);
   }
-  throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+  throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
     `chain ${network} is Solana; wallet must be { secretKey } or { signer }.`
   );
 }
@@ -556,15 +556,15 @@ function makeSolanaNetwork(preset, rpcUrl) {
         const info = preset.tokens[token.toUpperCase()];
         if (!info) {
           const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
-          throw new (0, _chunkPA6YD3HLcjs.UnknownTokenError)(
+          throw new (0, _chunkU35MG4TFcjs.UnknownTokenError)(
             `token "${token}" isn't built in for Solana (known: ${known}). Pass { mint, decimals } instead, or use 'native'.`
           );
         }
         return { asset: info.mint, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkPA6YD3HLcjs.rejectForeignToken.call(void 0, token, "solana", network);
+      _chunkU35MG4TFcjs.rejectForeignToken.call(void 0, token, "solana", network);
       if (!("mint" in token)) {
-        throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+        throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
           `chain ${network} is Solana; a custom token must be { mint, decimals }.`
         );
       }
@@ -583,14 +583,14 @@ function makeSolanaNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+        throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
           `chain ${network} is Solana, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       try {
         new (0, _web3js.PublicKey)(payTo);
       } catch (e7) {
-        throw new (0, _chunkPA6YD3HLcjs.WrongFamilyError)(
+        throw new (0, _chunkU35MG4TFcjs.WrongFamilyError)(
           `chain ${network} is Solana, but payTo "${payTo}" is not a base58 address.`
         );
       }
@@ -602,7 +602,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
       try {
         return await paySolana({ connection, keypair: wallet._native, accept });
       } catch (err) {
-        throw _nullishCoalesce(_chunkPA6YD3HLcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+        throw _nullishCoalesce(_chunkU35MG4TFcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
       }
     },
     async confirm(ref) {
@@ -613,19 +613,19 @@ function makeSolanaNetwork(preset, rpcUrl) {
         });
         info = value[0];
       } catch (err) {
-        throw new (0, _chunkPA6YD3HLcjs.ConfirmationTimeoutError)(
+        throw new (0, _chunkU35MG4TFcjs.ConfirmationTimeoutError)(
           `Solana payment ${ref} could not be confirmed (RPC read failed).`,
           { cause: err }
         );
       }
       if (!info || info.err || info.confirmationStatus !== "confirmed" && info.confirmationStatus !== "finalized") {
-        throw new (0, _chunkPA6YD3HLcjs.ConfirmationTimeoutError)(`Solana payment ${ref} did not confirm in time.`);
+        throw new (0, _chunkU35MG4TFcjs.ConfirmationTimeoutError)(`Solana payment ${ref} did not confirm in time.`);
       }
       return { height: String(info.slot) };
     },
     async estimateCost(accept) {
       if (accept.scheme === "exact") {
-        return _chunkPA6YD3HLcjs.nativeCost.call(void 0, {
+        return _chunkU35MG4TFcjs.nativeCost.call(void 0, {
           symbol: "SOL",
           decimals: SOL_DECIMALS,
           fee: 0n,
@@ -635,7 +635,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
       }
       const base = 5000n;
       if (accept.asset === "native") {
-        return _chunkPA6YD3HLcjs.nativeCost.call(void 0, {
+        return _chunkU35MG4TFcjs.nativeCost.call(void 0, {
           symbol: "SOL",
           decimals: SOL_DECIMALS,
           fee: base,
@@ -644,7 +644,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
         });
       }
       const ataRent = 2039280n;
-      return _chunkPA6YD3HLcjs.nativeCost.call(void 0, {
+      return _chunkU35MG4TFcjs.nativeCost.call(void 0, {
         symbol: "SOL",
         decimals: SOL_DECIMALS,
         fee: base + ataRent,