@piprail/sdk 1.0.0 → 1.1.0

package/dist/{stellar-BPPQTLNI.cjs → stellar-LIGJKRRK.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/stellar/index.ts
 var _stellarsdk = require('@stellar/stellar-sdk');
@@ -93,19 +94,33 @@ function assetForAccept(accept) {
 }
 function mapSubmitError(err) {
   const codes = extractResultCodes(err);
-  if (codes.some((c) => /underfunded|insufficient|low_reserve|no_trust/i.test(c))) {
-    return new (0, _chunkWQWNPAYQcjs.InsufficientFundsError)(
-      "Stellar payment failed: insufficient balance/reserve, or the sender has no trustline for this asset.",
+  const seen = codes.join(", ");
+  const has = (re) => codes.some((c) => re.test(c));
+  if (has(/op_no_destination/i)) {
+    return new (0, _chunkNK64H3RMcjs.RecipientNotReadyError)(
+      `Stellar destination account doesn't exist yet \u2014 create it with \u22651 XLM (the base reserve) before it can receive. (Stellar: ${seen})`,
+      { cause: err }
+    );
+  }
+  if (has(/op_(no_trust|line_full|not_authorized)/i) && !has(/src_no_trust/i)) {
+    return new (0, _chunkNK64H3RMcjs.RecipientNotReadyError)(
+      `Stellar destination can't hold this asset \u2014 it needs a trustline for it (and to be authorized) before it can receive. (Stellar: ${seen})`,
+      { cause: err }
+    );
+  }
+  if (has(/underfunded|insufficient|low_reserve|src_no_trust/i)) {
+    return new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
+      `Stellar payment failed: the sender can't cover it \u2014 balance, base reserve, or no trustline to send this asset. (Stellar: ${seen})`,
       { cause: err }
     );
   }
   if (isAccountNotFound(err)) {
-    return new (0, _chunkWQWNPAYQcjs.InsufficientFundsError)(
-      "Stellar source account not found on-chain \u2014 fund it (\u2265 base reserve) before it can pay.",
+    return new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
+      "Stellar source account not found on-chain \u2014 fund the sender (\u2265 base reserve) before it can pay.",
       { cause: err }
     );
   }
-  return _nullishCoalesce(_chunkWQWNPAYQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+  return _nullishCoalesce(_chunkNK64H3RMcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
 }
 function isAccountNotFound(err) {
   const e = err;
@@ -202,7 +217,7 @@ function assetMatches(p, want) {
 }
 function parseAmount(amount, decimals) {
   try {
-    return _chunkWQWNPAYQcjs.parseUnits.call(void 0, amount, decimals);
+    return _chunkNK64H3RMcjs.parseUnits.call(void 0, amount, decimals);
   } catch (e4) {
     return 0n;
   }
@@ -226,22 +241,22 @@ function rpcFailed(nonce) {
 
 function assertStellarWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Stellar; wallet must be { secret } (S\u2026 seed) or { keypair }.`
     );
   }
   if ("privateKey" in wallet || "walletClient" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Stellar; an EVM wallet can't be used \u2014 pass { secret } (S\u2026 seed) or { keypair }.`
     );
   }
   if ("secretKey" in wallet || "signer" in wallet || "mnemonic" in wallet || "keyPair" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Stellar; that looks like a Solana/TON wallet \u2014 pass { secret } (S\u2026 seed) or { keypair }.`
     );
   }
   if (!("secret" in wallet) && !("keypair" in wallet)) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Stellar; wallet must be { secret } (S\u2026 seed) or { keypair }.`
     );
   }
@@ -251,13 +266,13 @@ function resolveStellarWallet(config) {
   if (config.keypair) return config.keypair;
   if (config.secret) {
     if (!_stellarsdk.StrKey.isValidEd25519SecretSeed(config.secret)) {
-      throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+      throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
         "Stellar wallet { secret } is not a valid S\u2026 secret seed."
       );
     }
     return _stellarsdk.Keypair.fromSecret(config.secret);
   }
-  throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("Stellar wallet needs { secret } (S\u2026 seed) or { keypair }.");
+  throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("Stellar wallet needs { secret } (S\u2026 seed) or { keypair }.");
 }
 
 // src/drivers/stellar/index.ts
@@ -308,7 +323,7 @@ function makeStellarNetwork(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 Stellar (known: ${known}). Pass { issuer, code, decimals } for a custom asset, or use 'native'.`
           );
         }
@@ -318,10 +333,10 @@ function makeStellarNetwork(preset, rpcUrl) {
           symbol: info.symbol
         };
       }
-      _chunkWQWNPAYQcjs.rejectForeignToken.call(void 0, token, "stellar", network);
+      _chunkNK64H3RMcjs.rejectForeignToken.call(void 0, token, "stellar", network);
       const t = token;
       if (!t.issuer || !t.code || typeof t.decimals !== "number") {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Stellar; a custom token must be { issuer, code, decimals }.`
         );
       }
@@ -342,12 +357,12 @@ function makeStellarNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Stellar, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       if (!_stellarsdk.StrKey.isValidEd25519PublicKey(payTo)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Stellar, but payTo "${payTo}" is not a valid Stellar account (G\u2026).`
         );
       }
@@ -368,10 +383,10 @@ function makeStellarNetwork(preset, rpcUrl) {
           await _chunkCQREG5LEcjs.delay.call(void 0, 1500);
         }
       }
-      throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(`Stellar tx ${ref} not visible on Horizon in time.`);
+      throw new (0, _chunkNK64H3RMcjs.ConfirmationTimeoutError)(`Stellar tx ${ref} not visible on Horizon in time.`);
     },
     async estimateCost() {
-      return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+      return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
         symbol: XLM_SYMBOL,
         decimals: STELLAR_DECIMALS,
         fee: 100n,

package/dist/{sui-XV4YYSGV.cjs → sui-JLVWFDOS.cjs}

@@ -6,7 +6,7 @@
 
 
 
-var _chunkWQWNPAYQcjs = require('./chunk-WQWNPAYQ.cjs');
+var _chunkNK64H3RMcjs = require('./chunk-NK64H3RM.cjs');
 
 // src/drivers/sui/index.ts
 var _jsonRpc = require('@mysten/sui/jsonRpc');
@@ -45,7 +45,7 @@ async function paySui(params) {
     } else {
       const coins = await client.getCoins({ owner: sender, coinType: accept.asset });
       if (!coins.data.length) {
-        throw new (0, _chunkWQWNPAYQcjs.InsufficientFundsError)(
+        throw new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
           `Sui wallet holds no ${accept.asset} coin objects to pay from.`
         );
       }
@@ -64,14 +64,14 @@ async function paySui(params) {
     });
     return res.digest;
   } catch (err) {
-    if (err instanceof _chunkWQWNPAYQcjs.InsufficientFundsError) throw err;
+    if (err instanceof _chunkNK64H3RMcjs.InsufficientFundsError) throw err;
     if (isSuiAffordability(err)) {
-      throw new (0, _chunkWQWNPAYQcjs.InsufficientFundsError)(
+      throw new (0, _chunkNK64H3RMcjs.InsufficientFundsError)(
         err instanceof Error ? err.message : "Insufficient SUI/coin balance for the payment.",
         { cause: err }
       );
     }
-    throw _nullishCoalesce(_chunkWQWNPAYQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    throw _nullishCoalesce(_chunkNK64H3RMcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 function isSuiAffordability(err) {
@@ -151,22 +151,22 @@ function txNotFound(digest) {
 var _ed25519 = require('@mysten/sui/keypairs/ed25519');
 function assertSuiWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Sui; wallet must be { privateKey } (suiprivkey1\u2026 ) or { keypair }.`
     );
   }
   if ("walletClient" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Sui; a viem { walletClient } can't be used \u2014 pass { privateKey } (suiprivkey1\u2026) or { keypair }.`
     );
   }
   if ("secretKey" in wallet || "signer" in wallet || "mnemonic" in wallet || "keyPair" in wallet || "secret" in wallet || "seed" in wallet || "accountId" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Sui; that looks like another family's wallet \u2014 pass { privateKey } (suiprivkey1\u2026) or { keypair }.`
     );
   }
   if (!("privateKey" in wallet) && !("keypair" in wallet)) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is Sui; wallet must be { privateKey } (suiprivkey1\u2026) or { keypair }.`
     );
   }
@@ -178,13 +178,13 @@ function resolveSuiKeypair(config) {
     try {
       return _ed25519.Ed25519Keypair.fromSecretKey(config.privateKey);
     } catch (cause) {
-      throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+      throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
         "Sui wallet { privateKey } is not a valid suiprivkey1\u2026 secret (or 32-byte key).",
         { cause }
       );
     }
   }
-  throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("Sui wallet needs { privateKey } (suiprivkey1\u2026) or { keypair }.");
+  throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("Sui wallet needs { privateKey } (suiprivkey1\u2026) or { keypair }.");
 }
 
 // src/drivers/sui/index.ts
@@ -236,16 +236,16 @@ function makeSuiNetwork(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 Sui (known: ${known}). Note: no native USDT on Sui. Pass { coinType, decimals } for a custom coin, or use 'native'.`
           );
         }
         return { asset: info.coinType, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkWQWNPAYQcjs.rejectForeignToken.call(void 0, token, "sui", network);
+      _chunkNK64H3RMcjs.rejectForeignToken.call(void 0, token, "sui", network);
       const t = token;
       if (!t.coinType || typeof t.decimals !== "number") {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Sui; a custom token must be { coinType, decimals }.`
         );
       }
@@ -264,7 +264,7 @@ function makeSuiNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (!_utils.isValidSuiAddress.call(void 0, payTo)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is Sui, but payTo "${payTo}" is not a valid Sui address (0x + 32 bytes).`
         );
       }
@@ -281,11 +281,11 @@ function makeSuiNetwork(preset, rpcUrl) {
         const tx = await client.waitForTransaction({ digest: ref, options: { showEffects: true } });
         return { height: String(_nullishCoalesce(tx.checkpoint, () => ( "0"))) };
       } catch (err) {
-        throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(`Sui tx ${ref} did not finalize in time.`, { cause: err });
+        throw new (0, _chunkNK64H3RMcjs.ConfirmationTimeoutError)(`Sui tx ${ref} did not finalize in time.`, { cause: err });
       }
     },
     async estimateCost() {
-      return _chunkWQWNPAYQcjs.nativeCost.call(void 0, {
+      return _chunkNK64H3RMcjs.nativeCost.call(void 0, {
         symbol: SUI_SYMBOL,
         decimals: SUI_DECIMALS,
         fee: 3000000n,

package/dist/{sui-6N4ZPAGD.js → sui-UBDATSQV.js}

@@ -6,7 +6,7 @@ import {
   nativeCost,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-3TQJJ4SQ.js";
+} from "./chunk-DTIJYDG6.js";
 
 // src/drivers/sui/index.ts
 import { SuiJsonRpcClient } from "@mysten/sui/jsonRpc";

package/dist/{ton-EFZKQAAK.js → ton-2N74GKNB.js}

@@ -8,7 +8,7 @@ import {
   nativeCost,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-3TQJJ4SQ.js";
+} from "./chunk-DTIJYDG6.js";
 
 // src/drivers/ton/index.ts
 import { Address as Address2 } from "@ton/core";
@@ -99,7 +99,7 @@ async function verifyTon(params) {
   for (const tx of txs) {
     const incoming = extractIncoming(tx);
     if (!incoming || incoming.comment !== nonce) continue;
-    if (!txSucceeded(tx)) {
+    if (accept.asset !== "native" && !txSucceeded(tx)) {
       return { ok: false, error: "tx_reverted", detail: `TON payment for nonce ${nonce} failed on-chain.` };
     }
     if (incoming.amount < required) {

package/dist/{ton-E5RLUPD2.cjs → ton-OVSQZ4OM.cjs}

@@ -8,7 +8,7 @@ var _chunkCQREG5LEcjs = require('./chunk-CQREG5LE.cjs');
 
 
 
-var _chunkWQWNPAYQcjs = require('./chunk-WQWNPAYQ.cjs');
+var _chunkNK64H3RMcjs = require('./chunk-NK64H3RM.cjs');
 
 // src/drivers/ton/index.ts
 var _core = require('@ton/core');
@@ -74,7 +74,7 @@ async function waitForSeqno(opened, from, { tries = 30, intervalMs = 2e3 } = {})
     }
     if (current > from) return;
   }
-  throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(
+  throw new (0, _chunkNK64H3RMcjs.ConfirmationTimeoutError)(
     `TON wallet seqno did not advance past ${from} \u2014 the payment may not have been accepted.`
   );
 }
@@ -99,7 +99,7 @@ async function verifyTon(params) {
   for (const tx of txs) {
     const incoming = extractIncoming(tx);
     if (!incoming || incoming.comment !== nonce) continue;
-    if (!txSucceeded(tx)) {
+    if (accept.asset !== "native" && !txSucceeded(tx)) {
       return { ok: false, error: "tx_reverted", detail: `TON payment for nonce ${nonce} failed on-chain.` };
     }
     if (incoming.amount < required) {
@@ -202,17 +202,17 @@ var _crypto = require('@ton/crypto');
 
 function assertTonWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is TON; wallet must be { mnemonic } (24 words) or { keyPair }.`
     );
   }
   if ("privateKey" in wallet || "walletClient" in wallet) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is TON; an EVM wallet can't be used \u2014 pass { mnemonic } (24 words) or { keyPair }.`
     );
   }
   if (!("mnemonic" in wallet) && !("keyPair" in wallet)) {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
       `chain ${network} is TON; wallet must be { mnemonic } (24 words) or { keyPair }.`
     );
   }
@@ -227,7 +227,7 @@ async function resolveTonWallet(config) {
   } else if (config.keyPair) {
     keyPair = config.keyPair;
   } else {
-    throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)("TON wallet needs { mnemonic } (24 words) or { keyPair }.");
+    throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)("TON wallet needs { mnemonic } (24 words) or { keyPair }.");
   }
   const contract = version === "v5r1" ? _ton.WalletContractV5R1.create({ workchain: 0, publicKey: keyPair.publicKey }) : _ton.WalletContractV4.create({ workchain: 0, publicKey: keyPair.publicKey });
   return { keyPair, contract };
@@ -270,15 +270,15 @@ function makeTonNetwork(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 TON (known: ${known}). Note: native USDC doesn't exist on TON. Pass { master, decimals } for a custom jetton, or use 'native'.`
           );
         }
         return { asset: info.master, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkWQWNPAYQcjs.rejectForeignToken.call(void 0, token, "ton", network);
+      _chunkNK64H3RMcjs.rejectForeignToken.call(void 0, token, "ton", network);
       if (!("master" in token)) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is TON; a custom token must be { master, decimals }.`
         );
       }
@@ -297,14 +297,14 @@ function makeTonNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is TON, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       try {
         _core.Address.parse(payTo);
       } catch (e6) {
-        throw new (0, _chunkWQWNPAYQcjs.WrongFamilyError)(
+        throw new (0, _chunkNK64H3RMcjs.WrongFamilyError)(
           `chain ${network} is TON, but payTo "${payTo}" is not a valid TON address.`
         );
       }
@@ -320,7 +320,7 @@ function makeTonNetwork(preset, rpcUrl) {
         const watch = await watchAccountFor(accept);
         return encodeRef(watch, accept.extra.nonce);
       } catch (err) {
-        throw _nullishCoalesce(_chunkWQWNPAYQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+        throw _nullishCoalesce(_chunkNK64H3RMcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
       }
     },
     async confirm(ref) {
@@ -339,12 +339,12 @@ function makeTonNetwork(preset, rpcUrl) {
           if (inc && inc.comment === nonce) return { height: tx.lt.toString() };
         }
       }
-      throw new (0, _chunkWQWNPAYQcjs.ConfirmationTimeoutError)(`TON payment for nonce ${nonce} did not settle in time.`);
+      throw new (0, _chunkNK64H3RMcjs.ConfirmationTimeoutError)(`TON payment for nonce ${nonce} did not settle in time.`);
     },
     async estimateCost(accept) {
       const fee = accept.asset === "native" ? 10000000n : 50000000n;
       const detail = accept.asset === "native" ? "~0.01 TON network fee" : "~0.05 TON attached for the jetton transfer (leftover refunded)";
-      return _chunkWQWNPAYQcjs.nativeCost.call(void 0, { symbol: "TON", decimals: TON_DECIMALS, fee, basis: "heuristic", detail });
+      return _chunkNK64H3RMcjs.nativeCost.call(void 0, { symbol: "TON", decimals: TON_DECIMALS, fee, basis: "heuristic", detail });
     },
     async verify(_ref, accept) {
       const watch = await watchAccountFor(accept);

package/dist/{tron-243DT6PF.js → tron-N3EAAKU7.js}

@@ -9,7 +9,7 @@ import {
   nativeCost,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-3TQJJ4SQ.js";
+} from "./chunk-DTIJYDG6.js";
 
 // src/drivers/tron/index.ts
 import { TronWeb } from "tronweb";
@@ -73,6 +73,28 @@ async function payTron(params) {
     throw toInsufficientFundsError(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 || broadcast.transaction?.txID) {
+      return broadcast.txid ?? broadcast.transaction?.txID ?? signed.txID;
+    }
+    if (isTronAffordability(broadcast.code, broadcast.message)) {
+      throw new InsufficientFundsError(
+        `Tron TRX payment rejected (${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: ${broadcast.code ?? ""} ${decodeMaybeHex(broadcast.message)}`.trim()
+    );
+  } catch (err) {
+    if (err instanceof InsufficientFundsError) throw err;
+    throw toInsufficientFundsError(err) ?? err;
+  }
+}
 function decodeMaybeHex(message) {
   if (!message) return "";
   if (/^[0-9a-fA-F]+$/.test(message) && message.length % 2 === 0) {
@@ -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 {
+    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 {
+    return txNotFound(txid);
+  }
+  if (!tx) return txNotFound(txid);
+  const ret = tx.ret?.[0]?.contractRet;
+  if (ret && ret !== "SUCCESS") {
+    return { ok: false, error: "tx_reverted", detail: `Tron tx ${txid} did not succeed (contractRet=${ret}).` };
+  }
+  const contract = (tx.raw_data?.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 = contract.parameter?.value ?? {};
+  const to = String(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(value.amount ?? 0);
+    } catch {
+      return 0n;
+    }
+  })();
+  if (amount < required) {
+    return { ok: false, error: "amount_too_low", detail: `Sent ${amount} sun, required ${required}.` };
+  }
+  const from = String(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;
@@ -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,9 +334,7 @@ function makeTronNetwork(preset, rpcUrl) {
     supports: (n) => n === network,
     resolveToken(token) {
       if (token === "native") {
-        throw new 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()];
@@ -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 };
       }
@@ -295,6 +392,9 @@ function makeTronNetwork(preset, rpcUrl) {
       if (!from) {
         throw new WrongFamilyError("Tron wallet { privateKey } could not derive an address.");
       }
+      if (accept.asset === "native") {
+        return payTronNative({ client: tronWeb, from, privateKey, accept });
+      }
       return payTron({
         client: tronWeb,
         from,
@@ -316,6 +416,15 @@ function makeTronNetwork(preset, rpcUrl) {
       throw new ConfirmationTimeoutError(`Tron tx ${txid} did not solidify in time.`);
     },
     async estimateCost(accept, opts) {
+      if (accept.asset === "native") {
+        return nativeCost({
+          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 (opts?.from) {
@@ -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,