@toon-protocol/client 0.14.1 → 0.14.3

package/dist/index.d.ts

@@ -1067,6 +1067,9 @@ declare class ToonClient {
         destination?: string;
         claim?: SignedBalanceProof;
         ilpAmount?: bigint;
+        /** HTTP request-target the payment-proxy replays (default '/write', the
+         *  relay; use '/store' for the Arweave store/DVM backend). */
+        proxyPath?: string;
     }): Promise<PublishEventResult>;
     /**
      * Payment-aware HTTP fetch over TOON (issue #50). A `fetch()`-like method that
@@ -2367,14 +2370,16 @@ declare function withRetry<T>(operation: () => Promise<T>, options: RetryOptions
  */
 
 /**
- * Wrap a signed Nostr event in the `POST /write` HTTP envelope the deployed
- * payment-proxy reverse-proxies to the relay store.
+ * Wrap a signed Nostr event in the HTTP envelope the deployed payment-proxy
+ * reverse-proxies to its backend. Defaults to the relay's `POST /write`; pass
+ * `requestTarget: '/store'` for the Arweave store/DVM backend.
  *
  * @param event - A finalized (signed) Nostr event — passed through to the store
  *   as the JSON `event` field verbatim (the store re-verifies the signature).
+ * @param requestTarget - HTTP request-target the proxy replays (default `/write`).
  * @returns The envelope bytes to use as the ILP PREPARE `data`.
  */
-declare function buildStoreWriteEnvelope(event: NostrEvent): Uint8Array;
+declare function buildStoreWriteEnvelope(event: NostrEvent, requestTarget?: string): Uint8Array;
 
 /**
  * Shared parser for the HTTP-over-ILP response carried in an ILP **FULFILL**
@@ -2972,9 +2977,24 @@ interface FundWalletResult {
 interface FundWalletOptions {
     /** Custom fetch implementation (for testing / custom transports). */
     fetchImpl?: typeof fetch;
-    /** Request timeout in milliseconds (default: 30000). */
+    /**
+     * Request timeout in milliseconds. Defaults to {@link defaultFaucetTimeout}
+     * for the chain (fast 30s for evm/solana, a longer 120s for the slow-settling
+     * mina faucet).
+     */
     timeout?: number;
 }
+/**
+ * Default faucet request timeout (ms) for a chain.
+ *
+ * EVM and Solana faucets respond in a few seconds, so 30s is plenty. The Mina
+ * faucet sends native MINA *and* mints USDC on a chain that settles much more
+ * slowly: the drip routinely succeeds server-side (the faucet logs
+ * `✅ Mina faucet request completed`) but takes well over 30s to answer the
+ * HTTP request, so a flat 30s budget makes the client give up on a request that
+ * actually worked. Give mina a much longer budget.
+ */
+declare function defaultFaucetTimeout(chain: FaucetChain): number;
 /**
  * Drip test funds to `address` on `chain` from the devnet `faucetUrl`.
  *
@@ -3336,4 +3356,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, 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, 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 };

package/dist/index.js

@@ -510,11 +510,11 @@ function isBase64(str) {
 }
 
 // src/utils/store-envelope.ts
-var REQUEST_LINE = "POST /write HTTP/1.1";
+var DEFAULT_REQUEST_TARGET = "/write";
 var HEADERS = ["Host: relay", "Content-Type: application/json"];
-function buildStoreWriteEnvelope(event) {
+function buildStoreWriteEnvelope(event, requestTarget = DEFAULT_REQUEST_TARGET) {
   const body = JSON.stringify({ event });
-  const head = [REQUEST_LINE, ...HEADERS].join("\r\n");
+  const head = [`POST ${requestTarget} HTTP/1.1`, ...HEADERS].join("\r\n");
   return encodeUtf8(head + "\r\n\r\n" + body);
 }
 
@@ -2351,12 +2351,12 @@ var OnChainChannelClient = class {
    */
   parseChainId(chain) {
     const parts = chain.split(":");
-    if (parts.length < 3) {
+    if (parts.length < 2) {
       throw new Error(
-        `Invalid chain format: "${chain}". Expected "evm:{network}:{chainId}".`
+        `Invalid chain format: "${chain}". Expected "evm:{network}:{chainId}" or "evm:{chainId}".`
       );
     }
-    const chainIdStr = parts[2];
+    const chainIdStr = parts.length >= 3 ? parts[2] : parts[1];
     if (!chainIdStr) {
       throw new Error(
         `Invalid chain format: "${chain}". Expected "evm:{network}:{chainId}".`
@@ -3582,7 +3582,9 @@ async function requestBlobStorage(client, secretKey, params) {
   const result = await client.publishEvent(event, {
     destination: params.destination,
     claim: params.claim,
-    ilpAmount: params.ilpAmount
+    ilpAmount: params.ilpAmount,
+    // The store/DVM backend serves POST /store (not the relay's /write).
+    proxyPath: "/store"
   });
   if (!result.success) {
     return {
@@ -4086,7 +4088,7 @@ var ToonClient = class {
         if (result.negotiatedChain && result.settlementAddress) {
           const chainType = result.negotiatedChain.split(":")[0] ?? "evm";
           const parts = result.negotiatedChain.split(":");
-          const chainId = parts.length >= 3 ? parseInt(parts[2] ?? "0", 10) : 0;
+          const chainId = parts.length >= 3 ? parseInt(parts[2] ?? "0", 10) : parts.length >= 2 ? parseInt(parts[1] ?? "0", 10) : 0;
           const r = result;
           this.peerNegotiations.set(result.registeredPeerId, {
             chain: result.negotiatedChain,
@@ -4104,7 +4106,7 @@ var ToonClient = class {
           if (matchedChain) {
             const peerAddr = peerInfo.settlementAddresses?.[matchedChain];
             const parts = matchedChain.split(":");
-            const chainId = parts.length >= 3 ? parseInt(parts[2] ?? "0", 10) : 0;
+            const chainId = parts.length >= 3 ? parseInt(parts[2] ?? "0", 10) : parts.length >= 2 ? parseInt(parts[1] ?? "0", 10) : 0;
             if (peerAddr) {
               this.peerNegotiations.set(result.registeredPeerId, {
                 chain: matchedChain,
@@ -4189,7 +4191,7 @@ var ToonClient = class {
       const toonData = this.config.toonEncoder(event);
       const basePricePerByte = 10n;
       const amount = options?.ilpAmount !== void 0 ? String(options.ilpAmount) : String(BigInt(toonData.length) * basePricePerByte);
-      const writeData = buildStoreWriteEnvelope(event);
+      const writeData = buildStoreWriteEnvelope(event, options?.proxyPath);
       const destination = options?.destination ?? this.config.destinationAddress;
       const transport = this.getClaimTransport();
       let claimMessage;
@@ -4561,7 +4563,7 @@ var ToonClient = class {
   getChainContext(negotiatedChain) {
     if (!negotiatedChain) return void 0;
     const parts = negotiatedChain.split(":");
-    const chainIdPart = parts.length >= 3 ? parts[2] : void 0;
+    const chainIdPart = parts.length >= 3 ? parts[2] : parts.length >= 2 ? parts[1] : void 0;
     const numericChainId = chainIdPart !== void 0 ? parseInt(chainIdPart, 10) : NaN;
     if (isNaN(numericChainId)) return void 0;
     const tokenNetworkAddress = this.config.tokenNetworks?.[negotiatedChain];
@@ -5412,6 +5414,9 @@ function buildPetPurchaseRequest(params) {
 }
 
 // src/faucet.ts
+function defaultFaucetTimeout(chain) {
+  return chain === "mina" ? 12e4 : 3e4;
+}
 function faucetPath(chain) {
   switch (chain) {
     case "evm":
@@ -5432,7 +5437,7 @@ async function fundWallet(faucetUrl, address, chain, options = {}) {
   const base = faucetUrl.replace(/\/+$/, "");
   const url = `${base}${faucetPath(chain)}`;
   const fetchImpl = options.fetchImpl ?? fetch;
-  const timeout = options.timeout ?? 3e4;
+  const timeout = options.timeout ?? defaultFaucetTimeout(chain);
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), timeout);
   let response;
@@ -6555,6 +6560,7 @@ export {
   buildUiCoordinate,
   classifyIntent,
   decryptMnemonic2 as decryptMnemonic,
+  defaultFaucetTimeout,
   deriveFromNsec,
   deriveFullIdentity,
   deriveNostrKeyFromMnemonic,