crypto-aio 0.1.0 → 0.2.0

package/dist/adapters/ton/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/adapters/ton/trace.ts"],"names":[],"mappings":";;;AAyGA,sCAQC;AAOD,oCAIC;AAgLD,wCAkBC;AA9TD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,mDAAwD;AAExD,qCAAiD;AACjD,yCAQoB;AACpB,uCAA2C;AAkB3C,qFAAqF;AACxE,QAAA,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,YAAY,EAAE,+BAA+B;IAC7C,OAAO,EAAE,8BAA8B;IACvC,OAAO,EAAE,kBAAkB;IAC3B,aAAa,EAAE,yBAAyB;IACxC,gBAAgB,EAAE,yCAAyC;CAC5D,CAAC,CAAC;AAEH,MAAM,OAAO,GAAY,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAC5D,MAAM,MAAM,GAAG,CAAC,MAAc,EAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtF,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,EAAE,CACtC,IAAI,qBAAa,CAAC,uBAAuB,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC,2FAA2F;AAC3F,SAAS,UAAU,CAAC,EAAiB;IACnC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,CACL,IAAI,KAAK,IAAI;QACb,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE;QACtB,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,aAAE,CAAC,gBAAgB,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,EAAiB;IAC7C,IAAI,IAAA,YAAG,EAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,CACL,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO;QACnB,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO;QACnB,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,uBAAuB;QAC/C,UAAU,CAAC,EAAE,CAAC,CACf,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,EAAiB,EAAE,IAAY,EAAE,KAAa;IACzE,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/E,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAA,wBAAc,EAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,KAAc,EAAE,OAAkB,EAAE,MAAc;IAClE,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,MAAM,YAAY,CAAC,4CAA4C,CAAC,CAAC;IAC1E,IACE,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,OAAO,CAAC,MAAM,KAAK,MAAM;QACzB,EAAE,CAAC,OAAO,KAAK,OAAO,CAAC,WAAW;QAClC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;QAC3B,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QAChC,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI;YACtB,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI;YACxB,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACrC,CAAC;QACD,MAAM,YAAY,CAAC,uDAAuD,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAUD,yFAAyF;AACzF,SAAS,aAAa,CAAC,KAAmD;IACxE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/D,OAAO,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,IAAA,wBAAa,EAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,IAAmB;IACvC,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,IAAI,CAAC,KAAkB,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI;QAAE,MAAM,YAAY,CAAC,kDAAkD,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAA,8BAAmB,EAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5C,MAAM,YAAY,CAAC,uDAAuD,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAA8C,CAAC;IACnE,+EAA+E;IAC/E,IAAI,IAAA,yBAAgB,EAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,WAAW,KAAK,CAAC,IAAI,MAAM,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,YAAY,CAAC,sDAAsD,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAA,uBAAY,EAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YACR,MAAM,YAAY,CAAC,yDAAyD,CAAC,CAAC;QAChF,uFAAuF;QACvF,oFAAoF;QACpF,MAAM,MAAM,GAAG,IAAA,+BAAoB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,YAAY,CAAC,6DAA6D,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAC5B,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,EAAE;YAC5B,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;YACzB,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAClC,CAAC;QACF,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAc,CAAC;QACpD,uDAAuD;QACvD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/E,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,YAAY,CAAC,yDAAyD,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,GAAG;YACH,UAAU;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,YAAY,CAChB,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,qFAAqF;IACrF,oFAAoF;IACpF,sEAAsE;IACtE,IAAI,OAAO,KAAK,MAAM,CAAC,cAAc,EAAE,CAAC;QACtC,MAAM,YAAY,CAAC,iEAAiE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,GAAkB,EAAE,IAAY;IAC9C,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,uCAA4B,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI;YAAE,SAAS;QAClD,oFAAoF;QACpF,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;QACnC,YAAY,GAAG,IAAI,CAAC,CAAC,wDAAwD;IAC/E,CAAC;IACD,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,YAAY,CAAC,kEAAkE,CAAC,CAAC;AACzF,CAAC;AAQD,wFAAwF;AACxF,SAAS,SAAS,CAAC,KAAc,EAAE,IAAY,EAAE,IAAU;IACzD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAA,YAAG,EAAC,GAAG,CAAC,CAAC;IACxB,mFAAmF;IACnF,uFAAuF;IACvF,mFAAmF;IACnF,wFAAwF;IACxF,8CAA8C;IAC9C,IACE,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;QAChE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC;QACzC,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,EAChE,CAAC;QACD,MAAM,YAAY,CAAC,oDAAoD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,wDAAwD;QACxD,OAAO,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACjF,CAAC;IACD,mFAAmF;IACnF,0DAA0D;IAC1D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,eAAO,CAAC,aAAa,EAAE,CAAC;IACtD,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,MAAM,EAAE,eAAO,CAAC,aAAa,EAAE,CAAC;IAC9D,kFAAkF;IAClF,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7D,4EAA4E;IAC5E,IAAI,CAAC,IAAA,YAAG,EAAC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,eAAO,CAAC,aAAa,EAAE,CAAC;IAC5D,OAAO;QACL,GAAG,EAAE;YACH,YAAY,EAAE,GAAG,CAAC,OAAO;YACzB,eAAe,EAAE,OAAO,CAAC,OAAO;YAChC,SAAS,EAAE,eAAe;SAC3B;KACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,SAAgB,cAAc,CAAC,IAAmB,EAAE,KAAqB;IACvE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,YAAY,CAAC,wCAAwC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,eAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,eAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,eAAO,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC9C,sFAAsF;IACtF,iBAAiB;IACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,IAAI,OAAO;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC","sourcesContent":["/**\n * The verdict on one of our own Attempts: did the value move? A TON wallet transaction\n * \"succeeds\" even when it moved nothing (send mode +2 skips a message it cannot pay), and\n * a transfer can still bounce, or a jetton move fail, one or two hops later. So an\n * Attempt succeeded only when:\n * - the wallet transaction consumed the request's seqno and ran it to the end;\n * - every message of the signed request is among its outgoing messages (a missing one is a\n *   skip only when the wallet's action phase itself counts that many skipped actions);\n * - no native message came back bounced (a `nofunds` or `negfunds` bounce, a failed action\n *   phase without send mode +16 and a non-bounceable message all leave the value with the\n *   recipient), each delivery's bounce phase agreeing with the flag we signed;\n * - every jetton request reached a jetton wallet as an `internal_transfer` of a positive\n *   amount from our wallet, sent by our jetton wallet and run to the end by the receiving\n *   one (the exact amount is not required: fee-on-transfer tokens exist), and both jetton\n *   wallets are the master's own for the sender and the intended recipient. That last\n *   check needs chain reads, so the verdict returns the `legs` for the caller to confirm\n *   (`confirmLegs` in `reader.ts`); the receiving wallet's own 707 check then holds.\n * Only a request that consumed its seqno is final: any other run (a failed action phase,\n * or a compute phase that failed before `commit()`) left the same message valid until it\n * expires, so anyone may replay it and move the value; such a run decides nothing\n * (`pending`), and only the seqno or the proven expiry can.\n * Used on the verdict paths only (`observe`, `includedFinal`). Every body read here is\n * bound to the hash the quorum keyed (`messageBody`). A batch is one Attempt: one bounced\n * output fails it, although the other outputs moved. Only the chain's own record of a\n * failure decides `failed`; an answer that contradicts the chain or the signed request (a\n * message missing that the wallet did not skip, a jetton wallet that ran the transfer yet\n * sent nothing from the sender, phases that contradict each other or the chain's own\n * counters) throws a retryable `PROVIDER_INCONSISTENT`, which decides nothing. Every\n * output is checked before any of them decides.\n */\nimport { ProviderError } from '../../core/errors/error';\nimport type { V3Message, V3Trace, V3Transaction } from './api';\nimport { ran, threwAfterCommit } from './decode';\nimport {\n  OP,\n  decodeComment,\n  decodeJettonInternalTransfer,\n  decodeJettonTransfer,\n  decodeWalletRequest,\n  messageBody,\n  messageFacts,\n} from './messages';\nimport { externalHashOf } from './wallets';\n\n/** One jetton transfer: the jetton wallets whose owners must be `from` and `recipient`. */\nexport interface JettonLeg {\n  readonly senderWallet: string;\n  readonly recipientWallet: string;\n  readonly recipient: string;\n}\n\nexport type Verdict =\n  | { readonly kind: 'success'; readonly legs: readonly JettonLeg[] }\n  | { readonly kind: 'failed'; readonly reason: string }\n  /**\n   * Not decidable yet: the trace is still being executed or indexed, or the request ran\n   * without consuming its seqno and may still run again until it expires.\n   */\n  | { readonly kind: 'pending' };\n\n/** Fixed reasons: a stored reason never holds an address, an amount or node text. */\nexport const REASONS = Object.freeze({\n  walletFailed: 'the wallet transaction failed',\n  skipped: 'the wallet skipped a message',\n  bounced: 'transfer bounced',\n  jettonBounced: 'jetton transfer bounced',\n  jettonUnverified: 'the jetton wallets are not the master’s',\n});\n\nconst PENDING: Verdict = Object.freeze({ kind: 'pending' });\nconst failed = (reason: string): Verdict => Object.freeze({ kind: 'failed', reason });\n\nconst inconsistent = (reason: string) =>\n  new ProviderError('PROVIDER_INCONSISTENT', reason, { retryable: true });\n\n/**\n * wallet_v5.fc: an external request whose send mode lacks +2, refused after `commit()`\n * stored the next seqno with an empty action list. The chain counts that compute phase a\n * success (transaction.cpp: `success = accepted && committed`) and runs the empty list, so\n * the transaction ran; the scripted node records it that way too. An indexer that wrote it\n * as a failed compute phase is still read as W5's refusal.\n */\nconst W5_REFUSED_AFTER_COMMIT = 137;\n\n/** Whether `tx` ran a W5 signed external request (only W5 throws 137 after committing). */\nfunction w5External(tx: V3Transaction): boolean {\n  if (!tx.inMsg || tx.inMsg.source !== null) return false;\n  const body = messageBody(tx.inMsg);\n  return (\n    body !== null &&\n    body.bits.length >= 32 &&\n    body.beginParse().preloadUint(32) === OP.w5SignedExternal\n  );\n}\n\n/**\n * Whether the wallet transaction of an external request `tx` consumed the request's seqno,\n * so that the same message can never run again: it ran (the new seqno stands with the\n * actions, W5's 137 included), or, as a defensive reading of W5 alone, its compute phase is\n * recorded failed with 137. Any other run left the old seqno (transaction.cpp: a\n * failed action phase drops the compute phase's state, and a compute phase that failed\n * before `commit()` never had one): a foreign request signed with the same key, or our\n * own, whose action phase failed does not consume the seqno. Throws the retryable\n * contradiction of `ran`.\n */\nexport function consumesSeqno(tx: V3Transaction): boolean {\n  if (ran(tx)) return true;\n  return (\n    !tx.compute.success &&\n    !tx.compute.skipped &&\n    tx.compute.exitCode === W5_REFUSED_AFTER_COMMIT &&\n    w5External(tx)\n  );\n}\n\n/**\n * Whether `tx` is our Attempt: the external message to `from` whose TEP-467 hash,\n * computed here from the bound body, is the Attempt id. The indexer's `hash_norm` only\n * finds candidates; it never decides.\n */\nexport function isOwnAttempt(tx: V3Transaction, from: string, refId: string): boolean {\n  if (!tx.inMsg || tx.inMsg.source !== null || tx.account !== from) return false;\n  const body = messageBody(tx.inMsg);\n  return body !== null && externalHashOf(tx.account, body) === refId;\n}\n\n/**\n * The transaction in `trace` that received `message`, which `sender` sent. An internal\n * message is delivered once, to its destination, with its value and its bounce flag:\n * anything else contradicts the chain.\n */\nfunction receiver(trace: V3Trace, message: V3Message, sender: string): V3Transaction {\n  const found = trace.transactions.filter((t) => t.inMsg?.hash === message.hash);\n  const [tx] = found;\n  if (!tx) throw inconsistent('a complete trace lacks a delivered message');\n  if (\n    found.length > 1 ||\n    message.source !== sender ||\n    tx.account !== message.destination ||\n    tx.inMsg?.source !== sender ||\n    tx.inMsg.value !== message.value ||\n    (message.bounce !== null &&\n      tx.inMsg.bounce !== null &&\n      tx.inMsg.bounce !== message.bounce)\n  ) {\n    throw inconsistent('the trace delivered a message other than the one sent');\n  }\n  return tx;\n}\n\ninterface Sent {\n  readonly out: V3Message;\n  /** The bounce flag we signed for it: it decides whether a bounce phase may exist. */\n  readonly bounceable: boolean;\n  /** For a jetton request: its intended recipient (the owner). */\n  readonly jettonRecipient?: string;\n}\n\n/** A native transfer as our builder signs it: a positive value, no body or a comment. */\nfunction plainTransfer(facts: NonNullable<ReturnType<typeof messageFacts>>): boolean {\n  const { value, body } = facts;\n  const empty = body.bits.length === 0 && body.refs.length === 0;\n  return value > 0n && (empty || decodeComment(body) !== undefined);\n}\n\n/**\n * The requested messages, matched one to one with the wallet transaction's outgoing\n * messages; or why they did not all go out: the wallet skipped them (send mode +2), or its\n * code threw after committing the seqno. `ran` holds, so the outgoing messages are\n * distinct and as many as the action phase created; the skips must be exactly the missing\n * messages.\n */\nfunction sentMessages(root: V3Transaction): readonly Sent[] | 'skipped' | 'threw' {\n  const body = messageBody(root.inMsg as V3Message);\n  if (!body) throw inconsistent('the indexer has no body for the external message');\n  const request = decodeWalletRequest(body);\n  if (!request || request.auth !== 'external') {\n    throw inconsistent('the indexed external message is not a wallet transfer');\n  }\n  const action = root.action as NonNullable<V3Transaction['action']>;\n  // Committed, then threw (W5 137): the list committed with the seqno was empty.\n  if (threwAfterCommit(root)) {\n    if (action.msgsCreated !== 0 || action.skippedActions !== 0) {\n      throw inconsistent('the wallet threw after committing, yet ran an action');\n    }\n    return 'threw';\n  }\n  const unused = [...root.outMsgs];\n  const matched: Sent[] = [];\n  let missing = 0;\n  for (const requested of request.messages) {\n    const facts = messageFacts(requested);\n    if (!facts)\n      throw inconsistent('the signed request holds a message that is not internal');\n    // Our builder signs only plain transfers of a positive value and TEP-74 transfers; any\n    // other message moves what the verdict cannot see, so it is never judged a success.\n    const jetton = decodeJettonTransfer(facts.body);\n    if (!jetton && !plainTransfer(facts)) {\n      throw inconsistent('the signed request holds a message the verdict cannot judge');\n    }\n    const index = unused.findIndex(\n      (out) =>\n        out.destination === facts.to &&\n        out.value === facts.value &&\n        out.bodyHash === facts.bodyHash,\n    );\n    if (index < 0) {\n      missing += 1;\n      continue;\n    }\n    const out = unused.splice(index, 1)[0] as V3Message;\n    // A message leaves the wallet with the flag we signed.\n    const bounceable = requested.info.type === 'internal' && requested.info.bounce;\n    if (out.bounce !== null && out.bounce !== bounceable) {\n      throw inconsistent('a message went out with another bounce flag than signed');\n    }\n    matched.push({\n      out,\n      bounceable,\n      ...(jetton ? { jettonRecipient: jetton.destination } : {}),\n    });\n  }\n  if (unused.length > 0) {\n    throw inconsistent(\n      'the wallet transaction sent a message the request did not ask for',\n    );\n  }\n  // Send mode +2: the wallet records exactly the messages it skipped. The action phase\n  // counts skipped sends since global version 8 (config param 8), which both networks\n  // run; on an older chain this refuses (retryable), and never decides.\n  if (missing !== action.skippedActions) {\n    throw inconsistent('the wallet counts other skips than the messages it did not send');\n  }\n  return missing > 0 ? 'skipped' : matched;\n}\n\n/**\n * The `internal_transfer` our jetton wallet `hop` sent onwards for our wallet `from`: the\n * message of a positive amount, `null` when it moved nothing.\n */\nfunction onward(hop: V3Transaction, from: string): V3Message | null {\n  let nothingMoved = false;\n  for (const m of hop.outMsgs) {\n    const body = messageBody(m);\n    const internal = body ? decodeJettonInternalTransfer(body) : null;\n    if (!internal || internal.from !== from) continue;\n    // From the sender, a positive amount, never the exact one (fee-on-transfer tokens).\n    if (internal.amount > 0n) return m;\n    nothingMoved = true; // a zero amount: nothing moved, so `failed` is accurate\n  }\n  if (nothingMoved) return null;\n  throw inconsistent('the jetton wallet ran the transfer but sent none from the sender');\n}\n\n/** What one output did: failed (with why), a jetton leg to confirm, or delivered. */\ntype Outcome =\n  | { readonly failed: string }\n  | { readonly leg: JettonLeg }\n  | { readonly delivered: true };\n\n/** The outcome of the output `sent` of our wallet `from`, checked against the chain. */\nfunction outcomeOf(trace: V3Trace, from: string, sent: Sent): Outcome {\n  const { out, bounceable, jettonRecipient } = sent;\n  const hop = receiver(trace, out, from);\n  const hopRan = ran(hop);\n  // A bounce phase exists only for a bounceable message, and always when its compute\n  // phase failed (collator.cpp, transaction.cpp `bounce_enabled`). A bounce on a message\n  // we signed non-bounceable would fail a delivery that credited the value; a failed\n  // bounceable delivery without one lacks data. The flag we signed decides, even when the\n  // indexer leaves the delivery's own flag out.\n  if (\n    (hop.inMsg?.bounce !== null && hop.inMsg?.bounce !== bounceable) ||\n    (hop.bounce !== undefined && !bounceable) ||\n    (bounceable && !hop.compute.success && hop.bounce === undefined)\n  ) {\n    throw inconsistent('the delivery contradicts the bounce flag we signed');\n  }\n  if (jettonRecipient === undefined) {\n    // The value stays unless the bounce phase sent it back.\n    return hop.bounce === 'ok' ? { failed: REASONS.bounced } : { delivered: true };\n  }\n  // The owner's jetton wallet ran `transfer` and sent `internal_transfer` onwards. A\n  // failed phase dropped its state: the jettons never left.\n  if (!hopRan) return { failed: REASONS.jettonBounced };\n  const arrivalMessage = onward(hop, from);\n  if (!arrivalMessage) return { failed: REASONS.jettonBounced };\n  // TEP-74 707: the receiving wallet takes it only from the sender's jetton wallet.\n  const arrival = receiver(trace, arrivalMessage, hop.account);\n  // A failed phase drops the credit: the jettons came back, or never arrived.\n  if (!ran(arrival)) return { failed: REASONS.jettonBounced };\n  return {\n    leg: {\n      senderWallet: hop.account,\n      recipientWallet: arrival.account,\n      recipient: jettonRecipient,\n    },\n  };\n}\n\n/** The verdict on the Attempt whose wallet transaction is `root`, within `trace`. */\nexport function attemptVerdict(root: V3Transaction, trace: V3Trace | null): Verdict {\n  if (!root.inMsg || root.inMsg.source !== null) {\n    throw inconsistent('the attempt is not an external message');\n  }\n  if (!consumesSeqno(root)) return PENDING;\n  if (!root.compute.success) return failed(REASONS.walletFailed);\n  const sent = sentMessages(root);\n  if (sent === 'threw') return failed(REASONS.walletFailed);\n  if (sent === 'skipped') return failed(REASONS.skipped);\n  if (!trace || !trace.complete) return PENDING;\n  // Every output is checked before any decides, so an early failure never hides a later\n  // contradiction.\n  const outcomes = sent.map((each) => outcomeOf(trace, root.account, each));\n  for (const outcome of outcomes) {\n    if ('failed' in outcome) return failed(outcome.failed);\n  }\n  const legs = outcomes.flatMap((outcome) => ('leg' in outcome ? [outcome.leg] : []));\n  return Object.freeze({ kind: 'success', legs });\n}\n"]}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/adapters/ton/trace.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The verdict on one of our own Attempts: did the value move? A TON wallet transaction\n * \"succeeds\" even when it moved nothing (send mode +2 skips a message it cannot pay), and\n * a transfer can still bounce, or a jetton move fail, one or two hops later. So an\n * Attempt succeeded only when:\n * - the wallet transaction consumed the request's seqno and ran it to the end;\n * - every message of the signed request is among its outgoing messages (a missing one is a\n *   skip only when the wallet's action phase itself counts that many skipped actions);\n * - no native message came back bounced (a `nofunds` or `negfunds` bounce, a failed action\n *   phase without send mode +16 and a non-bounceable message all leave the value with the\n *   recipient), each delivery's bounce phase agreeing with the flag we signed;\n * - every jetton request reached a jetton wallet as an `internal_transfer` of a positive\n *   amount from our wallet, sent by our jetton wallet and run to the end by the receiving\n *   one (the exact amount is not required: fee-on-transfer tokens exist), and both jetton\n *   wallets are the master's own for the sender and the intended recipient. That last\n *   check needs chain reads, so the verdict returns the `legs` for the caller to confirm\n *   (`confirmLegs` in `reader.ts`); the receiving wallet's own 707 check then holds.\n * A bounce read here is still only the indexer's word, and a lone lying indexer could\n * report one for a transfer that landed: so a bounce verdict returns where the chain\n * records it (`bounce`), for the caller to authenticate from the chain itself\n * (`confirmBounce` in `reader.ts`) before it decides anything.\n * Only a request that consumed its seqno is final: any other run (a failed action phase,\n * or a compute phase that failed before `commit()`) left the same message valid until it\n * expires, so anyone may replay it and move the value; such a run decides nothing\n * (`pending`), and only the seqno or the proven expiry can.\n * Used on the verdict paths only (`observe`, `includedFinal`). Every body read here is\n * bound to the hash the quorum keyed (`messageBody`). A batch is one Attempt: one bounced\n * output fails it, although the other outputs moved. Only the chain's own record of a\n * failure decides `failed`; an answer that contradicts the chain or the signed request (a\n * message missing that the wallet did not skip, a jetton wallet that ran the transfer yet\n * sent nothing from the sender, phases that contradict each other or the chain's own\n * counters) throws a retryable `PROVIDER_INCONSISTENT`, which decides nothing. Every\n * output is checked before any of them decides.\n */\nimport { ProviderError } from '../../core/errors/error';\nimport type { TxFailure } from '../../core/model/transaction';\nimport type { V3Message, V3Trace, V3Transaction } from './api';\nimport { ran, threwAfterCommit } from './decode';\nimport {\n  OP,\n  decodeComment,\n  decodeJettonInternalTransfer,\n  decodeJettonTransfer,\n  decodeWalletRequest,\n  messageBody,\n  messageFacts,\n} from './messages';\nimport { externalHashOf } from './wallets';\n\n/** One jetton transfer: the jetton wallets whose owners must be `from` and `recipient`. */\nexport interface JettonLeg {\n  readonly senderWallet: string;\n  readonly recipientWallet: string;\n  readonly recipient: string;\n}\n\n/** A transaction as the chain names it: its account (raw), logical time and hash (hex). */\nexport interface ChainTxId {\n  readonly account: string;\n  readonly lt: bigint;\n  readonly hash: string;\n}\n\n/** A delivery on a bounce's path: its transaction and the hash of the message it received. */\nexport interface Delivery extends ChainTxId {\n  readonly message: string;\n}\n\n/**\n * Where the chain records a bounce, as the indexer names it: our wallet transaction\n * (`root`), each delivery from its message on to the one that failed (`path`), and what\n * that last one did (`end`): sent the value back (its bounce phase), ran nothing, or ran\n * and moved no jettons. Names only: `confirmBounce` reads each from the chain.\n */\nexport interface BounceEvidence {\n  readonly root: ChainTxId;\n  readonly path: readonly Delivery[];\n  readonly end: 'bounced' | 'unran' | 'unmoved';\n}\n\nexport type Verdict =\n  | { readonly kind: 'success'; readonly legs: readonly JettonLeg[] }\n  | {\n      readonly kind: 'failed';\n      readonly reason: string;\n      /** Absent: the transfer did not happen (`reverted`). */\n      readonly failure?: TxFailure;\n      /** Every `bounced` and `jettonBounced` verdict carries its chain evidence. */\n      readonly bounce?: BounceEvidence;\n    }\n  /**\n   * Not decidable yet: the trace is still being executed or indexed, or the request ran\n   * without consuming its seqno and may still run again until it expires.\n   */\n  | { readonly kind: 'pending' };\n\n/** Fixed reasons: a stored reason never holds an address, an amount or node text. */\nexport const REASONS = Object.freeze({\n  walletFailed: 'the wallet transaction failed',\n  skipped: 'the wallet skipped a message',\n  bounced: 'transfer bounced',\n  jettonBounced: 'jetton transfer bounced',\n  jettonUnverified: 'the jetton wallets are not the master’s',\n});\n\nconst PENDING: Verdict = Object.freeze({ kind: 'pending' });\nconst failed = (reason: string, bounce?: BounceEvidence): Verdict =>\n  Object.freeze({ kind: 'failed', reason, ...(bounce ? { bounce } : {}) });\n\nconst inconsistent = (reason: string) =>\n  new ProviderError('PROVIDER_INCONSISTENT', reason, { retryable: true });\n\n/**\n * wallet_v5.fc: an external request whose send mode lacks +2, refused after `commit()`\n * stored the next seqno with an empty action list. The chain counts that compute phase a\n * success (transaction.cpp: `success = accepted && committed`) and runs the empty list, so\n * the transaction ran; the scripted node records it that way too. An indexer that wrote it\n * as a failed compute phase is still read as W5's refusal.\n */\nconst W5_REFUSED_AFTER_COMMIT = 137;\n\n/** Whether `tx` ran a W5 signed external request (only W5 throws 137 after committing). */\nfunction w5External(tx: V3Transaction): boolean {\n  if (!tx.inMsg || tx.inMsg.source !== null) return false;\n  const body = messageBody(tx.inMsg);\n  return (\n    body !== null &&\n    body.bits.length >= 32 &&\n    body.beginParse().preloadUint(32) === OP.w5SignedExternal\n  );\n}\n\n/**\n * Whether the wallet transaction of an external request `tx` consumed the request's seqno,\n * so that the same message can never run again: it ran (the new seqno stands with the\n * actions, W5's 137 included), or, as a defensive reading of W5 alone, its compute phase is\n * recorded failed with 137. Any other run left the old seqno (transaction.cpp: a\n * failed action phase drops the compute phase's state, and a compute phase that failed\n * before `commit()` never had one): a foreign request signed with the same key, or our\n * own, whose action phase failed does not consume the seqno. Throws the retryable\n * contradiction of `ran`.\n */\nexport function consumesSeqno(tx: V3Transaction): boolean {\n  if (ran(tx)) return true;\n  return (\n    !tx.compute.success &&\n    !tx.compute.skipped &&\n    tx.compute.exitCode === W5_REFUSED_AFTER_COMMIT &&\n    w5External(tx)\n  );\n}\n\n/**\n * Whether `tx` is our Attempt: the external message to `from` whose TEP-467 hash,\n * computed here from the bound body, is the Attempt id. The indexer's `hash_norm` only\n * finds candidates; it never decides.\n */\nexport function isOwnAttempt(tx: V3Transaction, from: string, refId: string): boolean {\n  if (!tx.inMsg || tx.inMsg.source !== null || tx.account !== from) return false;\n  const body = messageBody(tx.inMsg);\n  return body !== null && externalHashOf(tx.account, body) === refId;\n}\n\n/**\n * The transaction in `trace` that received `message`, which `sender` sent. An internal\n * message is delivered once, to its destination, with its value and its bounce flag:\n * anything else contradicts the chain.\n */\nfunction receiver(trace: V3Trace, message: V3Message, sender: string): V3Transaction {\n  const found = trace.transactions.filter((t) => t.inMsg?.hash === message.hash);\n  const [tx] = found;\n  if (!tx) throw inconsistent('a complete trace lacks a delivered message');\n  if (\n    found.length > 1 ||\n    message.source !== sender ||\n    tx.account !== message.destination ||\n    tx.inMsg?.source !== sender ||\n    tx.inMsg.value !== message.value ||\n    (message.bounce !== null &&\n      tx.inMsg.bounce !== null &&\n      tx.inMsg.bounce !== message.bounce)\n  ) {\n    throw inconsistent('the trace delivered a message other than the one sent');\n  }\n  return tx;\n}\n\ninterface Sent {\n  readonly out: V3Message;\n  /** The bounce flag we signed for it: it decides whether a bounce phase may exist. */\n  readonly bounceable: boolean;\n  /** For a jetton request: its intended recipient (the owner). */\n  readonly jettonRecipient?: string;\n}\n\n/** A native transfer as our builder signs it: a positive value, no body or a comment. */\nfunction plainTransfer(facts: NonNullable<ReturnType<typeof messageFacts>>): boolean {\n  const { value, body } = facts;\n  const empty = body.bits.length === 0 && body.refs.length === 0;\n  return value > 0n && (empty || decodeComment(body) !== undefined);\n}\n\n/**\n * The requested messages, matched one to one with the wallet transaction's outgoing\n * messages; or why they did not all go out: the wallet skipped them (send mode +2), or its\n * code threw after committing the seqno. `ran` holds, so the outgoing messages are\n * distinct and as many as the action phase created; the skips must be exactly the missing\n * messages.\n */\nfunction sentMessages(root: V3Transaction): readonly Sent[] | 'skipped' | 'threw' {\n  const body = messageBody(root.inMsg as V3Message);\n  if (!body) throw inconsistent('the indexer has no body for the external message');\n  const request = decodeWalletRequest(body);\n  if (!request || request.auth !== 'external') {\n    throw inconsistent('the indexed external message is not a wallet transfer');\n  }\n  const action = root.action as NonNullable<V3Transaction['action']>;\n  // Committed, then threw (W5 137): the list committed with the seqno was empty.\n  if (threwAfterCommit(root)) {\n    if (action.msgsCreated !== 0 || action.skippedActions !== 0) {\n      throw inconsistent('the wallet threw after committing, yet ran an action');\n    }\n    return 'threw';\n  }\n  const unused = [...root.outMsgs];\n  const matched: Sent[] = [];\n  let missing = 0;\n  for (const requested of request.messages) {\n    const facts = messageFacts(requested);\n    if (!facts)\n      throw inconsistent('the signed request holds a message that is not internal');\n    // Our builder signs only plain transfers of a positive value and TEP-74 transfers; any\n    // other message moves what the verdict cannot see, so it is never judged a success.\n    const jetton = decodeJettonTransfer(facts.body);\n    if (!jetton && !plainTransfer(facts)) {\n      throw inconsistent('the signed request holds a message the verdict cannot judge');\n    }\n    const index = unused.findIndex(\n      (out) =>\n        out.destination === facts.to &&\n        out.value === facts.value &&\n        out.bodyHash === facts.bodyHash,\n    );\n    if (index < 0) {\n      missing += 1;\n      continue;\n    }\n    const out = unused.splice(index, 1)[0] as V3Message;\n    // A message leaves the wallet with the flag we signed.\n    const bounceable = requested.info.type === 'internal' && requested.info.bounce;\n    if (out.bounce !== null && out.bounce !== bounceable) {\n      throw inconsistent('a message went out with another bounce flag than signed');\n    }\n    matched.push({\n      out,\n      bounceable,\n      ...(jetton ? { jettonRecipient: jetton.destination } : {}),\n    });\n  }\n  if (unused.length > 0) {\n    throw inconsistent(\n      'the wallet transaction sent a message the request did not ask for',\n    );\n  }\n  // Send mode +2: the wallet records exactly the messages it skipped. The action phase\n  // counts skipped sends since global version 8 (config param 8), which both networks\n  // run; on an older chain this refuses (retryable), and never decides.\n  if (missing !== action.skippedActions) {\n    throw inconsistent('the wallet counts other skips than the messages it did not send');\n  }\n  return missing > 0 ? 'skipped' : matched;\n}\n\n/**\n * The `internal_transfer` our jetton wallet `hop` sent onwards for our wallet `from`: the\n * message of a positive amount, `null` when it moved nothing.\n */\nfunction onward(hop: V3Transaction, from: string): V3Message | null {\n  let nothingMoved = false;\n  for (const m of hop.outMsgs) {\n    const body = messageBody(m);\n    const internal = body ? decodeJettonInternalTransfer(body) : null;\n    if (!internal || internal.from !== from) continue;\n    // From the sender, a positive amount, never the exact one (fee-on-transfer tokens).\n    if (internal.amount > 0n) return m;\n    nothingMoved = true; // a zero amount: nothing moved, so `failed` is accurate\n  }\n  if (nothingMoved) return null;\n  throw inconsistent('the jetton wallet ran the transfer but sent none from the sender');\n}\n\n/**\n * What one output did: failed (with why, and the deliveries the chain records it in), a\n * jetton leg to confirm, or delivered.\n */\ntype Outcome =\n  | {\n      readonly failed: string;\n      readonly path: readonly Delivery[];\n      readonly end: BounceEvidence['end'];\n    }\n  | { readonly leg: JettonLeg }\n  | { readonly delivered: true };\n\n/** `tx`, which received `message`, as a delivery on a bounce's path. */\nconst delivery = (tx: V3Transaction, message: V3Message): Delivery => ({\n  account: tx.account,\n  lt: tx.lt,\n  hash: tx.hash,\n  message: message.hash,\n});\n\n/** The outcome of the output `sent` of our wallet `from`, checked against the chain. */\nfunction outcomeOf(trace: V3Trace, from: string, sent: Sent): Outcome {\n  const { out, bounceable, jettonRecipient } = sent;\n  const hop = receiver(trace, out, from);\n  const first = delivery(hop, out);\n  const hopRan = ran(hop);\n  // A bounce phase exists only for a bounceable message, and always when its compute\n  // phase failed (collator.cpp, transaction.cpp `bounce_enabled`). A bounce on a message\n  // we signed non-bounceable would fail a delivery that credited the value; a failed\n  // bounceable delivery without one lacks data. The flag we signed decides, even when the\n  // indexer leaves the delivery's own flag out.\n  if (\n    (hop.inMsg?.bounce !== null && hop.inMsg?.bounce !== bounceable) ||\n    (hop.bounce !== undefined && !bounceable) ||\n    (bounceable && !hop.compute.success && hop.bounce === undefined)\n  ) {\n    throw inconsistent('the delivery contradicts the bounce flag we signed');\n  }\n  if (jettonRecipient === undefined) {\n    // The value stays unless the bounce phase sent it back.\n    return hop.bounce === 'ok'\n      ? { failed: REASONS.bounced, path: [first], end: 'bounced' }\n      : { delivered: true };\n  }\n  // The owner's jetton wallet ran `transfer` and sent `internal_transfer` onwards. A\n  // failed phase dropped its state: the jettons never left.\n  if (!hopRan) return { failed: REASONS.jettonBounced, path: [first], end: 'unran' };\n  const arrivalMessage = onward(hop, from);\n  if (!arrivalMessage) {\n    return { failed: REASONS.jettonBounced, path: [first], end: 'unmoved' };\n  }\n  // TEP-74 707: the receiving wallet takes it only from the sender's jetton wallet.\n  const arrival = receiver(trace, arrivalMessage, hop.account);\n  // A failed phase drops the credit: the jettons came back, or never arrived.\n  if (!ran(arrival)) {\n    return {\n      failed: REASONS.jettonBounced,\n      path: [first, delivery(arrival, arrivalMessage)],\n      end: 'unran',\n    };\n  }\n  return {\n    leg: {\n      senderWallet: hop.account,\n      recipientWallet: arrival.account,\n      recipient: jettonRecipient,\n    },\n  };\n}\n\n/** The verdict on the Attempt whose wallet transaction is `root`, within `trace`. */\nexport function attemptVerdict(root: V3Transaction, trace: V3Trace | null): Verdict {\n  if (!root.inMsg || root.inMsg.source !== null) {\n    throw inconsistent('the attempt is not an external message');\n  }\n  if (!consumesSeqno(root)) return PENDING;\n  if (!root.compute.success) return failed(REASONS.walletFailed);\n  const sent = sentMessages(root);\n  if (sent === 'threw') return failed(REASONS.walletFailed);\n  if (sent === 'skipped') return failed(REASONS.skipped);\n  if (!trace || !trace.complete) return PENDING;\n  // Every output is checked before any decides, so an early failure never hides a later\n  // contradiction.\n  const outcomes = sent.map((each) => outcomeOf(trace, root.account, each));\n  for (const outcome of outcomes) {\n    if ('failed' in outcome) {\n      const { account, lt, hash } = root;\n      return failed(\n        outcome.failed,\n        Object.freeze({\n          root: { account, lt, hash },\n          path: outcome.path,\n          end: outcome.end,\n        }),\n      );\n    }\n  }\n  const legs = outcomes.flatMap((outcome) => ('leg' in outcome ? [outcome.leg] : []));\n  return Object.freeze({ kind: 'success', legs });\n}\n"]}

package/dist/adapters/tron/abi.d.ts

@@ -3,6 +3,8 @@ export declare const SELECTORS: Readonly<{
     balanceOf: "70a08231";
     decimals: "313ce567";
     symbol: "95d89b41";
+    /** Tether's `deprecated()`: `true` once `TetherToken` forwards to an upgraded contract. */
+    deprecated: "0e136b19";
 }>;
 /** `keccak256("Transfer(address,address,uint256)")`, without `0x`. */
 export declare const TRANSFER_TOPIC = "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";

package/dist/adapters/tron/abi.js

@@ -20,6 +20,8 @@ exports.SELECTORS = Object.freeze({
     balanceOf: '70a08231',
     decimals: '313ce567',
     symbol: '95d89b41',
+    /** Tether's `deprecated()`: `true` once `TetherToken` forwards to an upgraded contract. */
+    deprecated: '0e136b19',
 });
 /** `keccak256("Transfer(address,address,uint256)")`, without `0x`. */
 exports.TRANSFER_TOPIC = 'ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';

package/dist/adapters/tron/abi.js.map

@@ -1 +1 @@
-{"version":3,"file":"abi.js","sourceRoot":"","sources":["../../../src/adapters/tron/abi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The TRC-20 calls and events the driver uses, SDK-free: TRC-20 is ERC-20's ABI on the\n * TVM, with 20-byte addresses in ABI words (the `41` prefix dropped). Selectors are pinned\n * by a keccak-256 test.\n */\nimport { ValidationError } from '../../core/errors/error';\nimport { bytesToUtf8, fromHex } from '../../core/util/bytes';\nimport { toHexAddress } from './address';\n\nexport const SELECTORS = Object.freeze({\n  transfer: 'a9059cbb',\n  balanceOf: '70a08231',\n  decimals: '313ce567',\n  symbol: '95d89b41',\n});\n\n/** `keccak256(\"Transfer(address,address,uint256)\")`, without `0x`. */\nexport const TRANSFER_TOPIC =\n  'ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';\n\nconst UINT256_MAX = (1n << 256n) - 1n;\n\nfunction word(value: bigint): string {\n  return value.toString(16).padStart(64, '0');\n}\n\nfunction addressWord(address: string): string {\n  return toHexAddress(address).slice(2).padStart(64, '0');\n}\n\n/** An amount outside `uint256` is refused with a fixed text, never wrapped. */\nexport function encodeTransfer(to: string, amount: bigint): string {\n  if (amount < 0n || amount > UINT256_MAX) {\n    throw new ValidationError('INVALID_AMOUNT', 'amount does not fit in a uint256');\n  }\n  return `${SELECTORS.transfer}${addressWord(to)}${word(amount)}`;\n}\n\nexport function encodeBalanceOf(owner: string): string {\n  return `${SELECTORS.balanceOf}${addressWord(owner)}`;\n}\n\n/**\n * The (to, amount) of `transfer(address,uint256)` call data built the canonical way (12\n * zero bytes before the address); `null` for anything else.\n */\nexport function decodeTransferCall(\n  data: string,\n): { readonly to: string; readonly amount: bigint } | null {\n  // A fixed length (selector + two words), checked before any other work, so a long\n  // untrusted input costs one length check.\n  if (data.length !== 136) return null;\n  const hex = data.toLowerCase();\n  if (!/^a9059cbb[0-9a-f]{128}$/.test(hex)) return null;\n  const toWord = hex.slice(8, 72);\n  if (!toWord.startsWith('0'.repeat(24))) return null;\n  return { to: `41${toWord.slice(24)}`, amount: BigInt(`0x${hex.slice(72)}`) };\n}\n\n/** Throws on data that is not exactly one ABI `uint256` word. */\nexport function decodeUint256(data: string): bigint {\n  if (!/^[0-9a-fA-F]{64}$/.test(data)) throw new TypeError('not one uint256 word');\n  return BigInt(`0x${data}`);\n}\n\n/** One character class, no repeated group: linear on any input. */\nconst HEX_DIGITS = /^[0-9a-fA-F]+$/;\n\n/**\n * Throws on data that is not an ABI `string` (offset 32, length, padded UTF-8). The shape is\n * checked by length and one character class: a repeated-group regex overflows V8's stack\n * on a few million characters.\n */\nexport function decodeString(data: string): string {\n  if (\n    typeof data !== 'string' ||\n    data.length < 128 ||\n    data.length % 64 !== 0 ||\n    !HEX_DIGITS.test(data)\n  ) {\n    throw new TypeError('not an ABI string');\n  }\n  if (BigInt(`0x${data.slice(0, 64)}`) !== 32n) throw new TypeError('bad string offset');\n  const length = BigInt(`0x${data.slice(64, 128)}`);\n  const available = BigInt((data.length - 128) / 2);\n  if (length > available || available - length >= 32n) {\n    throw new TypeError('bad string length');\n  }\n  const bytes = fromHex(data.slice(128, 128 + Number(length) * 2));\n  return bytesToUtf8(bytes);\n}\n\n/**\n * A TRC-20 `Transfer` log's parties (`41…` hex) and amount; `null` for any other log. Tron\n * logs carry hex without `0x`, and `address` is the 20-byte emitter.\n */\nexport function decodeTransferLog(log: {\n  readonly topics: readonly string[];\n  readonly data: string;\n}): { readonly from: string; readonly to: string; readonly amount: bigint } | null {\n  if (log.topics.length !== 3) return null;\n  const [topic, from, to] = log.topics.map((t) => t.toLowerCase());\n  if (topic !== TRANSFER_TOPIC) return null;\n  const party = (value: string | undefined): string | null =>\n    value !== undefined && /^0{24}[0-9a-f]{40}$/.test(value)\n      ? `41${value.slice(24)}`\n      : null;\n  const sender = party(from);\n  const recipient = party(to);\n  if (sender === null || recipient === null || !/^[0-9a-fA-F]{64}$/.test(log.data)) {\n    return null;\n  }\n  return { from: sender, to: recipient, amount: BigInt(`0x${log.data}`) };\n}\n"]}
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../../../src/adapters/tron/abi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The TRC-20 calls and events the driver uses, SDK-free: TRC-20 is ERC-20's ABI on the\n * TVM, with 20-byte addresses in ABI words (the `41` prefix dropped). Selectors are pinned\n * by a keccak-256 test.\n */\nimport { ValidationError } from '../../core/errors/error';\nimport { bytesToUtf8, fromHex } from '../../core/util/bytes';\nimport { toHexAddress } from './address';\n\nexport const SELECTORS = Object.freeze({\n  transfer: 'a9059cbb',\n  balanceOf: '70a08231',\n  decimals: '313ce567',\n  symbol: '95d89b41',\n  /** Tether's `deprecated()`: `true` once `TetherToken` forwards to an upgraded contract. */\n  deprecated: '0e136b19',\n});\n\n/** `keccak256(\"Transfer(address,address,uint256)\")`, without `0x`. */\nexport const TRANSFER_TOPIC =\n  'ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';\n\nconst UINT256_MAX = (1n << 256n) - 1n;\n\nfunction word(value: bigint): string {\n  return value.toString(16).padStart(64, '0');\n}\n\nfunction addressWord(address: string): string {\n  return toHexAddress(address).slice(2).padStart(64, '0');\n}\n\n/** An amount outside `uint256` is refused with a fixed text, never wrapped. */\nexport function encodeTransfer(to: string, amount: bigint): string {\n  if (amount < 0n || amount > UINT256_MAX) {\n    throw new ValidationError('INVALID_AMOUNT', 'amount does not fit in a uint256');\n  }\n  return `${SELECTORS.transfer}${addressWord(to)}${word(amount)}`;\n}\n\nexport function encodeBalanceOf(owner: string): string {\n  return `${SELECTORS.balanceOf}${addressWord(owner)}`;\n}\n\n/**\n * The (to, amount) of `transfer(address,uint256)` call data built the canonical way (12\n * zero bytes before the address); `null` for anything else.\n */\nexport function decodeTransferCall(\n  data: string,\n): { readonly to: string; readonly amount: bigint } | null {\n  // A fixed length (selector + two words), checked before any other work, so a long\n  // untrusted input costs one length check.\n  if (data.length !== 136) return null;\n  const hex = data.toLowerCase();\n  if (!/^a9059cbb[0-9a-f]{128}$/.test(hex)) return null;\n  const toWord = hex.slice(8, 72);\n  if (!toWord.startsWith('0'.repeat(24))) return null;\n  return { to: `41${toWord.slice(24)}`, amount: BigInt(`0x${hex.slice(72)}`) };\n}\n\n/** Throws on data that is not exactly one ABI `uint256` word. */\nexport function decodeUint256(data: string): bigint {\n  if (!/^[0-9a-fA-F]{64}$/.test(data)) throw new TypeError('not one uint256 word');\n  return BigInt(`0x${data}`);\n}\n\n/** One character class, no repeated group: linear on any input. */\nconst HEX_DIGITS = /^[0-9a-fA-F]+$/;\n\n/**\n * Throws on data that is not an ABI `string` (offset 32, length, padded UTF-8). The shape is\n * checked by length and one character class: a repeated-group regex overflows V8's stack\n * on a few million characters.\n */\nexport function decodeString(data: string): string {\n  if (\n    typeof data !== 'string' ||\n    data.length < 128 ||\n    data.length % 64 !== 0 ||\n    !HEX_DIGITS.test(data)\n  ) {\n    throw new TypeError('not an ABI string');\n  }\n  if (BigInt(`0x${data.slice(0, 64)}`) !== 32n) throw new TypeError('bad string offset');\n  const length = BigInt(`0x${data.slice(64, 128)}`);\n  const available = BigInt((data.length - 128) / 2);\n  if (length > available || available - length >= 32n) {\n    throw new TypeError('bad string length');\n  }\n  const bytes = fromHex(data.slice(128, 128 + Number(length) * 2));\n  return bytesToUtf8(bytes);\n}\n\n/**\n * A TRC-20 `Transfer` log's parties (`41…` hex) and amount; `null` for any other log. Tron\n * logs carry hex without `0x`, and `address` is the 20-byte emitter.\n */\nexport function decodeTransferLog(log: {\n  readonly topics: readonly string[];\n  readonly data: string;\n}): { readonly from: string; readonly to: string; readonly amount: bigint } | null {\n  if (log.topics.length !== 3) return null;\n  const [topic, from, to] = log.topics.map((t) => t.toLowerCase());\n  if (topic !== TRANSFER_TOPIC) return null;\n  const party = (value: string | undefined): string | null =>\n    value !== undefined && /^0{24}[0-9a-f]{40}$/.test(value)\n      ? `41${value.slice(24)}`\n      : null;\n  const sender = party(from);\n  const recipient = party(to);\n  if (sender === null || recipient === null || !/^[0-9a-fA-F]{64}$/.test(log.data)) {\n    return null;\n  }\n  return { from: sender, to: recipient, amount: BigInt(`0x${log.data}`) };\n}\n"]}

package/dist/adapters/tron/builder.js

@@ -272,14 +272,30 @@ function createTronBuilder(ctx) {
         return (await api.block('full', undefined, (0, http_1.withSignal)(http_1.READ, signal)));
     }
     /**
-     * The simulated energy of a TRC-20 transfer, after the balance check: a shortfall is
-     * `INSUFFICIENT_FUNDS`, never a revert; a token that refuses a transfer its balance
-     * allows (a blacklist, say) is `INVALID_INTENT`.
+     * The simulated energy of a TRC-20 transfer, after the deprecation and balance checks: a
+     * deprecated token is `ASSET_RESOLUTION`; a shortfall is `INSUFFICIENT_FUNDS`, never a
+     * revert; a token that refuses a transfer its balance allows (a blacklist, say) is
+     * `INVALID_INTENT`.
+     *
+     * Tether's `TetherToken` (USDT) forwards a deprecated contract's `transfer` to its
+     * upgraded contract, which moves the value and emits the `Transfer` event, so the
+     * transfer simulates and executes, and the verdict, which reads the old contract's event,
+     * finds no evidence of it. So `deprecated()` is read beside the balance, once per
+     * estimate (the core estimates before every build), one endpoint's answer as for the
+     * other token reads here, not the proof quorum's: a `true` can only refuse before
+     * signing, the safe direction (as one endpoint's failed simulation already does), and a
+     * wrong `false` leaves the transfer where it was without the guard.
      */
     async function tokenEnergy(p, signal) {
         const tags = (0, http_1.withSignal)(http_1.READ, signal);
         const token = p.token;
-        const available = await (0, reader_1.trc20Balance)(ctx, token, p.owner, tags);
+        const [deprecated, available] = await Promise.all([
+            (0, reader_1.trc20Deprecated)(ctx, token, tags),
+            (0, reader_1.trc20Balance)(ctx, token, p.owner, tags),
+        ]);
+        if (deprecated) {
+            throw new error_1.ValidationError('ASSET_RESOLUTION', 'the token contract is deprecated in favour of an upgraded contract; the asset must be re-registered at the upgraded contract');
+        }
         if (available < p.amount) {
             throw new error_1.ChainError('INSUFFICIENT_FUNDS', 'insufficient token balance for this transfer', { details: { required: p.amount.toString(), available: available.toString() } });
         }

package/dist/adapters/tron/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/adapters/tron/builder.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Tron `TxBuilder` and `Broadcaster`. One output (TRX or TRC-20), an optional memo in\n * `raw_data.data`, `expiry` ordering (`expiresAtMs`), one `secp256k1-ecdsa` digest request\n * over the txID, and the txID as the Attempt ref, known before signing.\n *\n * Reference block and expiration: the reference is the head block (TaPoS), and the\n * transaction expires `expirationMs` after the earlier of the head's time and the local\n * clock, as tronweb does from the head. A head older than half the window is refused\n * (retryable) instead of producing a transaction that is born nearly expired, and so is a\n * head dated more than half the window ahead of the local clock (a clock behind the chain\n * would build transactions born expired); a head dated less far in the future cannot push\n * the expiration beyond the window from now. The ordering records the signed expiration and\n * the reference block's TaPoS bound (`lastValidHeight`: its height, read from its id, plus\n * `TAPOS_WINDOW`), so the negative inclusion proof scans from the attested reference block\n * up to the expiration, whatever the head or the clock claimed: a floor derived from the\n * clock could sit above the block that holds the transaction. The expiration stays inside\n * java-tron's own window (at least the next slot, at most 24 h past its head).\n *\n * Uniqueness: Tron has no nonce, so two identical transfers built on the same head in\n * the same millisecond would share one txID and one on-chain effect. The core refuses an\n * Attempt whose ref another Operation holds; as defense in depth, each build takes a\n * `timestamp` strictly above the previous one from this driver, plus crypto-random offsets\n * on `timestamp` (up to +999 ms) and `expiration` (up to −999 ms); java-tron never\n * validates `raw_data.timestamp`.\n *\n * Nothing is signed before the built bytes are decoded back and shown to carry exactly the\n * intent: owner, recipient, amount, token contract, canonical `transfer(to, amount)` call\n * data with no value, memo, expiration and fee limit. `assemble` checks the same against the\n * stored summary, ordering and fee limit, so the signature goes out only with the transfer\n * that was authorized.\n *\n * Broadcasts are classified here (`classifyOwnBroadcast`), never under a quorum: a transport\n * failure, an unreadable reply or a node answer that may follow pooling is thrown ambiguous\n * (possibly sent). A node's rejection is a claim: it stands only when its reason\n * holds for the bytes that were sent, read back from them; otherwise it is a refusal. A\n * `TX_EXPIRED` refusal is the node's view at its own head, a hint and not proof: Tron has no\n * nonce, so a second Attempt could land beside the first. The broadcaster never re-sends or\n * rebuilds on it; only an attested expiry (the proofs) lets the core build again.\n */\nimport { sha256 } from '@noble/hashes/sha256';\nimport type {\n  Broadcaster,\n  BuildContext,\n  TxBuilder,\n  WalletKey,\n} from '../../core/driver/types';\nimport {\n  ChainError,\n  ConfigError,\n  ProviderError,\n  SigningError,\n  UnsupportedCapabilityError,\n  ValidationError,\n} from '../../core/errors/error';\nimport { assetId, parseAssetId } from '../../core/model/asset';\nimport type { FeeEstimateDraft } from '../../core/model/fee';\nimport type { DriverIntent, IntentSummary } from '../../core/model/intent';\nimport type { OrderingData } from '../../core/model/ordering';\nimport type { UnsignedTx } from '../../core/model/transaction';\nimport { secp256k1Ecdsa } from '../../core/registry/schemes';\nimport {\n  bytesToUtf8,\n  concatBytes,\n  fromHex,\n  randomBytes,\n  toHex,\n  utf8ToBytes,\n} from '../../core/util/bytes';\nimport { decodeTransferCall, encodeTransfer } from './abi';\nimport { addressFromPublicKey, toHexAddress } from './address';\nimport { classifyOwnBroadcast, txBytesOf } from './errors';\nimport { feeLimitCeiling, feeSun, tronFee } from './fees';\nimport { BROADCAST, READ, malformed, withSignal, type TronBlockHeader } from './http';\nimport {\n  MAX_EXPIRATION_MS,\n  MAX_MEMO_BYTES,\n  MIN_EXPIRATION_MS,\n  TAPOS_WINDOW,\n} from './network';\nimport { trc20Balance, trc20Contract, type TronContext } from './reader';\nimport type {\n  TronCallTags,\n  TronContract,\n  TronExpiryOrdering,\n  TronFeeDetails,\n  TronRawData,\n} from './types';\n\n/** The largest `int64` the codec writes from a JS number. */\nconst MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);\n/** A positive base-unit amount in a stored summary: at most a `uint256` (78 digits). */\nconst SUMMARY_AMOUNT = /^[1-9][0-9]{0,77}$/;\n/** Linear on any input: one character class, no repeated group. */\nconst HEX_DIGITS = /^[0-9a-fA-F]+$/;\n\n/** What the signed bytes must carry; addresses are lower-case `41…` hex. */\ninterface Transfer {\n  readonly owner: string;\n  readonly recipient: string;\n  readonly amount: bigint;\n  /** The TRC-20 contract, absent for TRX. */\n  readonly token?: string;\n  /** The memo bytes, lower-case hex; absent without a memo. */\n  readonly memo?: string;\n}\n\ninterface Prepared extends Transfer {\n  /** The recipient as the intent gives it (the summary's form). */\n  readonly to: string;\n  readonly contract: TronContract;\n}\n\nfunction invalid(message: string): ValidationError {\n  return new ValidationError('INVALID_INTENT', message);\n}\n\n/**\n * Whether an address holds a contract, read under the proof quorum: a node's word\n * alone must not refuse a valid transfer, and endpoints that disagree decide nothing.\n */\nconst CONFIRMED: TronCallTags = { ...READ, quorum: 'proof' };\n\n/** The memo's UTF-8 bytes as hex, or undefined; refused when over `MAX_MEMO_BYTES`. */\nfunction memoHex(memo: string | undefined): string | undefined {\n  if (memo === undefined || memo.length === 0) return undefined;\n  const tooLong = () => invalid(`a Tron memo is at most ${MAX_MEMO_BYTES} UTF-8 bytes`);\n  // Each UTF-16 unit is at least one UTF-8 byte, so a longer string is refused unencoded.\n  if (memo.length > MAX_MEMO_BYTES) throw tooLong();\n  const bytes = utf8ToBytes(memo);\n  if (bytes.length > MAX_MEMO_BYTES) throw tooLong();\n  // A lone surrogate would be written as U+FFFD: the chain would carry another memo.\n  if (bytesToUtf8(bytes) !== memo) throw invalid('a Tron memo must be well-formed text');\n  return toHex(bytes);\n}\n\n/**\n * The validated transfer, before any I/O: one output, a positive amount, TRX or TRC-20,\n * valid addresses, a memo within bounds, amounts the encoders can write exactly (a TRX\n * transfer above 2^53 − 1 sun must be split), and TRX never to the sender (java-tron:\n * \"Cannot transfer TRX to yourself.\", for the bytes alone). A TRC-20 transfer to the\n * sender is valid on chain and is allowed.\n */\nfunction prepare(intent: DriverIntent): Prepared {\n  const output = intent.outputs[0];\n  if (!output || intent.outputs.length !== 1) {\n    throw invalid('a Tron transfer has exactly one output');\n  }\n  if (output.amount <= 0n) {\n    throw new ValidationError('INVALID_AMOUNT', 'the amount must be positive');\n  }\n  const token = intent.asset === 'native' ? undefined : trc20Contract(intent.asset);\n  const owner = toHexAddress(intent.from);\n  const recipient = toHexAddress(output.to);\n  const memo = memoHex(intent.memo);\n  let contract: TronContract;\n  if (token === undefined) {\n    if (output.amount > MAX_SAFE) {\n      throw new ValidationError(\n        'INVALID_AMOUNT',\n        'a TRX amount must be at most the largest safe integer of sun',\n      );\n    }\n    if (recipient === owner) throw invalid('a TRX transfer cannot go to its sender');\n    contract = { type: 'TransferContract', owner, to: recipient, amount: output.amount };\n  } else {\n    // encodeTransfer refuses an amount outside uint256 (INVALID_AMOUNT).\n    const data = encodeTransfer(recipient, output.amount);\n    contract = { type: 'TriggerSmartContract', owner, contract: token, data };\n  }\n  return {\n    to: output.to,\n    amount: output.amount,\n    owner,\n    recipient,\n    contract,\n    ...(token !== undefined ? { token } : {}),\n    ...(memo !== undefined ? { memo } : {}),\n  };\n}\n\n/**\n * Whether decoded raw data carries exactly `t`. A TRC-20 call must be the canonical\n * `transfer(to, amount)` (selector, zero-padded recipient, one amount word, nothing more)\n * with no TRX or TRC-10 value: the verdict reads only that shape.\n */\nfunction carries(raw: TronRawData, t: Transfer): boolean {\n  const c = raw.contract;\n  if (c.owner !== t.owner || raw.data !== t.memo) return false;\n  if (t.token === undefined) {\n    return c.type === 'TransferContract' && c.to === t.recipient && c.amount === t.amount;\n  }\n  if (c.type !== 'TriggerSmartContract' || c.contract !== t.token) return false;\n  if (\n    c.callValue !== undefined ||\n    c.callTokenValue !== undefined ||\n    c.tokenId !== undefined\n  ) {\n    return false;\n  }\n  const call = decodeTransferCall(c.data);\n  return call !== null && call.to === t.recipient && call.amount === t.amount;\n}\n\n/** The transfer a stored summary describes, signed by `owner`; null when it describes none. */\nfunction summaryTransfer(\n  ctx: TronContext,\n  summary: IntentSummary,\n  owner: string,\n): Transfer | null {\n  try {\n    const { chain, network, ref } = parseAssetId(summary.asset);\n    const output = summary.outputs[0];\n    if (\n      chain !== ctx.chain.id ||\n      network !== ctx.network.id ||\n      !output ||\n      summary.outputs.length !== 1 ||\n      !SUMMARY_AMOUNT.test(output.amount)\n    ) {\n      return null;\n    }\n    const token = ref === 'native' ? undefined : trc20Contract(ref);\n    const memo = memoHex(summary.memo);\n    return {\n      owner,\n      recipient: toHexAddress(output.to),\n      amount: BigInt(output.amount),\n      ...(token !== undefined ? { token } : {}),\n      ...(memo !== undefined ? { memo } : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The fee fields a build writes, from this transfer's own `tron` estimate: the bandwidth\n * the estimate covers and, for TRC-20 only, a positive fee limit within the handle's\n * `maxFeeLimit`, wherever the estimate came from. The limit is handed to the codec\n * as a number and its `safe()` refuses one it cannot hold exactly: it is never\n * rounded into the bytes.\n */\nfunction feeFields(\n  fee: FeeEstimateDraft,\n  p: Prepared,\n  maxFeeLimit: bigint,\n): { readonly bandwidth: bigint; readonly feeLimit?: number } {\n  const details = fee.details as Partial<TronFeeDetails>;\n  const mismatch = () =>\n    invalid('the fee estimate is not a Tron estimate for this transfer');\n  if (\n    fee.kind !== 'tron' ||\n    typeof details.bandwidth !== 'bigint' ||\n    details.bandwidth <= 0n\n  ) {\n    throw mismatch();\n  }\n  if (p.token === undefined) {\n    if (details.feeLimit !== undefined) throw mismatch();\n    return { bandwidth: details.bandwidth };\n  }\n  if (typeof details.feeLimit !== 'bigint' || details.feeLimit <= 0n) throw mismatch();\n  if (details.feeLimit > maxFeeLimit) {\n    throw invalid(\n      'the fee limit is above maxFeeLimit, the Tron handle option that bounds it (in sun)',\n    );\n  }\n  return { bandwidth: details.bandwidth, feeLimit: Number(details.feeLimit) };\n}\n\n/** The sender's own key: a signature from any other key would not authorize the owner. */\nfunction signingKey(keys: readonly WalletKey[], owner: string): WalletKey {\n  for (const key of keys) {\n    if (key.scheme !== 'secp256k1-ecdsa') continue;\n    try {\n      if (toHexAddress(addressFromPublicKey(key.publicKey)) === owner) return key;\n    } catch {\n      // Not a secp256k1 point: not this sender's key.\n    }\n  }\n  throw new SigningError(\n    'SIGNER_UNAVAILABLE',\n    'no secp256k1 key for the sending address',\n  );\n}\n\nfunction varint(value: number): Uint8Array {\n  const out: number[] = [];\n  let v = value;\n  do {\n    let byte = v & 0x7f;\n    v = Math.floor(v / 128);\n    if (v > 0) byte |= 0x80;\n    out.push(byte);\n  } while (v > 0);\n  return Uint8Array.from(out);\n}\n\n/** `Transaction { raw raw_data = 1; repeated bytes signature = 2; }` with one signature. */\nfunction signedTransaction(raw: Uint8Array, signature: Uint8Array): Uint8Array {\n  return concatBytes(\n    Uint8Array.of(0x0a),\n    varint(raw.length),\n    raw,\n    Uint8Array.of(0x12),\n    varint(signature.length),\n    signature,\n  );\n}\n\n/**\n * java-tron's bandwidth for a transaction whose `raw_data` is `rawBytes` long\n * (`BandwidthProcessor.consume`): the signed size without `ret` (field 1 with its length and\n * the raw bytes, field 2 with its length and one 65-byte signature) plus 64 result bytes.\n */\nexport function bandwidthOf(rawBytes: number): bigint {\n  return BigInt(1 + varint(rawBytes).length + rawBytes + 2 + 65 + 64);\n}\n\n/** A crypto-random integer in [0, 1000). */\nfunction jitter(): number {\n  const bytes = randomBytes(2);\n  return (((bytes[0] as number) << 8) | (bytes[1] as number)) % 1000;\n}\n\nconst expiresAt = (ordering: OrderingData): number | undefined =>\n  ordering.kind === 'expiry' ? ordering.expiresAtMs : undefined;\n\n/**\n * Whether an ordering names the signed reference block: a reference height\n * (`lastValidHeight − TAPOS_WINDOW`) whose bytes 6..8 are the signed `ref_block_bytes`, and\n * the signed `ref_block_hash` itself. The proofs trust the height only with the hash.\n */\nfunction boundToReference(ordering: OrderingData, raw: TronRawData): boolean {\n  if (ordering.kind !== 'expiry') return false;\n  const { lastValidHeight: last, refBlockHash } = ordering as Partial<TronExpiryOrdering>;\n  if (typeof last !== 'bigint' || last < TAPOS_WINDOW) return false;\n  return (\n    ((last - TAPOS_WINDOW) & 0xffffn) === BigInt(`0x${raw.refBlockBytes}`) &&\n    refBlockHash === raw.refBlockHash\n  );\n}\n\nexport function createTronBuilder(ctx: TronContext): {\n  readonly builder: TxBuilder;\n  readonly broadcaster: Broadcaster;\n} {\n  const { api, codec, config } = ctx;\n  let lastTimestamp = 0;\n\n  const refFields = (head: TronBlockHeader) => ({\n    refBlockBytes: head.id.slice(12, 16),\n    refBlockHash: head.id.slice(16, 32),\n  });\n\n  async function head(signal?: AbortSignal): Promise<TronBlockHeader> {\n    // `block` throws a malformed answer rather than return no head.\n    return (await api.block(\n      'full',\n      undefined,\n      withSignal(READ, signal),\n    )) as TronBlockHeader;\n  }\n\n  /**\n   * The simulated energy of a TRC-20 transfer, after the balance check: a shortfall is\n   * `INSUFFICIENT_FUNDS`, never a revert; a token that refuses a transfer its balance\n   * allows (a blacklist, say) is `INVALID_INTENT`.\n   */\n  async function tokenEnergy(p: Prepared, signal?: AbortSignal): Promise<bigint> {\n    const tags = withSignal(READ, signal);\n    const token = p.token as string;\n    const available = await trc20Balance(ctx, token, p.owner, tags);\n    if (available < p.amount) {\n      throw new ChainError(\n        'INSUFFICIENT_FUNDS',\n        'insufficient token balance for this transfer',\n        { details: { required: p.amount.toString(), available: available.toString() } },\n      );\n    }\n    const data = (p.contract as Extract<TronContract, { type: 'TriggerSmartContract' }>)\n      .data;\n    const call = await api.constantCall(p.owner, token, data, tags);\n    if (call.kind === 'no-contract') {\n      // Its balanceOf just answered: two reads disagree, which decides nothing.\n      throw new ProviderError(\n        'PROVIDER_INCONSISTENT',\n        'the node both holds and lacks this token contract',\n        { retryable: true },\n      );\n    }\n    if (call.kind === 'failed') throw invalid('the token contract refuses this transfer');\n    return call.energy;\n  }\n\n  const builder: TxBuilder = {\n    async estimateFee(intent, build: BuildContext) {\n      const p = prepare(intent);\n      const tags = withSignal(READ, build.signal);\n      const [params, resources, block, recipient, energy] = await Promise.all([\n        api.chainParameters(tags),\n        api.resources(p.owner, tags),\n        head(build.signal),\n        p.token === undefined ? api.account(p.recipient, tags) : undefined,\n        p.token === undefined ? undefined : tokenEnergy(p, build.signal),\n      ]);\n      // Where the chain forbids TRX to a contract, such a transfer is refused before\n      // signing (it would only be refused, stall and expire). Elsewhere it is valid on\n      // chain: the flag is 0 on mainnet, Nile and Shasta.\n      // Known gap: the flag is one endpoint's word, read without a quorum, so a false 1\n      // refuses a valid transfer before signing and a false 0 lets the chain refuse it;\n      // liveness only, never a wrong payment.\n      if (\n        p.token === undefined &&\n        params.forbidTransferToContract &&\n        (await api.contractExists(p.recipient, withSignal(CONFIRMED, build.signal)))\n      ) {\n        throw invalid(\n          'this network refuses TRX sent to a contract (getForbidTransferToContract)',\n        );\n      }\n      // An upper bound of the built size: no expiration jitter, a later timestamp, and the\n      // largest fee limit a build can carry (the ceiling `tronFee` applies).\n      const now = ctx.clock.now();\n      const ceiling = feeLimitCeiling(params, config.maxFeeLimit).value;\n      const provisional = codec.encodeRaw({\n        ...refFields(block),\n        expiration: Math.min(block.timestamp, now) + config.expirationMs,\n        timestamp: Math.max(now + 1_000, lastTimestamp + 1),\n        ...(p.token !== undefined ? { feeLimit: Number(ceiling) } : {}),\n        ...(p.memo !== undefined ? { data: p.memo } : {}),\n        contract: p.contract,\n      });\n      return tronFee({\n        fee: intent.fee,\n        params,\n        resources,\n        bandwidth: bandwidthOf(provisional.length / 2),\n        activation: recipient !== undefined && !recipient.exists,\n        memo: p.memo !== undefined,\n        ...(energy !== undefined ? { energy } : {}),\n        marginPercent: config.energyMarginPercent,\n        maxFeeLimit: config.maxFeeLimit,\n      });\n    },\n\n    async checkFunds(intent, fee, build) {\n      const p = prepare(intent);\n      const tags = withSignal(READ, build.signal);\n      const [account, tokens] = await Promise.all([\n        api.account(p.owner, tags),\n        p.token === undefined ? undefined : trc20Balance(ctx, p.token, p.owner, tags),\n      ]);\n      if (tokens !== undefined && tokens < p.amount) {\n        return { ok: false, asset: intent.asset, required: p.amount, available: tokens };\n      }\n      const required = feeSun(fee) + (p.token === undefined ? p.amount : 0n);\n      // An account that was never activated has no free bandwidth and cannot send.\n      return account.exists && account.balance >= required\n        ? { ok: true }\n        : { ok: false, asset: 'native', required, available: account.balance };\n    },\n\n    async build(intent, fee, build): Promise<UnsignedTx> {\n      const p = prepare(intent);\n      const key = signingKey(build.keys, p.owner);\n      const fees = feeFields(fee, p, config.maxFeeLimit);\n      const block = await head(build.signal);\n      const now = ctx.clock.now();\n      if (now - block.timestamp > config.expirationMs / 2) {\n        throw new ProviderError(\n          'PROVIDER_UNAVAILABLE',\n          'the head block is too old to reference; try again',\n        );\n      }\n      // A head dated more than half the window ahead means a local clock behind\n      // the chain, whose every build would be born expired (and cost a signature per\n      // rebuild), or a lying endpoint. Either way nothing is built on it.\n      if (block.timestamp - now > config.expirationMs / 2) {\n        throw new ProviderError(\n          'PROVIDER_UNAVAILABLE',\n          'the head block is dated ahead of the local clock; check the clock or try again',\n        );\n      }\n      // The reference block's height, from its id (java-tron's block id is the\n      // height's 8 bytes followed by 24 bytes of the header hash, `generateBlockId`): the\n      // same bytes TaPoS reads. A head whose id and number disagree is not a block.\n      const reference = BigInt(`0x${block.id.slice(0, 16)}`);\n      if (reference !== block.number) throw malformed('head block id');\n      const anchor = Math.min(block.timestamp, now);\n      const expiration = anchor + config.expirationMs - jitter();\n      // The window stays within MAX_EXPIRATION_MS, and java-tron wants at least the next\n      // slot. The network config bounds the window; this holds it.\n      if (expiration - anchor > MAX_EXPIRATION_MS) {\n        throw new ConfigError(\n          'CONFIG_INVALID',\n          'the expiration window exceeds the maximum',\n        );\n      }\n      if (expiration - anchor < MIN_EXPIRATION_MS - 1_000) {\n        throw new ConfigError(\n          'CONFIG_INVALID',\n          'the expiration window is below the minimum',\n        );\n      }\n      const timestamp = Math.max(now + jitter(), lastTimestamp + 1);\n      lastTimestamp = timestamp;\n      const raw: TronRawData = {\n        ...refFields(block),\n        expiration,\n        timestamp,\n        ...(fees.feeLimit !== undefined ? { feeLimit: fees.feeLimit } : {}),\n        ...(p.memo !== undefined ? { data: p.memo } : {}),\n        contract: p.contract,\n      };\n      const payload = codec.encodeRaw(raw);\n      // Before anything is signed: the bytes decode strictly to exactly this transfer.\n      let built: TronRawData | undefined;\n      try {\n        built = codec.decodeRaw(payload);\n      } catch {\n        built = undefined;\n      }\n      if (\n        !built ||\n        !carries(built, p) ||\n        built.expiration !== expiration ||\n        built.feeLimit !== raw.feeLimit\n      ) {\n        throw invalid('the built transaction does not carry this transfer');\n      }\n      if (bandwidthOf(payload.length / 2) > fees.bandwidth) {\n        throw invalid(\"the fee estimate does not cover this transaction's bandwidth\");\n      }\n      const txId = toHex(sha256(fromHex(payload)));\n      // The negative proof scans from the reference block to the signed expiration; the\n      // height is the head's claim, so the signed hash bytes go with it, and the proof\n      // trusts the height only where the attested block carries them.\n      const ordering: TronExpiryOrdering = {\n        kind: 'expiry',\n        expiresAtMs: expiration,\n        lastValidHeight: reference + TAPOS_WINDOW,\n        refBlockHash: raw.refBlockHash,\n      };\n      return {\n        payload: { encoding: 'hex', data: payload },\n        expectedRef: { id: txId, idKind: 'tx-hash', canonical: true },\n        signingRequests: [\n          {\n            id: 'r0',\n            scheme: 'secp256k1-ecdsa',\n            payload: fromHex(txId),\n            payloadKind: 'digest',\n            publicKey: key.publicKey,\n            ...(key.keyRef ? { keyRef: key.keyRef } : {}),\n          },\n        ],\n        ordering,\n        fee,\n        summary: {\n          asset: assetId(ctx.chain.id, ctx.network.id, intent.asset),\n          outputs: [{ to: p.to, amount: p.amount.toString() }],\n          ...(intent.memo !== undefined ? { memo: intent.memo } : {}),\n        },\n      };\n    },\n\n    async assemble(unsigned, signatures) {\n      const fail = (message: string) => new SigningError('SIGNING_FAILED', message);\n      const request = unsigned.signingRequests[0];\n      const signature = signatures.find((s) => s.requestId === 'r0');\n      if (\n        !request ||\n        request.id !== 'r0' ||\n        unsigned.signingRequests.length !== 1 ||\n        !signature ||\n        signature.bytes.length !== 64 ||\n        (signature.recovery !== 0 && signature.recovery !== 1)\n      ) {\n        throw fail('missing or malformed signature for request r0');\n      }\n      const mismatch = () => fail('the unsigned payload does not match its txID');\n      if (unsigned.payload.encoding !== 'hex') throw mismatch();\n      let raw: Uint8Array;\n      try {\n        raw = fromHex(unsigned.payload.data);\n      } catch {\n        throw mismatch();\n      }\n      const txId = toHex(sha256(raw));\n      if (txId !== toHex(request.payload) || txId !== unsigned.expectedRef?.id) {\n        throw mismatch();\n      }\n      // The stored bytes decode strictly, and their owner is the signing key's\n      // account, so a signature never authorizes another account's transaction.\n      let decoded: TronRawData;\n      try {\n        decoded = codec.decodeRaw(unsigned.payload.data);\n      } catch {\n        throw fail('the unsigned payload is not a Tron transfer');\n      }\n      let signer: string;\n      try {\n        signer = toHexAddress(addressFromPublicKey(request.publicKey));\n      } catch {\n        throw fail('the signing request has no valid public key');\n      }\n      if (decoded.contract.owner !== signer) {\n        throw fail(\"the payload's owner is not the signing key's account\");\n      }\n      // Only a signature the node will take for the owner's goes out, low s and\n      // recovery bit included, as the core's scheme checks it; a signer fault is a signing\n      // failure here, never a refusal on chain.\n      if (\n        !secp256k1Ecdsa.verify({\n          publicKey: request.publicKey,\n          payload: fromHex(txId),\n          signature: signature.bytes,\n          recovery: signature.recovery,\n        })\n      ) {\n        throw fail('the signature does not verify against the signing key');\n      }\n      // The bytes carry the authorized summary; the proofs read the expiration and the\n      // reference height from the ordering; only the named fee field is read (the core may\n      // add others).\n      const expected = summaryTransfer(ctx, unsigned.summary, signer);\n      const feeLimit = (unsigned.fee.details as Partial<TronFeeDetails>).feeLimit;\n      if (\n        !expected ||\n        !carries(decoded, expected) ||\n        expiresAt(unsigned.ordering) !== decoded.expiration ||\n        !boundToReference(unsigned.ordering, decoded) ||\n        unsigned.fee.kind !== 'tron' ||\n        (expected.token === undefined\n          ? decoded.feeLimit !== undefined\n          : typeof feeLimit !== 'bigint' ||\n            decoded.feeLimit === undefined ||\n            BigInt(decoded.feeLimit) !== feeLimit)\n      ) {\n        throw fail(\n          'the unsigned payload does not match its summary, expiry or fee limit',\n        );\n      }\n      const sig = concatBytes(signature.bytes, Uint8Array.of(27 + signature.recovery));\n      return {\n        raw: { encoding: 'hex', data: toHex(signedTransaction(raw, sig)) },\n        ref: { id: txId, idKind: 'tx-hash', canonical: true },\n      };\n    },\n  };\n\n  const broadcaster: Broadcaster = {\n    async broadcast(signed, options = {}) {\n      const { raw } = signed;\n      if (\n        raw.encoding !== 'hex' ||\n        typeof raw.data !== 'string' ||\n        raw.data.length % 2 !== 0 ||\n        !HEX_DIGITS.test(raw.data)\n      ) {\n        throw new UnsupportedCapabilityError(\n          'UNSUPPORTED_CAPABILITY',\n          'Tron broadcasts take the signed transaction as hex',\n        );\n      }\n      // The broadcast tags carry no quorum: one node's answer is classified, never compared.\n      const hex = raw.data.toLowerCase();\n      const answer = await api.broadcastHex(hex, {\n        ...BROADCAST,\n        ...(options.fanout !== undefined ? { fanout: options.fanout } : {}),\n        ...(options.signal ? { signal: options.signal } : {}),\n      });\n      // Inside the broadcaster, so a possibly-sent throw reaches the engine's recordAmbiguous.\n      // A rejection stands only when its reason holds for these bytes.\n      return classifyOwnBroadcast(answer, txBytesOf(hex));\n    },\n  };\n\n  return { builder, broadcaster };\n}\n"]}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/adapters/tron/builder.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Tron `TxBuilder` and `Broadcaster`. One output (TRX or TRC-20), an optional memo in\n * `raw_data.data`, `expiry` ordering (`expiresAtMs`), one `secp256k1-ecdsa` digest request\n * over the txID, and the txID as the Attempt ref, known before signing.\n *\n * Reference block and expiration: the reference is the head block (TaPoS), and the\n * transaction expires `expirationMs` after the earlier of the head's time and the local\n * clock, as tronweb does from the head. A head older than half the window is refused\n * (retryable) instead of producing a transaction that is born nearly expired, and so is a\n * head dated more than half the window ahead of the local clock (a clock behind the chain\n * would build transactions born expired); a head dated less far in the future cannot push\n * the expiration beyond the window from now. The ordering records the signed expiration and\n * the reference block's TaPoS bound (`lastValidHeight`: its height, read from its id, plus\n * `TAPOS_WINDOW`), so the negative inclusion proof scans from the attested reference block\n * up to the expiration, whatever the head or the clock claimed: a floor derived from the\n * clock could sit above the block that holds the transaction. The expiration stays inside\n * java-tron's own window (at least the next slot, at most 24 h past its head).\n *\n * Uniqueness: Tron has no nonce, so two identical transfers built on the same head in\n * the same millisecond would share one txID and one on-chain effect. The core refuses an\n * Attempt whose ref another Operation holds; as defense in depth, each build takes a\n * `timestamp` strictly above the previous one from this driver, plus crypto-random offsets\n * on `timestamp` (up to +999 ms) and `expiration` (up to −999 ms); java-tron never\n * validates `raw_data.timestamp`.\n *\n * Nothing is signed before the built bytes are decoded back and shown to carry exactly the\n * intent: owner, recipient, amount, token contract, canonical `transfer(to, amount)` call\n * data with no value, memo, expiration and fee limit. `assemble` checks the same against the\n * stored summary, ordering and fee limit, so the signature goes out only with the transfer\n * that was authorized.\n *\n * Broadcasts are classified here (`classifyOwnBroadcast`), never under a quorum: a transport\n * failure, an unreadable reply or a node answer that may follow pooling is thrown ambiguous\n * (possibly sent). A node's rejection is a claim: it stands only when its reason\n * holds for the bytes that were sent, read back from them; otherwise it is a refusal. A\n * `TX_EXPIRED` refusal is the node's view at its own head, a hint and not proof: Tron has no\n * nonce, so a second Attempt could land beside the first. The broadcaster never re-sends or\n * rebuilds on it; only an attested expiry (the proofs) lets the core build again.\n */\nimport { sha256 } from '@noble/hashes/sha256';\nimport type {\n  Broadcaster,\n  BuildContext,\n  TxBuilder,\n  WalletKey,\n} from '../../core/driver/types';\nimport {\n  ChainError,\n  ConfigError,\n  ProviderError,\n  SigningError,\n  UnsupportedCapabilityError,\n  ValidationError,\n} from '../../core/errors/error';\nimport { assetId, parseAssetId } from '../../core/model/asset';\nimport type { FeeEstimateDraft } from '../../core/model/fee';\nimport type { DriverIntent, IntentSummary } from '../../core/model/intent';\nimport type { OrderingData } from '../../core/model/ordering';\nimport type { UnsignedTx } from '../../core/model/transaction';\nimport { secp256k1Ecdsa } from '../../core/registry/schemes';\nimport {\n  bytesToUtf8,\n  concatBytes,\n  fromHex,\n  randomBytes,\n  toHex,\n  utf8ToBytes,\n} from '../../core/util/bytes';\nimport { decodeTransferCall, encodeTransfer } from './abi';\nimport { addressFromPublicKey, toHexAddress } from './address';\nimport { classifyOwnBroadcast, txBytesOf } from './errors';\nimport { feeLimitCeiling, feeSun, tronFee } from './fees';\nimport { BROADCAST, READ, malformed, withSignal, type TronBlockHeader } from './http';\nimport {\n  MAX_EXPIRATION_MS,\n  MAX_MEMO_BYTES,\n  MIN_EXPIRATION_MS,\n  TAPOS_WINDOW,\n} from './network';\nimport { trc20Balance, trc20Contract, trc20Deprecated, type TronContext } from './reader';\nimport type {\n  TronCallTags,\n  TronContract,\n  TronExpiryOrdering,\n  TronFeeDetails,\n  TronRawData,\n} from './types';\n\n/** The largest `int64` the codec writes from a JS number. */\nconst MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);\n/** A positive base-unit amount in a stored summary: at most a `uint256` (78 digits). */\nconst SUMMARY_AMOUNT = /^[1-9][0-9]{0,77}$/;\n/** Linear on any input: one character class, no repeated group. */\nconst HEX_DIGITS = /^[0-9a-fA-F]+$/;\n\n/** What the signed bytes must carry; addresses are lower-case `41…` hex. */\ninterface Transfer {\n  readonly owner: string;\n  readonly recipient: string;\n  readonly amount: bigint;\n  /** The TRC-20 contract, absent for TRX. */\n  readonly token?: string;\n  /** The memo bytes, lower-case hex; absent without a memo. */\n  readonly memo?: string;\n}\n\ninterface Prepared extends Transfer {\n  /** The recipient as the intent gives it (the summary's form). */\n  readonly to: string;\n  readonly contract: TronContract;\n}\n\nfunction invalid(message: string): ValidationError {\n  return new ValidationError('INVALID_INTENT', message);\n}\n\n/**\n * Whether an address holds a contract, read under the proof quorum: a node's word\n * alone must not refuse a valid transfer, and endpoints that disagree decide nothing.\n */\nconst CONFIRMED: TronCallTags = { ...READ, quorum: 'proof' };\n\n/** The memo's UTF-8 bytes as hex, or undefined; refused when over `MAX_MEMO_BYTES`. */\nfunction memoHex(memo: string | undefined): string | undefined {\n  if (memo === undefined || memo.length === 0) return undefined;\n  const tooLong = () => invalid(`a Tron memo is at most ${MAX_MEMO_BYTES} UTF-8 bytes`);\n  // Each UTF-16 unit is at least one UTF-8 byte, so a longer string is refused unencoded.\n  if (memo.length > MAX_MEMO_BYTES) throw tooLong();\n  const bytes = utf8ToBytes(memo);\n  if (bytes.length > MAX_MEMO_BYTES) throw tooLong();\n  // A lone surrogate would be written as U+FFFD: the chain would carry another memo.\n  if (bytesToUtf8(bytes) !== memo) throw invalid('a Tron memo must be well-formed text');\n  return toHex(bytes);\n}\n\n/**\n * The validated transfer, before any I/O: one output, a positive amount, TRX or TRC-20,\n * valid addresses, a memo within bounds, amounts the encoders can write exactly (a TRX\n * transfer above 2^53 − 1 sun must be split), and TRX never to the sender (java-tron:\n * \"Cannot transfer TRX to yourself.\", for the bytes alone). A TRC-20 transfer to the\n * sender is valid on chain and is allowed.\n */\nfunction prepare(intent: DriverIntent): Prepared {\n  const output = intent.outputs[0];\n  if (!output || intent.outputs.length !== 1) {\n    throw invalid('a Tron transfer has exactly one output');\n  }\n  if (output.amount <= 0n) {\n    throw new ValidationError('INVALID_AMOUNT', 'the amount must be positive');\n  }\n  const token = intent.asset === 'native' ? undefined : trc20Contract(intent.asset);\n  const owner = toHexAddress(intent.from);\n  const recipient = toHexAddress(output.to);\n  const memo = memoHex(intent.memo);\n  let contract: TronContract;\n  if (token === undefined) {\n    if (output.amount > MAX_SAFE) {\n      throw new ValidationError(\n        'INVALID_AMOUNT',\n        'a TRX amount must be at most the largest safe integer of sun',\n      );\n    }\n    if (recipient === owner) throw invalid('a TRX transfer cannot go to its sender');\n    contract = { type: 'TransferContract', owner, to: recipient, amount: output.amount };\n  } else {\n    // encodeTransfer refuses an amount outside uint256 (INVALID_AMOUNT).\n    const data = encodeTransfer(recipient, output.amount);\n    contract = { type: 'TriggerSmartContract', owner, contract: token, data };\n  }\n  return {\n    to: output.to,\n    amount: output.amount,\n    owner,\n    recipient,\n    contract,\n    ...(token !== undefined ? { token } : {}),\n    ...(memo !== undefined ? { memo } : {}),\n  };\n}\n\n/**\n * Whether decoded raw data carries exactly `t`. A TRC-20 call must be the canonical\n * `transfer(to, amount)` (selector, zero-padded recipient, one amount word, nothing more)\n * with no TRX or TRC-10 value: the verdict reads only that shape.\n */\nfunction carries(raw: TronRawData, t: Transfer): boolean {\n  const c = raw.contract;\n  if (c.owner !== t.owner || raw.data !== t.memo) return false;\n  if (t.token === undefined) {\n    return c.type === 'TransferContract' && c.to === t.recipient && c.amount === t.amount;\n  }\n  if (c.type !== 'TriggerSmartContract' || c.contract !== t.token) return false;\n  if (\n    c.callValue !== undefined ||\n    c.callTokenValue !== undefined ||\n    c.tokenId !== undefined\n  ) {\n    return false;\n  }\n  const call = decodeTransferCall(c.data);\n  return call !== null && call.to === t.recipient && call.amount === t.amount;\n}\n\n/** The transfer a stored summary describes, signed by `owner`; null when it describes none. */\nfunction summaryTransfer(\n  ctx: TronContext,\n  summary: IntentSummary,\n  owner: string,\n): Transfer | null {\n  try {\n    const { chain, network, ref } = parseAssetId(summary.asset);\n    const output = summary.outputs[0];\n    if (\n      chain !== ctx.chain.id ||\n      network !== ctx.network.id ||\n      !output ||\n      summary.outputs.length !== 1 ||\n      !SUMMARY_AMOUNT.test(output.amount)\n    ) {\n      return null;\n    }\n    const token = ref === 'native' ? undefined : trc20Contract(ref);\n    const memo = memoHex(summary.memo);\n    return {\n      owner,\n      recipient: toHexAddress(output.to),\n      amount: BigInt(output.amount),\n      ...(token !== undefined ? { token } : {}),\n      ...(memo !== undefined ? { memo } : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The fee fields a build writes, from this transfer's own `tron` estimate: the bandwidth\n * the estimate covers and, for TRC-20 only, a positive fee limit within the handle's\n * `maxFeeLimit`, wherever the estimate came from. The limit is handed to the codec\n * as a number and its `safe()` refuses one it cannot hold exactly: it is never\n * rounded into the bytes.\n */\nfunction feeFields(\n  fee: FeeEstimateDraft,\n  p: Prepared,\n  maxFeeLimit: bigint,\n): { readonly bandwidth: bigint; readonly feeLimit?: number } {\n  const details = fee.details as Partial<TronFeeDetails>;\n  const mismatch = () =>\n    invalid('the fee estimate is not a Tron estimate for this transfer');\n  if (\n    fee.kind !== 'tron' ||\n    typeof details.bandwidth !== 'bigint' ||\n    details.bandwidth <= 0n\n  ) {\n    throw mismatch();\n  }\n  if (p.token === undefined) {\n    if (details.feeLimit !== undefined) throw mismatch();\n    return { bandwidth: details.bandwidth };\n  }\n  if (typeof details.feeLimit !== 'bigint' || details.feeLimit <= 0n) throw mismatch();\n  if (details.feeLimit > maxFeeLimit) {\n    throw invalid(\n      'the fee limit is above maxFeeLimit, the Tron handle option that bounds it (in sun)',\n    );\n  }\n  return { bandwidth: details.bandwidth, feeLimit: Number(details.feeLimit) };\n}\n\n/** The sender's own key: a signature from any other key would not authorize the owner. */\nfunction signingKey(keys: readonly WalletKey[], owner: string): WalletKey {\n  for (const key of keys) {\n    if (key.scheme !== 'secp256k1-ecdsa') continue;\n    try {\n      if (toHexAddress(addressFromPublicKey(key.publicKey)) === owner) return key;\n    } catch {\n      // Not a secp256k1 point: not this sender's key.\n    }\n  }\n  throw new SigningError(\n    'SIGNER_UNAVAILABLE',\n    'no secp256k1 key for the sending address',\n  );\n}\n\nfunction varint(value: number): Uint8Array {\n  const out: number[] = [];\n  let v = value;\n  do {\n    let byte = v & 0x7f;\n    v = Math.floor(v / 128);\n    if (v > 0) byte |= 0x80;\n    out.push(byte);\n  } while (v > 0);\n  return Uint8Array.from(out);\n}\n\n/** `Transaction { raw raw_data = 1; repeated bytes signature = 2; }` with one signature. */\nfunction signedTransaction(raw: Uint8Array, signature: Uint8Array): Uint8Array {\n  return concatBytes(\n    Uint8Array.of(0x0a),\n    varint(raw.length),\n    raw,\n    Uint8Array.of(0x12),\n    varint(signature.length),\n    signature,\n  );\n}\n\n/**\n * java-tron's bandwidth for a transaction whose `raw_data` is `rawBytes` long\n * (`BandwidthProcessor.consume`): the signed size without `ret` (field 1 with its length and\n * the raw bytes, field 2 with its length and one 65-byte signature) plus 64 result bytes.\n */\nexport function bandwidthOf(rawBytes: number): bigint {\n  return BigInt(1 + varint(rawBytes).length + rawBytes + 2 + 65 + 64);\n}\n\n/** A crypto-random integer in [0, 1000). */\nfunction jitter(): number {\n  const bytes = randomBytes(2);\n  return (((bytes[0] as number) << 8) | (bytes[1] as number)) % 1000;\n}\n\nconst expiresAt = (ordering: OrderingData): number | undefined =>\n  ordering.kind === 'expiry' ? ordering.expiresAtMs : undefined;\n\n/**\n * Whether an ordering names the signed reference block: a reference height\n * (`lastValidHeight − TAPOS_WINDOW`) whose bytes 6..8 are the signed `ref_block_bytes`, and\n * the signed `ref_block_hash` itself. The proofs trust the height only with the hash.\n */\nfunction boundToReference(ordering: OrderingData, raw: TronRawData): boolean {\n  if (ordering.kind !== 'expiry') return false;\n  const { lastValidHeight: last, refBlockHash } = ordering as Partial<TronExpiryOrdering>;\n  if (typeof last !== 'bigint' || last < TAPOS_WINDOW) return false;\n  return (\n    ((last - TAPOS_WINDOW) & 0xffffn) === BigInt(`0x${raw.refBlockBytes}`) &&\n    refBlockHash === raw.refBlockHash\n  );\n}\n\nexport function createTronBuilder(ctx: TronContext): {\n  readonly builder: TxBuilder;\n  readonly broadcaster: Broadcaster;\n} {\n  const { api, codec, config } = ctx;\n  let lastTimestamp = 0;\n\n  const refFields = (head: TronBlockHeader) => ({\n    refBlockBytes: head.id.slice(12, 16),\n    refBlockHash: head.id.slice(16, 32),\n  });\n\n  async function head(signal?: AbortSignal): Promise<TronBlockHeader> {\n    // `block` throws a malformed answer rather than return no head.\n    return (await api.block(\n      'full',\n      undefined,\n      withSignal(READ, signal),\n    )) as TronBlockHeader;\n  }\n\n  /**\n   * The simulated energy of a TRC-20 transfer, after the deprecation and balance checks: a\n   * deprecated token is `ASSET_RESOLUTION`; a shortfall is `INSUFFICIENT_FUNDS`, never a\n   * revert; a token that refuses a transfer its balance allows (a blacklist, say) is\n   * `INVALID_INTENT`.\n   *\n   * Tether's `TetherToken` (USDT) forwards a deprecated contract's `transfer` to its\n   * upgraded contract, which moves the value and emits the `Transfer` event, so the\n   * transfer simulates and executes, and the verdict, which reads the old contract's event,\n   * finds no evidence of it. So `deprecated()` is read beside the balance, once per\n   * estimate (the core estimates before every build), one endpoint's answer as for the\n   * other token reads here, not the proof quorum's: a `true` can only refuse before\n   * signing, the safe direction (as one endpoint's failed simulation already does), and a\n   * wrong `false` leaves the transfer where it was without the guard.\n   */\n  async function tokenEnergy(p: Prepared, signal?: AbortSignal): Promise<bigint> {\n    const tags = withSignal(READ, signal);\n    const token = p.token as string;\n    const [deprecated, available] = await Promise.all([\n      trc20Deprecated(ctx, token, tags),\n      trc20Balance(ctx, token, p.owner, tags),\n    ]);\n    if (deprecated) {\n      throw new ValidationError(\n        'ASSET_RESOLUTION',\n        'the token contract is deprecated in favour of an upgraded contract; the asset must be re-registered at the upgraded contract',\n      );\n    }\n    if (available < p.amount) {\n      throw new ChainError(\n        'INSUFFICIENT_FUNDS',\n        'insufficient token balance for this transfer',\n        { details: { required: p.amount.toString(), available: available.toString() } },\n      );\n    }\n    const data = (p.contract as Extract<TronContract, { type: 'TriggerSmartContract' }>)\n      .data;\n    const call = await api.constantCall(p.owner, token, data, tags);\n    if (call.kind === 'no-contract') {\n      // Its balanceOf just answered: two reads disagree, which decides nothing.\n      throw new ProviderError(\n        'PROVIDER_INCONSISTENT',\n        'the node both holds and lacks this token contract',\n        { retryable: true },\n      );\n    }\n    if (call.kind === 'failed') throw invalid('the token contract refuses this transfer');\n    return call.energy;\n  }\n\n  const builder: TxBuilder = {\n    async estimateFee(intent, build: BuildContext) {\n      const p = prepare(intent);\n      const tags = withSignal(READ, build.signal);\n      const [params, resources, block, recipient, energy] = await Promise.all([\n        api.chainParameters(tags),\n        api.resources(p.owner, tags),\n        head(build.signal),\n        p.token === undefined ? api.account(p.recipient, tags) : undefined,\n        p.token === undefined ? undefined : tokenEnergy(p, build.signal),\n      ]);\n      // Where the chain forbids TRX to a contract, such a transfer is refused before\n      // signing (it would only be refused, stall and expire). Elsewhere it is valid on\n      // chain: the flag is 0 on mainnet, Nile and Shasta.\n      // Known gap: the flag is one endpoint's word, read without a quorum, so a false 1\n      // refuses a valid transfer before signing and a false 0 lets the chain refuse it;\n      // liveness only, never a wrong payment.\n      if (\n        p.token === undefined &&\n        params.forbidTransferToContract &&\n        (await api.contractExists(p.recipient, withSignal(CONFIRMED, build.signal)))\n      ) {\n        throw invalid(\n          'this network refuses TRX sent to a contract (getForbidTransferToContract)',\n        );\n      }\n      // An upper bound of the built size: no expiration jitter, a later timestamp, and the\n      // largest fee limit a build can carry (the ceiling `tronFee` applies).\n      const now = ctx.clock.now();\n      const ceiling = feeLimitCeiling(params, config.maxFeeLimit).value;\n      const provisional = codec.encodeRaw({\n        ...refFields(block),\n        expiration: Math.min(block.timestamp, now) + config.expirationMs,\n        timestamp: Math.max(now + 1_000, lastTimestamp + 1),\n        ...(p.token !== undefined ? { feeLimit: Number(ceiling) } : {}),\n        ...(p.memo !== undefined ? { data: p.memo } : {}),\n        contract: p.contract,\n      });\n      return tronFee({\n        fee: intent.fee,\n        params,\n        resources,\n        bandwidth: bandwidthOf(provisional.length / 2),\n        activation: recipient !== undefined && !recipient.exists,\n        memo: p.memo !== undefined,\n        ...(energy !== undefined ? { energy } : {}),\n        marginPercent: config.energyMarginPercent,\n        maxFeeLimit: config.maxFeeLimit,\n      });\n    },\n\n    async checkFunds(intent, fee, build) {\n      const p = prepare(intent);\n      const tags = withSignal(READ, build.signal);\n      const [account, tokens] = await Promise.all([\n        api.account(p.owner, tags),\n        p.token === undefined ? undefined : trc20Balance(ctx, p.token, p.owner, tags),\n      ]);\n      if (tokens !== undefined && tokens < p.amount) {\n        return { ok: false, asset: intent.asset, required: p.amount, available: tokens };\n      }\n      const required = feeSun(fee) + (p.token === undefined ? p.amount : 0n);\n      // An account that was never activated has no free bandwidth and cannot send.\n      return account.exists && account.balance >= required\n        ? { ok: true }\n        : { ok: false, asset: 'native', required, available: account.balance };\n    },\n\n    async build(intent, fee, build): Promise<UnsignedTx> {\n      const p = prepare(intent);\n      const key = signingKey(build.keys, p.owner);\n      const fees = feeFields(fee, p, config.maxFeeLimit);\n      const block = await head(build.signal);\n      const now = ctx.clock.now();\n      if (now - block.timestamp > config.expirationMs / 2) {\n        throw new ProviderError(\n          'PROVIDER_UNAVAILABLE',\n          'the head block is too old to reference; try again',\n        );\n      }\n      // A head dated more than half the window ahead means a local clock behind\n      // the chain, whose every build would be born expired (and cost a signature per\n      // rebuild), or a lying endpoint. Either way nothing is built on it.\n      if (block.timestamp - now > config.expirationMs / 2) {\n        throw new ProviderError(\n          'PROVIDER_UNAVAILABLE',\n          'the head block is dated ahead of the local clock; check the clock or try again',\n        );\n      }\n      // The reference block's height, from its id (java-tron's block id is the\n      // height's 8 bytes followed by 24 bytes of the header hash, `generateBlockId`): the\n      // same bytes TaPoS reads. A head whose id and number disagree is not a block.\n      const reference = BigInt(`0x${block.id.slice(0, 16)}`);\n      if (reference !== block.number) throw malformed('head block id');\n      const anchor = Math.min(block.timestamp, now);\n      const expiration = anchor + config.expirationMs - jitter();\n      // The window stays within MAX_EXPIRATION_MS, and java-tron wants at least the next\n      // slot. The network config bounds the window; this holds it.\n      if (expiration - anchor > MAX_EXPIRATION_MS) {\n        throw new ConfigError(\n          'CONFIG_INVALID',\n          'the expiration window exceeds the maximum',\n        );\n      }\n      if (expiration - anchor < MIN_EXPIRATION_MS - 1_000) {\n        throw new ConfigError(\n          'CONFIG_INVALID',\n          'the expiration window is below the minimum',\n        );\n      }\n      const timestamp = Math.max(now + jitter(), lastTimestamp + 1);\n      lastTimestamp = timestamp;\n      const raw: TronRawData = {\n        ...refFields(block),\n        expiration,\n        timestamp,\n        ...(fees.feeLimit !== undefined ? { feeLimit: fees.feeLimit } : {}),\n        ...(p.memo !== undefined ? { data: p.memo } : {}),\n        contract: p.contract,\n      };\n      const payload = codec.encodeRaw(raw);\n      // Before anything is signed: the bytes decode strictly to exactly this transfer.\n      let built: TronRawData | undefined;\n      try {\n        built = codec.decodeRaw(payload);\n      } catch {\n        built = undefined;\n      }\n      if (\n        !built ||\n        !carries(built, p) ||\n        built.expiration !== expiration ||\n        built.feeLimit !== raw.feeLimit\n      ) {\n        throw invalid('the built transaction does not carry this transfer');\n      }\n      if (bandwidthOf(payload.length / 2) > fees.bandwidth) {\n        throw invalid(\"the fee estimate does not cover this transaction's bandwidth\");\n      }\n      const txId = toHex(sha256(fromHex(payload)));\n      // The negative proof scans from the reference block to the signed expiration; the\n      // height is the head's claim, so the signed hash bytes go with it, and the proof\n      // trusts the height only where the attested block carries them.\n      const ordering: TronExpiryOrdering = {\n        kind: 'expiry',\n        expiresAtMs: expiration,\n        lastValidHeight: reference + TAPOS_WINDOW,\n        refBlockHash: raw.refBlockHash,\n      };\n      return {\n        payload: { encoding: 'hex', data: payload },\n        expectedRef: { id: txId, idKind: 'tx-hash', canonical: true },\n        signingRequests: [\n          {\n            id: 'r0',\n            scheme: 'secp256k1-ecdsa',\n            payload: fromHex(txId),\n            payloadKind: 'digest',\n            publicKey: key.publicKey,\n            ...(key.keyRef ? { keyRef: key.keyRef } : {}),\n          },\n        ],\n        ordering,\n        fee,\n        summary: {\n          asset: assetId(ctx.chain.id, ctx.network.id, intent.asset),\n          outputs: [{ to: p.to, amount: p.amount.toString() }],\n          ...(intent.memo !== undefined ? { memo: intent.memo } : {}),\n        },\n      };\n    },\n\n    async assemble(unsigned, signatures) {\n      const fail = (message: string) => new SigningError('SIGNING_FAILED', message);\n      const request = unsigned.signingRequests[0];\n      const signature = signatures.find((s) => s.requestId === 'r0');\n      if (\n        !request ||\n        request.id !== 'r0' ||\n        unsigned.signingRequests.length !== 1 ||\n        !signature ||\n        signature.bytes.length !== 64 ||\n        (signature.recovery !== 0 && signature.recovery !== 1)\n      ) {\n        throw fail('missing or malformed signature for request r0');\n      }\n      const mismatch = () => fail('the unsigned payload does not match its txID');\n      if (unsigned.payload.encoding !== 'hex') throw mismatch();\n      let raw: Uint8Array;\n      try {\n        raw = fromHex(unsigned.payload.data);\n      } catch {\n        throw mismatch();\n      }\n      const txId = toHex(sha256(raw));\n      if (txId !== toHex(request.payload) || txId !== unsigned.expectedRef?.id) {\n        throw mismatch();\n      }\n      // The stored bytes decode strictly, and their owner is the signing key's\n      // account, so a signature never authorizes another account's transaction.\n      let decoded: TronRawData;\n      try {\n        decoded = codec.decodeRaw(unsigned.payload.data);\n      } catch {\n        throw fail('the unsigned payload is not a Tron transfer');\n      }\n      let signer: string;\n      try {\n        signer = toHexAddress(addressFromPublicKey(request.publicKey));\n      } catch {\n        throw fail('the signing request has no valid public key');\n      }\n      if (decoded.contract.owner !== signer) {\n        throw fail(\"the payload's owner is not the signing key's account\");\n      }\n      // Only a signature the node will take for the owner's goes out, low s and\n      // recovery bit included, as the core's scheme checks it; a signer fault is a signing\n      // failure here, never a refusal on chain.\n      if (\n        !secp256k1Ecdsa.verify({\n          publicKey: request.publicKey,\n          payload: fromHex(txId),\n          signature: signature.bytes,\n          recovery: signature.recovery,\n        })\n      ) {\n        throw fail('the signature does not verify against the signing key');\n      }\n      // The bytes carry the authorized summary; the proofs read the expiration and the\n      // reference height from the ordering; only the named fee field is read (the core may\n      // add others).\n      const expected = summaryTransfer(ctx, unsigned.summary, signer);\n      const feeLimit = (unsigned.fee.details as Partial<TronFeeDetails>).feeLimit;\n      if (\n        !expected ||\n        !carries(decoded, expected) ||\n        expiresAt(unsigned.ordering) !== decoded.expiration ||\n        !boundToReference(unsigned.ordering, decoded) ||\n        unsigned.fee.kind !== 'tron' ||\n        (expected.token === undefined\n          ? decoded.feeLimit !== undefined\n          : typeof feeLimit !== 'bigint' ||\n            decoded.feeLimit === undefined ||\n            BigInt(decoded.feeLimit) !== feeLimit)\n      ) {\n        throw fail(\n          'the unsigned payload does not match its summary, expiry or fee limit',\n        );\n      }\n      const sig = concatBytes(signature.bytes, Uint8Array.of(27 + signature.recovery));\n      return {\n        raw: { encoding: 'hex', data: toHex(signedTransaction(raw, sig)) },\n        ref: { id: txId, idKind: 'tx-hash', canonical: true },\n      };\n    },\n  };\n\n  const broadcaster: Broadcaster = {\n    async broadcast(signed, options = {}) {\n      const { raw } = signed;\n      if (\n        raw.encoding !== 'hex' ||\n        typeof raw.data !== 'string' ||\n        raw.data.length % 2 !== 0 ||\n        !HEX_DIGITS.test(raw.data)\n      ) {\n        throw new UnsupportedCapabilityError(\n          'UNSUPPORTED_CAPABILITY',\n          'Tron broadcasts take the signed transaction as hex',\n        );\n      }\n      // The broadcast tags carry no quorum: one node's answer is classified, never compared.\n      const hex = raw.data.toLowerCase();\n      const answer = await api.broadcastHex(hex, {\n        ...BROADCAST,\n        ...(options.fanout !== undefined ? { fanout: options.fanout } : {}),\n        ...(options.signal ? { signal: options.signal } : {}),\n      });\n      // Inside the broadcaster, so a possibly-sent throw reaches the engine's recordAmbiguous.\n      // A rejection stands only when its reason holds for these bytes.\n      return classifyOwnBroadcast(answer, txBytesOf(hex));\n    },\n  };\n\n  return { builder, broadcaster };\n}\n"]}

package/dist/adapters/tron/decode.d.ts

@@ -18,11 +18,13 @@
  * stored reason must never hold either.
  */
 import type { DriverTransaction } from '../../core/driver/types';
+import type { TxFailure } from '../../core/model/transaction';
 import { type TronTxInfo, type TronTxJson } from './http';
 import type { TronCodec, TronRawData } from './types';
 export interface TxVerdict {
     readonly success: boolean;
     readonly reason?: string;
+    readonly failure?: TxFailure;
 }
 /**
  * A TRC-20 `transfer(to, …)` counts only if the called token

package/dist/adapters/tron/decode.js

@@ -143,7 +143,7 @@ function verdictOf(codec, tx, info) {
         throw (0, http_1.malformed)('Transfer log');
     return evidence === 'landed'
         ? chain
-        : { success: false, reason: 'token transfer not evidenced' };
+        : { success: false, reason: 'token transfer not evidenced', failure: 'unevidenced' };
 }
 const UTF8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });
 /**

package/dist/adapters/tron/decode.js.map

@@ -1 +1 @@
-{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/adapters/tron/decode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Chain transactions into `DriverTransaction`s, and the verdict of our own transfers.\n * - General decoding (reads, scans, history) reports execution as the chain does: a TRX\n *   transfer is `native`, and so is the TRX a contract call sends; each TRC-20 `Transfer`\n *   log is a `token-event` (`log:<i>`); contract execution is `partial` (value may move\n *   without a log), a failed transaction moved nothing and is `complete`, and a contract\n *   type this model does not carry is `none`.\n * - The verdict of our own Attempts (observe with an ordering, and the proofs) also\n *   requires on-chain evidence that value moved: a TRC-20 `transfer(to, amount)` counts\n *   only with a `Transfer(owner, to, any positive amount)` log from the called contract.\n *   Execution success alone proves nothing: a token can succeed and move nothing, and\n *   USDT on Tron returns a zero word from `transfer`.\n * - Verdict fields are read strictly: a missing, ill-typed or contradicting one\n *   is a malformed answer (retryable), which decides nothing, never a default. Decoding stays\n *   lenient on what the chain accepts: an unknown contract type, a memo of any size or bytes.\n * - `readRaw`'s `timestamp` and `feeLimit` are display only: no verdict or amount uses them.\n * Failure reasons are fixed literals: a node's text can carry addresses or amounts, and a\n * stored reason must never hold either.\n */\nimport type {\n  DriverTransaction,\n  DriverTransfer,\n  DriverTxObservation,\n} from '../../core/driver/types';\nimport { fromHex } from '../../core/util/bytes';\nimport { TRANSFER_TOPIC, decodeTransferCall, decodeTransferLog } from './abi';\nimport { toBase58Address } from './address';\nimport { malformed, notServable, type TronTxInfo, type TronTxJson } from './http';\nimport type { TronCodec, TronContract, TronRawData } from './types';\n\nexport interface TxVerdict {\n  readonly success: boolean;\n  readonly reason?: string;\n}\n\n/** VM receipt results with a reason of their own; any other failure is generic. */\nconst FAILURE_REASONS: ReadonlyMap<string, string> = new Map([\n  ['OUT_OF_ENERGY', 'out of energy'],\n  ['REVERT', 'reverted'],\n]);\n\n/** A contract call that also sends TRX or a TRC-10 token: never a plain TRC-20 transfer. */\nfunction carriesValue(contract: TronContract): boolean {\n  return (\n    contract.type === 'TriggerSmartContract' &&\n    (contract.callValue !== undefined ||\n      contract.callTokenValue !== undefined ||\n      contract.tokenId !== undefined)\n  );\n}\n\n/**\n * The chain's own verdict, from strictly read fields (no evidence check). The VM writes a\n * receipt result for every call it runs (`TransactionTrace.setResult`), `ret[0].contractRet`\n * repeats it, and the info's `FAILED` is set exactly when the call did not succeed\n * (`TransactionUtil.buildTransactionInfoInstance`, GreatVoyage-v4.8.2.2 `d5c3d1d1`). Other\n * contracts carry no receipt result: java-tron never includes one whose execution failed,\n * and blocks from 2018 carry no `ret` at all (mainnet block 2,000,000), so inclusion is\n * their success unless the node reports a failure.\n */\nfunction executed(raw: TronRawData | null, tx: TronTxJson, info: TronTxInfo): TxVerdict {\n  // Bound to the id asked for: another transaction's receipt decides nothing.\n  if (info.id !== tx.id) throw malformed('transaction info');\n  const vm = raw\n    ? raw.contract.type === 'TriggerSmartContract'\n    : info.receiptResult !== undefined;\n  if (vm) {\n    const result = info.receiptResult;\n    if (result === undefined) throw malformed('receipt result');\n    if (tx.contractRet !== undefined && tx.contractRet !== result) {\n      throw malformed('contractRet');\n    }\n    if (result !== 'SUCCESS') {\n      return {\n        success: false,\n        reason: FAILURE_REASONS.get(result) ?? 'contract execution failed',\n      };\n    }\n    if (info.failed) throw malformed('result');\n    return { success: true };\n  }\n  if (info.failed || (tx.contractRet !== undefined && tx.contractRet !== 'SUCCESS')) {\n    return { success: false, reason: 'execution failed' };\n  }\n  return { success: true };\n}\n\ntype Evidence = 'landed' | 'absent' | 'unreadable';\n\n/**\n * What the called token logged for a TRC-20 `transfer(to, …)`. `landed`: a `Transfer`\n * from the sender to that recipient of any positive amount, from the called contract.\n * `unreadable`: nothing landed, and the contract logged a `Transfer` event that does not\n * read as one (its value indexed, say).\n * A call with a value, or with data that is not a canonical `transfer`, is `absent`.\n */\nfunction transferEvidence(raw: TronRawData, info: TronTxInfo): Evidence {\n  const { contract } = raw;\n  if (contract.type !== 'TriggerSmartContract') return 'landed';\n  if (carriesValue(contract)) return 'absent';\n  const call = decodeTransferCall(contract.data);\n  if (call === null) return 'absent';\n  const emitter = contract.contract.slice(2);\n  let unreadable = false;\n  for (const log of info.logs) {\n    if (log.address !== emitter) continue;\n    const event = decodeTransferLog(log);\n    if (event === null) {\n      if (log.topics[0] === TRANSFER_TOPIC) unreadable = true;\n    } else if (\n      event.from === contract.owner &&\n      event.to === call.to &&\n      event.amount > 0n\n    ) {\n      return 'landed';\n    }\n  }\n  return unreadable ? 'unreadable' : 'absent';\n}\n\n/**\n * A TRC-20 `transfer(to, …)` counts only if the called token\n * contract logged a `Transfer` from the sender to that recipient. Any positive amount counts:\n * a fee-on-transfer token (Tron USDT has a dormant fee switch) logs less than the call's\n * amount, and requiring the exact amount would prove a transfer that moved `failed`. A call\n * that also sends TRX or a TRC-10 token, or whose data is not a canonical `transfer`, is never\n * a plain TRC-20 transfer. Decoding reports the amounts that actually moved.\n */\nexport function transferLanded(raw: TronRawData, info: TronTxInfo): boolean {\n  return transferEvidence(raw, info) === 'landed';\n}\n\n/** The chain's own view of an included transaction (no evidence check: not a verdict). */\nexport function chainVerdict(\n  codec: TronCodec,\n  tx: TronTxJson,\n  info: TronTxInfo,\n): TxVerdict {\n  return executed(codec.readRaw(tx.rawHex), tx, info);\n}\n\n/**\n * The verdict of our own included transaction (observe with an ordering, `includedFinal`).\n * The driver built it, so its bytes read, its call is a canonical `transfer` that sends no\n * value, a node's answer for it carries `contractRet`, and a TRX transfer in a block executed;\n * anything else contradicts the signed transaction or the chain's rules and decides nothing\n * (retryable), as does a token `Transfer` event that does not read.\n */\nexport function verdictOf(codec: TronCodec, tx: TronTxJson, info: TronTxInfo): TxVerdict {\n  const raw = codec.readRaw(tx.rawHex);\n  if (raw === null) throw malformed('raw_data_hex');\n  if (tx.contractRet === undefined) throw malformed('contractRet');\n  if (carriesValue(raw.contract)) throw malformed('call value');\n  // An included TransferContract executed (java-tron never includes one that\n  // failed), so any other answer on our own is impossible: a false `failed` on a proof path\n  // would invite a second payment. The chain's view reports what the node says.\n  if (\n    raw.contract.type === 'TransferContract' &&\n    (tx.contractRet !== 'SUCCESS' || info.failed)\n  ) {\n    throw malformed('contractRet');\n  }\n  // Our own TRC-20 call is a canonical `transfer(to, amount)` (the builder\n  // writes nothing else), so other call data contradicts the signed transaction.\n  if (\n    raw.contract.type === 'TriggerSmartContract' &&\n    decodeTransferCall(raw.contract.data) === null\n  ) {\n    throw malformed('call data');\n  }\n  const chain = executed(raw, tx, info);\n  if (!chain.success) return chain;\n  const evidence = transferEvidence(raw, info);\n  if (evidence === 'unreadable') throw malformed('Transfer log');\n  return evidence === 'landed'\n    ? chain\n    : { success: false, reason: 'token transfer not evidenced' };\n}\n\nconst UTF8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });\n\n/**\n * The memo (`raw_data.data`) as text: `undefined` without one, `null` when its bytes are not\n * UTF-8 (replacement characters would make two different memos read the same). Any size the\n * chain accepts reads: the driver's own 256-byte cap applies to what it writes.\n */\nfunction memoOf(raw: TronRawData): string | null | undefined {\n  if (raw.data === undefined) return undefined;\n  try {\n    return UTF8.decode(fromHex(raw.data));\n  } catch {\n    return null;\n  }\n}\n\n/** A canonical `T…` address, or `null` for bytes that are not one (never thrown). */\nfunction base58(hex: string): string | null {\n  try {\n    return toBase58Address(hex);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Any transaction as the chain reports it. `info` and `blockHash` come together for an\n * included transaction; `pending` marks one the node holds in its pool.\n */\nexport function decodeTransaction(\n  codec: TronCodec,\n  tx: TronTxJson,\n  info: TronTxInfo | null,\n  blockHash: string | undefined,\n  pending = false,\n): DriverTransaction {\n  if (info !== null && blockHash === undefined) throw notServable();\n  const raw = codec.readRaw(tx.rawHex);\n  const chain = info ? executed(raw, tx, info) : undefined;\n  const observation: DriverTxObservation =\n    info && chain && blockHash !== undefined\n      ? {\n          seen: 'block',\n          txHash: tx.id,\n          blockHeight: info.blockNumber,\n          blockHash,\n          success: chain.success,\n          ...(chain.reason ? { reason: chain.reason } : {}),\n        }\n      : pending\n        ? { seen: 'mempool', txHash: tx.id }\n        : { seen: 'none' };\n  const memo = raw ? memoOf(raw) : undefined;\n  const owner = raw ? base58(raw.contract.owner) : null;\n  const transfers: DriverTransfer[] = [];\n  let decoding: DriverTransaction['decoding'] = 'complete';\n  /** A movement with the memo; `null` (an address that does not read) is left out. */\n  const add = (transfer: Omit<DriverTransfer, 'memo'> | null): void => {\n    if (!transfer) decoding = 'partial';\n    else transfers.push(typeof memo === 'string' ? { ...transfer, memo } : transfer);\n  };\n  const native = (to: string, amount: bigint) => {\n    const recipient = base58(to);\n    add(\n      owner && recipient\n        ? {\n            locator: 'native',\n            from: [owner],\n            to: recipient,\n            asset: 'native',\n            amount,\n            source: 'native',\n          }\n        : null,\n    );\n  };\n  if (raw === null) {\n    decoding = 'none';\n  } else if (!info) {\n    decoding = 'partial';\n  } else if (chain?.success) {\n    if (memo === null) decoding = 'partial';\n    const { contract } = raw;\n    if (contract.type === 'TransferContract') {\n      native(contract.to, contract.amount);\n    } else {\n      // Value can move without a log (internal transfers), and a TRC-10 value has no asset\n      // here: a contract call is partial.\n      decoding = 'partial';\n      if (contract.callValue !== undefined) native(contract.contract, contract.callValue);\n      info.logs.forEach((log, index) => {\n        const event = decodeTransferLog(log);\n        if (!event) return;\n        const from = base58(event.from);\n        const to = base58(event.to);\n        const token = base58(`41${log.address}`);\n        add(\n          from && to && token\n            ? {\n                locator: `log:${index}`,\n                from: [from],\n                to,\n                asset: { standard: 'trc20', contract: token },\n                amount: event.amount,\n                source: 'token-event',\n              }\n            : null,\n        );\n      });\n    }\n  }\n  const call = raw?.contract.type === 'TriggerSmartContract' ? raw.contract : undefined;\n  return {\n    id: tx.id,\n    observation,\n    ...(info ? { fee: [{ asset: 'native' as const, amount: info.fee }] } : {}),\n    transfers,\n    decoding,\n    // The block's time: the client-set `raw_data.timestamp` is display only.\n    ...(info ? { timestamp: info.blockTimestamp } : {}),\n    details: {\n      contract: raw?.contract.type ?? 'unknown',\n      ...(owner ? { owner } : {}),\n      ...(tx.contractRet !== undefined ? { result: tx.contractRet } : {}),\n      ...(info?.receiptResult !== undefined ? { receipt: info.receiptResult } : {}),\n      ...(raw?.feeLimit !== undefined ? { feeLimit: BigInt(raw.feeLimit) } : {}),\n      ...(call?.callValue !== undefined ? { callValue: call.callValue } : {}),\n      ...(call?.callTokenValue !== undefined\n        ? { callTokenValue: call.callTokenValue }\n        : {}),\n      ...(call?.tokenId !== undefined ? { tokenId: call.tokenId } : {}),\n    },\n  };\n}\n"]}
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/adapters/tron/decode.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Chain transactions into `DriverTransaction`s, and the verdict of our own transfers.\n * - General decoding (reads, scans, history) reports execution as the chain does: a TRX\n *   transfer is `native`, and so is the TRX a contract call sends; each TRC-20 `Transfer`\n *   log is a `token-event` (`log:<i>`); contract execution is `partial` (value may move\n *   without a log), a failed transaction moved nothing and is `complete`, and a contract\n *   type this model does not carry is `none`.\n * - The verdict of our own Attempts (observe with an ordering, and the proofs) also\n *   requires on-chain evidence that value moved: a TRC-20 `transfer(to, amount)` counts\n *   only with a `Transfer(owner, to, any positive amount)` log from the called contract.\n *   Execution success alone proves nothing: a token can succeed and move nothing, and\n *   USDT on Tron returns a zero word from `transfer`.\n * - Verdict fields are read strictly: a missing, ill-typed or contradicting one\n *   is a malformed answer (retryable), which decides nothing, never a default. Decoding stays\n *   lenient on what the chain accepts: an unknown contract type, a memo of any size or bytes.\n * - `readRaw`'s `timestamp` and `feeLimit` are display only: no verdict or amount uses them.\n * Failure reasons are fixed literals: a node's text can carry addresses or amounts, and a\n * stored reason must never hold either.\n */\nimport type {\n  DriverTransaction,\n  DriverTransfer,\n  DriverTxObservation,\n} from '../../core/driver/types';\nimport type { TxFailure } from '../../core/model/transaction';\nimport { fromHex } from '../../core/util/bytes';\nimport { TRANSFER_TOPIC, decodeTransferCall, decodeTransferLog } from './abi';\nimport { toBase58Address } from './address';\nimport { malformed, notServable, type TronTxInfo, type TronTxJson } from './http';\nimport type { TronCodec, TronContract, TronRawData } from './types';\n\nexport interface TxVerdict {\n  readonly success: boolean;\n  readonly reason?: string;\n  readonly failure?: TxFailure;\n}\n\n/** VM receipt results with a reason of their own; any other failure is generic. */\nconst FAILURE_REASONS: ReadonlyMap<string, string> = new Map([\n  ['OUT_OF_ENERGY', 'out of energy'],\n  ['REVERT', 'reverted'],\n]);\n\n/** A contract call that also sends TRX or a TRC-10 token: never a plain TRC-20 transfer. */\nfunction carriesValue(contract: TronContract): boolean {\n  return (\n    contract.type === 'TriggerSmartContract' &&\n    (contract.callValue !== undefined ||\n      contract.callTokenValue !== undefined ||\n      contract.tokenId !== undefined)\n  );\n}\n\n/**\n * The chain's own verdict, from strictly read fields (no evidence check). The VM writes a\n * receipt result for every call it runs (`TransactionTrace.setResult`), `ret[0].contractRet`\n * repeats it, and the info's `FAILED` is set exactly when the call did not succeed\n * (`TransactionUtil.buildTransactionInfoInstance`, GreatVoyage-v4.8.2.2 `d5c3d1d1`). Other\n * contracts carry no receipt result: java-tron never includes one whose execution failed,\n * and blocks from 2018 carry no `ret` at all (mainnet block 2,000,000), so inclusion is\n * their success unless the node reports a failure.\n */\nfunction executed(raw: TronRawData | null, tx: TronTxJson, info: TronTxInfo): TxVerdict {\n  // Bound to the id asked for: another transaction's receipt decides nothing.\n  if (info.id !== tx.id) throw malformed('transaction info');\n  const vm = raw\n    ? raw.contract.type === 'TriggerSmartContract'\n    : info.receiptResult !== undefined;\n  if (vm) {\n    const result = info.receiptResult;\n    if (result === undefined) throw malformed('receipt result');\n    if (tx.contractRet !== undefined && tx.contractRet !== result) {\n      throw malformed('contractRet');\n    }\n    if (result !== 'SUCCESS') {\n      return {\n        success: false,\n        reason: FAILURE_REASONS.get(result) ?? 'contract execution failed',\n      };\n    }\n    if (info.failed) throw malformed('result');\n    return { success: true };\n  }\n  if (info.failed || (tx.contractRet !== undefined && tx.contractRet !== 'SUCCESS')) {\n    return { success: false, reason: 'execution failed' };\n  }\n  return { success: true };\n}\n\ntype Evidence = 'landed' | 'absent' | 'unreadable';\n\n/**\n * What the called token logged for a TRC-20 `transfer(to, …)`. `landed`: a `Transfer`\n * from the sender to that recipient of any positive amount, from the called contract.\n * `unreadable`: nothing landed, and the contract logged a `Transfer` event that does not\n * read as one (its value indexed, say).\n * A call with a value, or with data that is not a canonical `transfer`, is `absent`.\n */\nfunction transferEvidence(raw: TronRawData, info: TronTxInfo): Evidence {\n  const { contract } = raw;\n  if (contract.type !== 'TriggerSmartContract') return 'landed';\n  if (carriesValue(contract)) return 'absent';\n  const call = decodeTransferCall(contract.data);\n  if (call === null) return 'absent';\n  const emitter = contract.contract.slice(2);\n  let unreadable = false;\n  for (const log of info.logs) {\n    if (log.address !== emitter) continue;\n    const event = decodeTransferLog(log);\n    if (event === null) {\n      if (log.topics[0] === TRANSFER_TOPIC) unreadable = true;\n    } else if (\n      event.from === contract.owner &&\n      event.to === call.to &&\n      event.amount > 0n\n    ) {\n      return 'landed';\n    }\n  }\n  return unreadable ? 'unreadable' : 'absent';\n}\n\n/**\n * A TRC-20 `transfer(to, …)` counts only if the called token\n * contract logged a `Transfer` from the sender to that recipient. Any positive amount counts:\n * a fee-on-transfer token (Tron USDT has a dormant fee switch) logs less than the call's\n * amount, and requiring the exact amount would prove a transfer that moved `failed`. A call\n * that also sends TRX or a TRC-10 token, or whose data is not a canonical `transfer`, is never\n * a plain TRC-20 transfer. Decoding reports the amounts that actually moved.\n */\nexport function transferLanded(raw: TronRawData, info: TronTxInfo): boolean {\n  return transferEvidence(raw, info) === 'landed';\n}\n\n/** The chain's own view of an included transaction (no evidence check: not a verdict). */\nexport function chainVerdict(\n  codec: TronCodec,\n  tx: TronTxJson,\n  info: TronTxInfo,\n): TxVerdict {\n  return executed(codec.readRaw(tx.rawHex), tx, info);\n}\n\n/**\n * The verdict of our own included transaction (observe with an ordering, `includedFinal`).\n * The driver built it, so its bytes read, its call is a canonical `transfer` that sends no\n * value, a node's answer for it carries `contractRet`, and a TRX transfer in a block executed;\n * anything else contradicts the signed transaction or the chain's rules and decides nothing\n * (retryable), as does a token `Transfer` event that does not read.\n */\nexport function verdictOf(codec: TronCodec, tx: TronTxJson, info: TronTxInfo): TxVerdict {\n  const raw = codec.readRaw(tx.rawHex);\n  if (raw === null) throw malformed('raw_data_hex');\n  if (tx.contractRet === undefined) throw malformed('contractRet');\n  if (carriesValue(raw.contract)) throw malformed('call value');\n  // An included TransferContract executed (java-tron never includes one that\n  // failed), so any other answer on our own is impossible: a false `failed` on a proof path\n  // would invite a second payment. The chain's view reports what the node says.\n  if (\n    raw.contract.type === 'TransferContract' &&\n    (tx.contractRet !== 'SUCCESS' || info.failed)\n  ) {\n    throw malformed('contractRet');\n  }\n  // Our own TRC-20 call is a canonical `transfer(to, amount)` (the builder\n  // writes nothing else), so other call data contradicts the signed transaction.\n  if (\n    raw.contract.type === 'TriggerSmartContract' &&\n    decodeTransferCall(raw.contract.data) === null\n  ) {\n    throw malformed('call data');\n  }\n  const chain = executed(raw, tx, info);\n  if (!chain.success) return chain;\n  const evidence = transferEvidence(raw, info);\n  if (evidence === 'unreadable') throw malformed('Transfer log');\n  return evidence === 'landed'\n    ? chain\n    : { success: false, reason: 'token transfer not evidenced', failure: 'unevidenced' };\n}\n\nconst UTF8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });\n\n/**\n * The memo (`raw_data.data`) as text: `undefined` without one, `null` when its bytes are not\n * UTF-8 (replacement characters would make two different memos read the same). Any size the\n * chain accepts reads: the driver's own 256-byte cap applies to what it writes.\n */\nfunction memoOf(raw: TronRawData): string | null | undefined {\n  if (raw.data === undefined) return undefined;\n  try {\n    return UTF8.decode(fromHex(raw.data));\n  } catch {\n    return null;\n  }\n}\n\n/** A canonical `T…` address, or `null` for bytes that are not one (never thrown). */\nfunction base58(hex: string): string | null {\n  try {\n    return toBase58Address(hex);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Any transaction as the chain reports it. `info` and `blockHash` come together for an\n * included transaction; `pending` marks one the node holds in its pool.\n */\nexport function decodeTransaction(\n  codec: TronCodec,\n  tx: TronTxJson,\n  info: TronTxInfo | null,\n  blockHash: string | undefined,\n  pending = false,\n): DriverTransaction {\n  if (info !== null && blockHash === undefined) throw notServable();\n  const raw = codec.readRaw(tx.rawHex);\n  const chain = info ? executed(raw, tx, info) : undefined;\n  const observation: DriverTxObservation =\n    info && chain && blockHash !== undefined\n      ? {\n          seen: 'block',\n          txHash: tx.id,\n          blockHeight: info.blockNumber,\n          blockHash,\n          success: chain.success,\n          ...(chain.reason ? { reason: chain.reason } : {}),\n        }\n      : pending\n        ? { seen: 'mempool', txHash: tx.id }\n        : { seen: 'none' };\n  const memo = raw ? memoOf(raw) : undefined;\n  const owner = raw ? base58(raw.contract.owner) : null;\n  const transfers: DriverTransfer[] = [];\n  let decoding: DriverTransaction['decoding'] = 'complete';\n  /** A movement with the memo; `null` (an address that does not read) is left out. */\n  const add = (transfer: Omit<DriverTransfer, 'memo'> | null): void => {\n    if (!transfer) decoding = 'partial';\n    else transfers.push(typeof memo === 'string' ? { ...transfer, memo } : transfer);\n  };\n  const native = (to: string, amount: bigint) => {\n    const recipient = base58(to);\n    add(\n      owner && recipient\n        ? {\n            locator: 'native',\n            from: [owner],\n            to: recipient,\n            asset: 'native',\n            amount,\n            source: 'native',\n          }\n        : null,\n    );\n  };\n  if (raw === null) {\n    decoding = 'none';\n  } else if (!info) {\n    decoding = 'partial';\n  } else if (chain?.success) {\n    if (memo === null) decoding = 'partial';\n    const { contract } = raw;\n    if (contract.type === 'TransferContract') {\n      native(contract.to, contract.amount);\n    } else {\n      // Value can move without a log (internal transfers), and a TRC-10 value has no asset\n      // here: a contract call is partial.\n      decoding = 'partial';\n      if (contract.callValue !== undefined) native(contract.contract, contract.callValue);\n      info.logs.forEach((log, index) => {\n        const event = decodeTransferLog(log);\n        if (!event) return;\n        const from = base58(event.from);\n        const to = base58(event.to);\n        const token = base58(`41${log.address}`);\n        add(\n          from && to && token\n            ? {\n                locator: `log:${index}`,\n                from: [from],\n                to,\n                asset: { standard: 'trc20', contract: token },\n                amount: event.amount,\n                source: 'token-event',\n              }\n            : null,\n        );\n      });\n    }\n  }\n  const call = raw?.contract.type === 'TriggerSmartContract' ? raw.contract : undefined;\n  return {\n    id: tx.id,\n    observation,\n    ...(info ? { fee: [{ asset: 'native' as const, amount: info.fee }] } : {}),\n    transfers,\n    decoding,\n    // The block's time: the client-set `raw_data.timestamp` is display only.\n    ...(info ? { timestamp: info.blockTimestamp } : {}),\n    details: {\n      contract: raw?.contract.type ?? 'unknown',\n      ...(owner ? { owner } : {}),\n      ...(tx.contractRet !== undefined ? { result: tx.contractRet } : {}),\n      ...(info?.receiptResult !== undefined ? { receipt: info.receiptResult } : {}),\n      ...(raw?.feeLimit !== undefined ? { feeLimit: BigInt(raw.feeLimit) } : {}),\n      ...(call?.callValue !== undefined ? { callValue: call.callValue } : {}),\n      ...(call?.callTokenValue !== undefined\n        ? { callTokenValue: call.callTokenValue }\n        : {}),\n      ...(call?.tokenId !== undefined ? { tokenId: call.tokenId } : {}),\n    },\n  };\n}\n"]}

package/dist/adapters/tron/proofs.js

@@ -255,6 +255,7 @@ function createTronProofs(ctx) {
                     blockHash: header.id,
                     txHash: id,
                     ...(verdict.reason !== undefined ? { reason: verdict.reason } : {}),
+                    ...(verdict.failure !== undefined ? { failure: verdict.failure } : {}),
                 };
             }
             const bounds = attemptBounds(ordering);