@piprail/sdk 1.0.0 → 1.1.1

package/dist/{tron-3UDH7KGF.cjs → tron-V3A6L3X3.cjs}

@@ -9,7 +9,7 @@ var _chunkCQREG5LEcjs = require('./chunk-CQREG5LE.cjs');
 
 
 
-var _chunkWQWNPAYQcjs = require('./chunk-WQWNPAYQ.cjs');
+var _chunkNK64H3RMcjs = require('./chunk-NK64H3RM.cjs');
 
 // src/drivers/tron/index.ts
 var _tronweb = require('tronweb');
@@ -61,7 +61,7 @@ async function payTron(params) {
       return _nullishCoalesce(_nullishCoalesce(broadcast.txid, () => ( _optionalChain([broadcast, 'access', _7 => _7.transaction, 'optionalAccess', _8 => _8.txID]))), () => ( signed.txID));
     }
     if (isTronAffordability(broadcast.code, broadcast.message)) {
-      throw new (0, _chunkWQWNPAYQcjs.InsufficientFundsError)(
+      throw new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
         `Tron payment rejected (${_nullishCoalesce(broadcast.code, () => ( "broadcast"))}): not enough TRX for energy/bandwidth, or insufficient token balance.`
       );
     }
@@ -69,8 +69,30 @@ async function payTron(params) {
       `Tron broadcast failed: ${_nullishCoalesce(broadcast.code, () => ( ""))} ${decodeMaybeHex(broadcast.message)}`.trim()
     );
   } catch (err) {
-    if (err instanceof _chunkWQWNPAYQcjs.InsufficientFundsError) throw err;
-    throw _nullishCoalesce(_chunkWQWNPAYQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    if (err instanceof _chunkNK64H3RMcjs.InsufficientFundsError) throw err;
+    throw _nullishCoalesce(_chunkNK64H3RMcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+  }
+}
+async function payTronNative(params) {
+  const { client, from, privateKey, accept } = params;
+  try {
+    const unsigned = await client.transactionBuilder.sendTrx(accept.payTo, Number(accept.amount), from);
+    const signed = await client.trx.sign(unsigned, privateKey);
+    const broadcast = await client.trx.sendRawTransaction(signed);
+    if (broadcast.result === true || broadcast.txid || _optionalChain([broadcast, 'access', _9 => _9.transaction, 'optionalAccess', _10 => _10.txID])) {
+      return _nullishCoalesce(_nullishCoalesce(broadcast.txid, () => ( _optionalChain([broadcast, 'access', _11 => _11.transaction, 'optionalAccess', _12 => _12.txID]))), () => ( signed.txID));
+    }
+    if (isTronAffordability(broadcast.code, broadcast.message)) {
+      throw new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
+        `Tron TRX payment rejected (${_nullishCoalesce(broadcast.code, () => ( "broadcast"))}): not enough TRX for the amount plus bandwidth (and the ~1 TRX account-creation fee if the recipient is new).`
+      );
+    }
+    throw new Error(
+      `Tron TRX broadcast failed: ${_nullishCoalesce(broadcast.code, () => ( ""))} ${decodeMaybeHex(broadcast.message)}`.trim()
+    );
+  } catch (err) {
+    if (err instanceof _chunkNK64H3RMcjs.InsufficientFundsError) throw err;
+    throw _nullishCoalesce(_chunkNK64H3RMcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 function decodeMaybeHex(message) {
@@ -104,11 +126,11 @@ async function verifyTron(params) {
     return txNotFound(txid);
   }
   if (!info || !info.id) return txNotFound(txid);
-  if (_optionalChain([info, 'access', _9 => _9.receipt, 'optionalAccess', _10 => _10.result]) !== "SUCCESS") {
+  if (_optionalChain([info, 'access', _13 => _13.receipt, 'optionalAccess', _14 => _14.result]) !== "SUCCESS") {
     return {
       ok: false,
       error: "tx_reverted",
-      detail: `Tron tx ${txid} did not succeed (receipt.result=${_nullishCoalesce(_optionalChain([info, 'access', _11 => _11.receipt, 'optionalAccess', _12 => _12.result]), () => ( "none"))}).`
+      detail: `Tron tx ${txid} did not succeed (receipt.result=${_nullishCoalesce(_optionalChain([info, 'access', _15 => _15.receipt, 'optionalAccess', _16 => _16.result]), () => ( "none"))}).`
     };
   }
   const ageSeconds = Math.floor(Date.now() / 1e3) - Math.floor(info.blockTimeStamp / 1e3);
@@ -142,6 +164,74 @@ async function verifyTron(params) {
     }
   };
 }
+async function verifyTronNative(params) {
+  const { reader, accept, txid, payToHex41, toBase58 } = params;
+  const required = BigInt(accept.amount);
+  let info;
+  try {
+    info = await reader.getTransactionInfo(txid);
+  } catch (e3) {
+    return txNotFound(txid);
+  }
+  if (!info || !info.id) return txNotFound(txid);
+  const ageSeconds = Math.floor(Date.now() / 1e3) - Math.floor(info.blockTimeStamp / 1e3);
+  if (Number.isFinite(ageSeconds) && ageSeconds > accept.maxTimeoutSeconds) {
+    return {
+      ok: false,
+      error: "payment_expired",
+      detail: `Payment is ${ageSeconds}s old; max allowed is ${accept.maxTimeoutSeconds}s.`
+    };
+  }
+  let tx;
+  try {
+    tx = await reader.getTransaction(txid);
+  } catch (e4) {
+    return txNotFound(txid);
+  }
+  if (!tx) return txNotFound(txid);
+  const ret = _optionalChain([tx, 'access', _17 => _17.ret, 'optionalAccess', _18 => _18[0], 'optionalAccess', _19 => _19.contractRet]);
+  if (ret && ret !== "SUCCESS") {
+    return { ok: false, error: "tx_reverted", detail: `Tron tx ${txid} did not succeed (contractRet=${ret}).` };
+  }
+  const contract = (_nullishCoalesce(_optionalChain([tx, 'access', _20 => _20.raw_data, 'optionalAccess', _21 => _21.contract]), () => ( [])))[0];
+  if (!contract || contract.type !== "TransferContract") {
+    return {
+      ok: false,
+      error: "transfer_not_found",
+      detail: `Tron tx ${txid} is not a native TRX transfer (TransferContract).`
+    };
+  }
+  const value = _nullishCoalesce(_optionalChain([contract, 'access', _22 => _22.parameter, 'optionalAccess', _23 => _23.value]), () => ( {}));
+  const to = String(_nullishCoalesce(value.to_address, () => ( ""))).toLowerCase().replace(/^0x/, "");
+  if (to !== payToHex41) {
+    return { ok: false, error: "wrong_recipient", detail: `Native TRX in ${txid} was not sent to ${accept.payTo}.` };
+  }
+  const amount = (() => {
+    try {
+      return BigInt(_nullishCoalesce(value.amount, () => ( 0)));
+    } catch (e5) {
+      return 0n;
+    }
+  })();
+  if (amount < required) {
+    return { ok: false, error: "amount_too_low", detail: `Sent ${amount} sun, required ${required}.` };
+  }
+  const from = String(_nullishCoalesce(value.owner_address, () => ( ""))).toLowerCase().replace(/^0x/, "");
+  return {
+    ok: true,
+    receipt: {
+      scheme: "onchain-proof",
+      success: true,
+      network: accept.network,
+      transaction: txid,
+      asset: "native",
+      amount: accept.amount,
+      payer: from ? toBase58(from) : "",
+      payTo: accept.payTo,
+      verifiedAt: (/* @__PURE__ */ new Date()).toISOString()
+    }
+  };
+}
 function sumTransfersTo(logs, tokenHex20, payToHex20) {
   let total = 0n;
   let from = null;
@@ -154,7 +244,7 @@ function sumTransfersTo(logs, tokenHex20, payToHex20) {
     try {
       total += BigInt(`0x${log.data}`);
       from = last20(topics[1]);
-    } catch (e3) {
+    } catch (e6) {
     }
   }
   return { total, from };
@@ -173,22 +263,22 @@ function txNotFound(txid) {
 // src/drivers/tron/wallet.ts
 function assertTronWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Tron; wallet must be { privateKey } (32-byte hex).`
     );
   }
   if ("walletClient" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Tron; a viem { walletClient } can't be used \u2014 pass { privateKey } (32-byte hex).`
     );
   }
   if ("secretKey" in wallet || "signer" in wallet || "mnemonic" in wallet || "keyPair" in wallet || "secret" in wallet || "keypair" in wallet || "seed" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Tron; that looks like a Solana/TON/Stellar/XRPL wallet \u2014 pass { privateKey } (32-byte hex).`
     );
   }
   if (!("privateKey" in wallet)) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Tron; wallet must be { privateKey } (32-byte hex).`
     );
   }
@@ -196,11 +286,11 @@ function assertTronWallet(wallet, network) {
 }
 function resolveTronPrivateKey(config) {
   if (!config.privateKey) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("Tron wallet needs { privateKey } (32-byte hex).");
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("Tron wallet needs { privateKey } (32-byte hex).");
   }
   const hex = config.privateKey.replace(/^0x/i, "").toLowerCase();
   if (!/^[0-9a-f]{64}$/.test(hex)) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       "Tron wallet { privateKey } must be a 32-byte hex string (64 hex chars)."
     );
   }
@@ -227,6 +317,15 @@ function makeTronNetwork(preset, rpcUrl) {
       const info = await tronWeb.trx.getTransactionInfo(txid);
       if (!info || !info.id) return null;
       return info;
+    },
+    // Raw tx (contracts + per-contract ret) for the native-TRX path. getTransaction
+    // throws on an unknown tx, so swallow → null; native verify gates finality on
+    // getTransactionInfo first anyway.
+    async getTransaction(txid) {
+      const tx = await tronWeb.trx.getTransaction(txid).catch(() => null);
+      const raw = tx;
+      if (!raw || !raw.raw_data) return null;
+      return raw;
     }
   };
   return {
@@ -235,29 +334,27 @@ function makeTronNetwork(preset, rpcUrl) {
     supports: (n) => n === network,
     resolveToken(token) {
       if (token === "native") {
-        throw new (0, _chunkWQWNPAYQcjs.UnknownTokenError)(
-          `Tron payments are TRC-20 only \u2014 native TRX isn't a built-in asset. Use 'USDT' or a custom { address, decimals }.`
-        );
+        return { asset: "native", decimals: TRX_DECIMALS, symbol: "TRX" };
       }
       if (typeof token === "string") {
         const info = preset.tokens[token.toUpperCase()];
         if (!info) {
           const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
-          throw new (0, _chunkWQWNPAYQcjs.UnknownTokenError)(
+          throw new (0, _chunkNK64H3RMcjs.UnknownTokenError)(
             `token "${token}" isn't built in for Tron (known: ${known}). Note: native USDC doesn't exist on Tron. Pass { address, decimals } for a custom TRC-20.`
           );
         }
         return { asset: info.address, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkWQWNPAYQcjs.rejectForeignToken.call(void 0, token, "tron", network);
+      _chunkNK64H3RMcjs.rejectForeignToken.call(void 0, token, "tron", network);
       if (!("address" in token)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Tron; a custom token must be { address, decimals } (Base58 T\u2026 contract).`
         );
       }
       const t = token;
       if (t.address.startsWith("0x") || !tronWeb.isAddress(t.address)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Tron, but token address "${t.address}" is not a valid Tron contract (T\u2026).`
         );
       }
@@ -268,7 +365,7 @@ function makeTronNetwork(preset, rpcUrl) {
       };
     },
     describeAsset(asset) {
-      if (asset === "native") return null;
+      if (asset === "native") return { symbol: "TRX", decimals: TRX_DECIMALS };
       for (const info of Object.values(preset.tokens)) {
         if (info.address === asset) return { symbol: info.symbol, decimals: info.decimals };
       }
@@ -276,12 +373,12 @@ function makeTronNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Tron, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       if (!tronWeb.isAddress(payTo)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Tron, but payTo "${payTo}" is not a valid Tron address (T\u2026).`
         );
       }
@@ -293,7 +390,10 @@ function makeTronNetwork(preset, rpcUrl) {
       const privateKey = resolveTronPrivateKey(wallet._native);
       const from = tronWeb.address.fromPrivateKey(privateKey);
       if (!from) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("Tron wallet { privateKey } could not derive an address.");
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("Tron wallet { privateKey } could not derive an address.");
+      }
+      if (accept.asset === "native") {
+        return payTronNative({ client: tronWeb, from, privateKey, accept });
       }
       return payTron({
         client: tronWeb,
@@ -309,16 +409,25 @@ function makeTronNetwork(preset, rpcUrl) {
         try {
           const info = await reader.getTransactionInfo(txid);
           if (info) return { height: String(_nullishCoalesce(info.blockNumber, () => ( 0))) };
-        } catch (e4) {
+        } catch (e7) {
         }
         await _chunkCQREG5LEcjs.delay.call(void 0, 2500);
       }
-      throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(`Tron tx ${txid} did not solidify in time.`);
+      throw new (0, _chunkNK64H3RMcjs.ConfirmationTimeoutError)(`Tron tx ${txid} did not solidify in time.`);
     },
     async estimateCost(accept, opts) {
+      if (accept.asset === "native") {
+        return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
+          symbol: "TRX",
+          decimals: TRX_DECIMALS,
+          fee: 1300000n,
+          basis: "heuristic",
+          detail: "\u22480.27 TRX bandwidth (sender unstaked) + up to ~1 TRX if the recipient account is new"
+        });
+      }
       const ENERGY_PRICE = 420n;
       const BANDWIDTH_SUN = 345000n;
-      if (_optionalChain([opts, 'optionalAccess', _13 => _13.from])) {
+      if (_optionalChain([opts, 'optionalAccess', _24 => _24.from])) {
         try {
           const r = await tronWeb.transactionBuilder.triggerConstantContract(
             accept.asset,
@@ -332,7 +441,7 @@ function makeTronNetwork(preset, rpcUrl) {
           );
           const energy = BigInt(_nullishCoalesce(r.energy_used, () => ( 0)));
           if (energy > 0n) {
-            return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+            return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
               symbol: "TRX",
               decimals: TRX_DECIMALS,
               fee: energy * ENERGY_PRICE + BANDWIDTH_SUN,
@@ -340,10 +449,10 @@ function makeTronNetwork(preset, rpcUrl) {
               detail: `energy ${energy} @ ${ENERGY_PRICE} sun + bandwidth`
             });
           }
-        } catch (e5) {
+        } catch (e8) {
         }
       }
-      return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+      return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
         symbol: "TRX",
         decimals: TRX_DECIMALS,
         fee: 30000n * ENERGY_PRICE + BANDWIDTH_SUN,
@@ -353,6 +462,15 @@ function makeTronNetwork(preset, rpcUrl) {
     },
     async verify(ref, accept) {
       const txid = stripTronPrefix(ref);
+      if (accept.asset === "native") {
+        return verifyTronNative({
+          reader,
+          accept,
+          txid,
+          payToHex41: tronWeb.address.toHex(accept.payTo).toLowerCase(),
+          toBase58: (h) => tronWeb.address.fromHex(h)
+        });
+      }
       return verifyTron({
         reader,
         accept,

package/dist/{xrpl-6NRFT5CA.cjs → xrpl-QECPQCFS.cjs}

@@ -10,7 +10,8 @@ var _chunkCQREG5LEcjs = require('./chunk-CQREG5LE.cjs');
 
 
 
-var _chunkWQWNPAYQcjs = require('./chunk-WQWNPAYQ.cjs');
+
+var _chunkNK64H3RMcjs = require('./chunk-NK64H3RM.cjs');
 
 // src/drivers/xrpl/index.ts
 var _xrpl = require('xrpl');
@@ -91,17 +92,18 @@ async function payXrpl(params) {
     const res = await client.submit(signed.tx_blob);
     const code = res.engine_result;
     if (code.startsWith("tes")) return _nullishCoalesce(_optionalChain([res, 'access', _ => _.tx_json, 'optionalAccess', _2 => _2.hash]), () => ( signed.hash));
+    const recipientMsg = recipientNotReadyMessage(code);
+    if (recipientMsg) throw new (0, _chunkNK64H3RMcjs.RecipientNotReadyError)(recipientMsg, { cause: makeEngineError(res) });
     if (isAffordabilityCode(code)) {
-      throw new (0, _chunkWQWNPAYQcjs.InsufficientFundsError)(
-        `XRPL payment rejected (${code}): insufficient balance/reserve, or no trustline for this asset.`
+      throw new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
+        `XRPL payment rejected: the sender can't cover it \u2014 balance or the 1 XRP base reserve. (XRPL: ${code})`,
+        { cause: makeEngineError(res) }
       );
     }
-    throw new Error(
-      `XRPL payment rejected: ${code}${res.engine_result_message ? ` \u2014 ${res.engine_result_message}` : ""}`
-    );
+    throw makeEngineError(res);
   } catch (err) {
-    if (err instanceof _chunkWQWNPAYQcjs.InsufficientFundsError) throw err;
-    throw _nullishCoalesce(_chunkWQWNPAYQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    if (err instanceof _chunkNK64H3RMcjs.InsufficientFundsError || err instanceof _chunkNK64H3RMcjs.RecipientNotReadyError) throw err;
+    throw _nullishCoalesce(_chunkNK64H3RMcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 function amountForAccept(accept) {
@@ -118,11 +120,25 @@ function feeForSubmit(openLedgerFee) {
   const fee = Number(openLedgerFee);
   return String(Number.isFinite(fee) && fee > 12 ? Math.ceil(fee) : 12);
 }
-function isAffordabilityCode(code) {
-  return /^(tecUNFUNDED|tecPATH_DRY|tecPATH_PARTIAL|tecINSUFF|tecNO_LINE_INSUF|terINSUF|tecNO_LINE)/.test(
-    code
+function makeEngineError(res) {
+  return new Error(
+    `XRPL engine result ${res.engine_result}${res.engine_result_message ? ` \u2014 ${res.engine_result_message}` : ""}`
   );
 }
+function recipientNotReadyMessage(code) {
+  if (/^tecNO_DST/.test(code))
+    return `XRPL destination isn't activated \u2014 an account must hold \u22651 XRP (the base reserve) to exist. Fund the destination with \u22651 XRP before it can receive. (XRPL: ${code})`;
+  if (/^tecNO_LINE/.test(code) || code === "tecPATH_DRY")
+    return `XRPL destination can't receive this currency \u2014 it needs a trustline for it (and the reserve to hold one). (XRPL: ${code})`;
+  if (code === "tecDST_TAG_NEEDED")
+    return `XRPL destination requires a DestinationTag to receive. (XRPL: ${code})`;
+  if (/^(tecNO_AUTH|tecNO_PERMISSION)/.test(code))
+    return `XRPL destination isn't authorized to hold this asset. (XRPL: ${code})`;
+  return null;
+}
+function isAffordabilityCode(code) {
+  return /^(tecUNFUNDED|tecINSUFF|terINSUF)/.test(code);
+}
 
 // src/drivers/xrpl/verify.ts
 var RIPPLE_EPOCH_OFFSET = 946684800;
@@ -212,7 +228,7 @@ function deliveredBaseUnits(delivered, want, decimals) {
     return null;
   }
   try {
-    return _chunkWQWNPAYQcjs.floorUnits.call(void 0, delivered.value, decimals);
+    return _chunkNK64H3RMcjs.floorUnits.call(void 0, delivered.value, decimals);
   } catch (e3) {
     return null;
   }
@@ -236,22 +252,22 @@ function rpcFailed(nonce) {
 
 function assertXrplWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is XRPL; wallet must be { seed } (s\u2026 seed) or { wallet }.`
     );
   }
   if ("privateKey" in wallet || "walletClient" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is XRPL; an EVM wallet can't be used \u2014 pass { seed } (s\u2026 seed) or { wallet }.`
     );
   }
   if ("secretKey" in wallet || "signer" in wallet || "mnemonic" in wallet || "keyPair" in wallet || "secret" in wallet || "keypair" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is XRPL; that looks like a Solana/TON/Stellar wallet \u2014 pass { seed } (s\u2026 seed) or { wallet }.`
     );
   }
   if (!("seed" in wallet) && !("wallet" in wallet)) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is XRPL; wallet must be { seed } (s\u2026 seed) or { wallet }.`
     );
   }
@@ -261,11 +277,11 @@ function resolveXrplWallet(config) {
   if (config.wallet) return config.wallet;
   if (config.seed) {
     if (!_xrpl.isValidSecret.call(void 0, config.seed)) {
-      throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("XRPL wallet { seed } is not a valid s\u2026 secret seed.");
+      throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("XRPL wallet { seed } is not a valid s\u2026 secret seed.");
     }
     return _xrpl.Wallet.fromSeed(config.seed);
   }
-  throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("XRPL wallet needs { seed } (s\u2026 seed) or { wallet }.");
+  throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("XRPL wallet needs { seed } (s\u2026 seed) or { wallet }.");
 }
 
 // src/drivers/xrpl/index.ts
@@ -337,7 +353,7 @@ function makeXrplNetwork(preset, rpcUrl) {
         const info = preset.tokens[token.toUpperCase()];
         if (!info) {
           const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
-          throw new (0, _chunkWQWNPAYQcjs.UnknownTokenError)(
+          throw new (0, _chunkNK64H3RMcjs.UnknownTokenError)(
             `token "${token}" isn't built in for XRPL (known: ${known}). Pass { issuer, currencyHex, decimals } for a custom IOU, or use 'native'.`
           );
         }
@@ -347,10 +363,10 @@ function makeXrplNetwork(preset, rpcUrl) {
           symbol: info.symbol
         };
       }
-      _chunkWQWNPAYQcjs.rejectForeignToken.call(void 0, token, "xrpl", network);
+      _chunkNK64H3RMcjs.rejectForeignToken.call(void 0, token, "xrpl", network);
       const t = token;
       if (!t.issuer || !t.currencyHex || typeof t.decimals !== "number") {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is XRPL; a custom token must be { issuer, currencyHex, decimals }.`
         );
       }
@@ -371,12 +387,12 @@ function makeXrplNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is XRPL, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       if (!_xrpl.isValidClassicAddress.call(void 0, payTo)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is XRPL, but payTo "${payTo}" is not a valid XRPL account (r\u2026).`
         );
       }
@@ -399,14 +415,14 @@ function makeXrplNetwork(preset, rpcUrl) {
         }
         await _chunkCQREG5LEcjs.delay.call(void 0, 1500);
       }
-      throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(`XRPL tx ${ref} not validated on-ledger in time.`);
+      throw new (0, _chunkNK64H3RMcjs.ConfirmationTimeoutError)(`XRPL tx ${ref} not validated on-ledger in time.`);
     },
     async estimateCost() {
       try {
         const drops = await payClient.feeDrops();
         const n = Number(drops);
         const fee = BigInt(Number.isFinite(n) && n > 12 ? Math.ceil(n) : 12);
-        return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+        return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
           symbol: XRP_SYMBOL,
           decimals: XRP_DECIMALS,
           fee,
@@ -414,7 +430,7 @@ function makeXrplNetwork(preset, rpcUrl) {
           detail: `network fee ${fee} drops`
         });
       } catch (e5) {
-        return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+        return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
           symbol: XRP_SYMBOL,
           decimals: XRP_DECIMALS,
           fee: 12n,

package/dist/{xrpl-7GWXDAVZ.js → xrpl-RTT3UOLX.js}

@@ -4,13 +4,14 @@ import {
 import {
   ConfirmationTimeoutError,
   InsufficientFundsError,
+  RecipientNotReadyError,
   UnknownTokenError,
   WrongFamilyError,
   floorUnits,
   nativeCost,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-3TQJJ4SQ.js";
+} from "./chunk-DTIJYDG6.js";
 
 // src/drivers/xrpl/index.ts
 import { isValidClassicAddress } from "xrpl";
@@ -91,16 +92,17 @@ async function payXrpl(params) {
     const res = await client.submit(signed.tx_blob);
     const code = res.engine_result;
     if (code.startsWith("tes")) return res.tx_json?.hash ?? signed.hash;
+    const recipientMsg = recipientNotReadyMessage(code);
+    if (recipientMsg) throw new RecipientNotReadyError(recipientMsg, { cause: makeEngineError(res) });
     if (isAffordabilityCode(code)) {
       throw new InsufficientFundsError(
-        `XRPL payment rejected (${code}): insufficient balance/reserve, or no trustline for this asset.`
+        `XRPL payment rejected: the sender can't cover it \u2014 balance or the 1 XRP base reserve. (XRPL: ${code})`,
+        { cause: makeEngineError(res) }
       );
     }
-    throw new Error(
-      `XRPL payment rejected: ${code}${res.engine_result_message ? ` \u2014 ${res.engine_result_message}` : ""}`
-    );
+    throw makeEngineError(res);
   } catch (err) {
-    if (err instanceof InsufficientFundsError) throw err;
+    if (err instanceof InsufficientFundsError || err instanceof RecipientNotReadyError) throw err;
     throw toInsufficientFundsError(err) ?? err;
   }
 }
@@ -118,11 +120,25 @@ function feeForSubmit(openLedgerFee) {
   const fee = Number(openLedgerFee);
   return String(Number.isFinite(fee) && fee > 12 ? Math.ceil(fee) : 12);
 }
-function isAffordabilityCode(code) {
-  return /^(tecUNFUNDED|tecPATH_DRY|tecPATH_PARTIAL|tecINSUFF|tecNO_LINE_INSUF|terINSUF|tecNO_LINE)/.test(
-    code
+function makeEngineError(res) {
+  return new Error(
+    `XRPL engine result ${res.engine_result}${res.engine_result_message ? ` \u2014 ${res.engine_result_message}` : ""}`
   );
 }
+function recipientNotReadyMessage(code) {
+  if (/^tecNO_DST/.test(code))
+    return `XRPL destination isn't activated \u2014 an account must hold \u22651 XRP (the base reserve) to exist. Fund the destination with \u22651 XRP before it can receive. (XRPL: ${code})`;
+  if (/^tecNO_LINE/.test(code) || code === "tecPATH_DRY")
+    return `XRPL destination can't receive this currency \u2014 it needs a trustline for it (and the reserve to hold one). (XRPL: ${code})`;
+  if (code === "tecDST_TAG_NEEDED")
+    return `XRPL destination requires a DestinationTag to receive. (XRPL: ${code})`;
+  if (/^(tecNO_AUTH|tecNO_PERMISSION)/.test(code))
+    return `XRPL destination isn't authorized to hold this asset. (XRPL: ${code})`;
+  return null;
+}
+function isAffordabilityCode(code) {
+  return /^(tecUNFUNDED|tecINSUFF|terINSUF)/.test(code);
+}
 
 // src/drivers/xrpl/verify.ts
 var RIPPLE_EPOCH_OFFSET = 946684800;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piprail/sdk",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Accept x402 crypto payments across 24 chains — every major EVM chain plus Solana, TON, Tron, NEAR, Sui, Stellar & XRPL — in a couple of lines. No backend, no database, no fee; payments settle straight to your wallet.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -21,6 +21,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHAINS.md",
     "ERRORS.md",
     "STANDARDS.md",
     "CHANGELOG.md",
@@ -70,6 +71,9 @@
   },
   "homepage": "https://piprail.com",
   "bugs": "https://github.com/piprail/piprail/issues",
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "node": ">=20"
   },