@toon-protocol/client 0.14.11 → 0.14.12

package/dist/index.d.ts

@@ -1373,6 +1373,26 @@ declare class ConnectorError extends ToonClientError {
 declare class ValidationError extends ToonClientError {
     constructor(message: string, cause?: Error);
 }
+/**
+ * Thrown when the one-time on-chain payment-channel OPEN reverts because the
+ * local settlement wallet has no native gas to pay for its own
+ * approve/openChannel/setTotalDeposit transactions. This is the channel OPEN
+ * only — per-write settlement rides ILP-over-HTTP and never spends gas. We
+ * remap ONLY this case so callers get an actionable message (fund the wallet)
+ * instead of the raw viem "...exceeds the balance of the account" string
+ * (toon-meta#65). Retryable once the wallet is funded; the underlying viem/RPC
+ * error is preserved as `cause`.
+ */
+declare class ChannelFundingError extends ToonClientError {
+    readonly retryable = true;
+    constructor(message: string, cause?: Error);
+}
+/**
+ * True when `err` (or any error in its nested `cause` chain) is an
+ * insufficient-native-gas revert. viem wraps the node error one or more levels
+ * deep, so the whole chain is flattened and scanned.
+ */
+declare function isInsufficientGasError(err: unknown): boolean;
 
 /**
  * Configuration options for HttpRuntimeClient.
@@ -2316,14 +2336,22 @@ declare class OnChainChannelClient implements ConnectorChannelClient {
      */
     private openMinaChannel;
     /**
-     * Opens an EVM payment channel on-chain.
+     * Opens an EVM payment channel on-chain, remapping the one-time
+     * insufficient-native-gas revert into an actionable {@link ChannelFundingError}
+     * so callers surface "fund the wallet" instead of the raw viem
+     * "...exceeds the balance of the account" string (toon-meta#65). Only the gas
+     * case is remapped; every other error propagates unchanged.
+     */
+    private openEvmChannel;
+    /**
+     * Raw EVM channel-open (no gas-error remapping — see {@link openEvmChannel}).
      *
      * 1. Approve token spend if needed
      * 2. Call TokenNetwork.openChannel()
      * 3. Extract channelId from ChannelOpened event
      * 4. Deposit initial funds if specified
      */
-    private openEvmChannel;
+    private openEvmChannelUnchecked;
     /**
      * Gets the current state of a payment channel from on-chain data.
      */
@@ -3551,4 +3579,4 @@ declare function loadKeystore(path: string, password: string): string;
  */
 declare function writeKeystoreFile(path: string, keystore: EncryptedKeystore): void;
 
-export { type BackupPayload, type BalanceProofParams, BtpRuntimeClient, type BtpRuntimeClientConfig, type ChainMetadata, type ChainSigner, ChannelManager, type ClaimMessage, type ClaimResolver, ConnectorError, type DiscoveredIlpPeer, type EVMClaimMessage, type EncryptedKeystore, EvmSigner, type FaucetChain, type FundWalletOptions, type FundWalletResult, type H402FetchOptions, Http402Client, type Http402ClientConfig, HttpConnectorAdmin, type HttpConnectorAdminConfig, HttpIlpClient, type HttpIlpClientConfig, type HttpIlpClientFactory, HttpRuntimeClient, type HttpRuntimeClientConfig, ILP_CLAIM_HEADER, ILP_CLAIM_WRAPPED_HEADER, ILP_PEER_ID_HEADER, type IlpTransportChoice, type InteractionResultContent, KeyManager, type KeyManagerConfig, type MinaClaimMessage, type MinaDepositReader, MinaSigner, type MinaSignerOptions, NetworkError, OnChainChannelClient, type OnChainChannelClientConfig, type ParsedFulfillHttp, type ParsedX402Challenge, type PasskeyInfo, type PetDvmProvider, type PetInteractionEventData, type PetInteractionRequestParams, type PetInteractionResultData, type PetListing, type PetListingFilterOptions, type PetListingParams, type PetPurchaseRequestParams, type ProofStatus, type PublishEventResult, type RequestBlobStorageParams, type RequestBlobStorageResult, type RetryOptions, type SelectIlpTransportOptions, type SignedBalanceProof, type SolanaChannelClientOptions, type SolanaClaimMessage, SolanaSigner, type StatValues, type ToonChannelAccept, ToonClient, type ToonClientConfig, ToonClientError, type ToonIdentity, type ToonSigners, type ToonStartResult, type UnsignedNostrEvent, ValidationError, type VaultData, applyDefaults, applyNetworkPresets, buildBackupEvent, buildBackupFilter, buildPetInteractionRequest, buildPetListingEvent, buildPetPurchaseRequest, buildSettlementInfo, buildStoreWriteEnvelope, decryptMnemonic, defaultFaucetTimeout, deriveFromNsec, deriveFullIdentity, deriveNostrKeyFromMnemonic, encryptMnemonic, filterPetDvmProviders, filterPetListings, fundWallet, generateKeystore, generateMnemonic, generateRandomIdentity, getNetworkStatus, httpEndpointToBtpUrl, importKeystore, isPrfSupported, loadKeystore, parseBackupPayload, parseFulfillHttp, parseFulfillHttpBytes, parseHttpResponse, parsePetInteractionEvent, parsePetInteractionResult, parsePetListing, parseX402Body, parseX402Challenge, proxyIlpEndpoint, readDiscoveredIlpPeer, readMinaDepositTotal, requestBlobStorage, selectIlpTransport, serializeHttpRequest, validateConfig, validateMnemonic, withRetry, writeKeystoreFile };
+export { type BackupPayload, type BalanceProofParams, BtpRuntimeClient, type BtpRuntimeClientConfig, type ChainMetadata, type ChainSigner, ChannelFundingError, ChannelManager, type ClaimMessage, type ClaimResolver, ConnectorError, type DiscoveredIlpPeer, type EVMClaimMessage, type EncryptedKeystore, EvmSigner, type FaucetChain, type FundWalletOptions, type FundWalletResult, type H402FetchOptions, Http402Client, type Http402ClientConfig, HttpConnectorAdmin, type HttpConnectorAdminConfig, HttpIlpClient, type HttpIlpClientConfig, type HttpIlpClientFactory, HttpRuntimeClient, type HttpRuntimeClientConfig, ILP_CLAIM_HEADER, ILP_CLAIM_WRAPPED_HEADER, ILP_PEER_ID_HEADER, type IlpTransportChoice, type InteractionResultContent, KeyManager, type KeyManagerConfig, type MinaClaimMessage, type MinaDepositReader, MinaSigner, type MinaSignerOptions, NetworkError, OnChainChannelClient, type OnChainChannelClientConfig, type ParsedFulfillHttp, type ParsedX402Challenge, type PasskeyInfo, type PetDvmProvider, type PetInteractionEventData, type PetInteractionRequestParams, type PetInteractionResultData, type PetListing, type PetListingFilterOptions, type PetListingParams, type PetPurchaseRequestParams, type ProofStatus, type PublishEventResult, type RequestBlobStorageParams, type RequestBlobStorageResult, type RetryOptions, type SelectIlpTransportOptions, type SignedBalanceProof, type SolanaChannelClientOptions, type SolanaClaimMessage, SolanaSigner, type StatValues, type ToonChannelAccept, ToonClient, type ToonClientConfig, ToonClientError, type ToonIdentity, type ToonSigners, type ToonStartResult, type UnsignedNostrEvent, ValidationError, type VaultData, applyDefaults, applyNetworkPresets, buildBackupEvent, buildBackupFilter, buildPetInteractionRequest, buildPetListingEvent, buildPetPurchaseRequest, buildSettlementInfo, buildStoreWriteEnvelope, decryptMnemonic, defaultFaucetTimeout, deriveFromNsec, deriveFullIdentity, deriveNostrKeyFromMnemonic, encryptMnemonic, filterPetDvmProviders, filterPetListings, fundWallet, generateKeystore, generateMnemonic, generateRandomIdentity, getNetworkStatus, httpEndpointToBtpUrl, importKeystore, isInsufficientGasError, isPrfSupported, loadKeystore, parseBackupPayload, parseFulfillHttp, parseFulfillHttpBytes, parseHttpResponse, parsePetInteractionEvent, parsePetInteractionResult, parsePetListing, parseX402Body, parseX402Challenge, proxyIlpEndpoint, readDiscoveredIlpPeer, readMinaDepositTotal, requestBlobStorage, selectIlpTransport, serializeHttpRequest, validateConfig, validateMnemonic, withRetry, writeKeystoreFile };

package/dist/index.js

@@ -80,6 +80,29 @@ var PeerAlreadyExistsError = class extends ToonClientError {
     this.name = "PeerAlreadyExistsError";
   }
 };
+var ChannelFundingError = class extends ToonClientError {
+  retryable = true;
+  constructor(message, cause) {
+    super(message, "CHANNEL_FUNDING", cause);
+    this.name = "ChannelFundingError";
+  }
+};
+var INSUFFICIENT_GAS_MARKERS = [
+  "exceeds the balance of the account",
+  "insufficient funds for gas",
+  "insufficient funds for intrinsic transaction cost",
+  "insufficient funds for transfer"
+];
+function isInsufficientGasError(err) {
+  const parts = [];
+  let cur = err;
+  for (let i = 0; i < 10 && cur != null; i++) {
+    parts.push(cur instanceof Error ? cur.message : String(cur));
+    cur = cur instanceof Error ? cur.cause : void 0;
+  }
+  const text = parts.join(" | ").toLowerCase();
+  return INSUFFICIENT_GAS_MARKERS.some((m) => text.includes(m));
+}
 
 // src/keys/KeyDerivation.ts
 import { generateSecretKey, getPublicKey } from "nostr-tools/pure";
@@ -2790,14 +2813,33 @@ var OnChainChannelClient = class {
     };
   }
   /**
-   * Opens an EVM payment channel on-chain.
+   * Opens an EVM payment channel on-chain, remapping the one-time
+   * insufficient-native-gas revert into an actionable {@link ChannelFundingError}
+   * so callers surface "fund the wallet" instead of the raw viem
+   * "...exceeds the balance of the account" string (toon-meta#65). Only the gas
+   * case is remapped; every other error propagates unchanged.
+   */
+  async openEvmChannel(params) {
+    try {
+      return await this.openEvmChannelUnchecked(params);
+    } catch (err) {
+      if (!isInsufficientGasError(err)) throw err;
+      const chainFamily = params.chain.split(":")[0] || params.chain;
+      throw new ChannelFundingError(
+        `Settlement wallet ${this.evmSigner.address} has no gas on ${chainFamily} to open a payment channel. Run toon_fund_wallet (or fund the wallet) and retry.`,
+        err instanceof Error ? err : void 0
+      );
+    }
+  }
+  /**
+   * Raw EVM channel-open (no gas-error remapping — see {@link openEvmChannel}).
    *
    * 1. Approve token spend if needed
    * 2. Call TokenNetwork.openChannel()
    * 3. Extract channelId from ChannelOpened event
    * 4. Deposit initial funds if specified
    */
-  async openEvmChannel(params) {
+  async openEvmChannelUnchecked(params) {
     const {
       chain,
       tokenNetwork,
@@ -7100,6 +7142,7 @@ function writeKeystoreFile(path, keystore) {
 }
 export {
   BtpRuntimeClient,
+  ChannelFundingError,
   ChannelManager,
   ConnectorError,
   EvmSigner,
@@ -7157,6 +7200,7 @@ export {
   guardedRenderDispatch,
   httpEndpointToBtpUrl,
   importKeystore,
+  isInsufficientGasError,
   isPrfSupported,
   isTrustDowngrade,
   loadKeystore,