crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/tron/decode.js

@@ -0,0 +1,280 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transferLanded = transferLanded;
+exports.chainVerdict = chainVerdict;
+exports.verdictOf = verdictOf;
+exports.decodeTransaction = decodeTransaction;
+const bytes_1 = require("../../core/util/bytes");
+const abi_1 = require("./abi");
+const address_1 = require("./address");
+const http_1 = require("./http");
+/** VM receipt results with a reason of their own; any other failure is generic. */
+const FAILURE_REASONS = new Map([
+    ['OUT_OF_ENERGY', 'out of energy'],
+    ['REVERT', 'reverted'],
+]);
+/** A contract call that also sends TRX or a TRC-10 token: never a plain TRC-20 transfer. */
+function carriesValue(contract) {
+    return (contract.type === 'TriggerSmartContract' &&
+        (contract.callValue !== undefined ||
+            contract.callTokenValue !== undefined ||
+            contract.tokenId !== undefined));
+}
+/**
+ * The chain's own verdict, from strictly read fields (no evidence check). The VM writes a
+ * receipt result for every call it runs (`TransactionTrace.setResult`), `ret[0].contractRet`
+ * repeats it, and the info's `FAILED` is set exactly when the call did not succeed
+ * (`TransactionUtil.buildTransactionInfoInstance`, GreatVoyage-v4.8.2.2 `d5c3d1d1`). Other
+ * contracts carry no receipt result: java-tron never includes one whose execution failed,
+ * and blocks from 2018 carry no `ret` at all (mainnet block 2,000,000), so inclusion is
+ * their success unless the node reports a failure.
+ */
+function executed(raw, tx, info) {
+    // Bound to the id asked for: another transaction's receipt decides nothing.
+    if (info.id !== tx.id)
+        throw (0, http_1.malformed)('transaction info');
+    const vm = raw
+        ? raw.contract.type === 'TriggerSmartContract'
+        : info.receiptResult !== undefined;
+    if (vm) {
+        const result = info.receiptResult;
+        if (result === undefined)
+            throw (0, http_1.malformed)('receipt result');
+        if (tx.contractRet !== undefined && tx.contractRet !== result) {
+            throw (0, http_1.malformed)('contractRet');
+        }
+        if (result !== 'SUCCESS') {
+            return {
+                success: false,
+                reason: FAILURE_REASONS.get(result) ?? 'contract execution failed',
+            };
+        }
+        if (info.failed)
+            throw (0, http_1.malformed)('result');
+        return { success: true };
+    }
+    if (info.failed || (tx.contractRet !== undefined && tx.contractRet !== 'SUCCESS')) {
+        return { success: false, reason: 'execution failed' };
+    }
+    return { success: true };
+}
+/**
+ * What the called token logged for a TRC-20 `transfer(to, …)`. `landed`: a `Transfer`
+ * from the sender to that recipient of any positive amount, from the called contract.
+ * `unreadable`: nothing landed, and the contract logged a `Transfer` event that does not
+ * read as one (its value indexed, say).
+ * A call with a value, or with data that is not a canonical `transfer`, is `absent`.
+ */
+function transferEvidence(raw, info) {
+    const { contract } = raw;
+    if (contract.type !== 'TriggerSmartContract')
+        return 'landed';
+    if (carriesValue(contract))
+        return 'absent';
+    const call = (0, abi_1.decodeTransferCall)(contract.data);
+    if (call === null)
+        return 'absent';
+    const emitter = contract.contract.slice(2);
+    let unreadable = false;
+    for (const log of info.logs) {
+        if (log.address !== emitter)
+            continue;
+        const event = (0, abi_1.decodeTransferLog)(log);
+        if (event === null) {
+            if (log.topics[0] === abi_1.TRANSFER_TOPIC)
+                unreadable = true;
+        }
+        else if (event.from === contract.owner &&
+            event.to === call.to &&
+            event.amount > 0n) {
+            return 'landed';
+        }
+    }
+    return unreadable ? 'unreadable' : 'absent';
+}
+/**
+ * A TRC-20 `transfer(to, …)` counts only if the called token
+ * contract logged a `Transfer` from the sender to that recipient. Any positive amount counts:
+ * a fee-on-transfer token (Tron USDT has a dormant fee switch) logs less than the call's
+ * amount, and requiring the exact amount would prove a transfer that moved `failed`. A call
+ * that also sends TRX or a TRC-10 token, or whose data is not a canonical `transfer`, is never
+ * a plain TRC-20 transfer. Decoding reports the amounts that actually moved.
+ */
+function transferLanded(raw, info) {
+    return transferEvidence(raw, info) === 'landed';
+}
+/** The chain's own view of an included transaction (no evidence check: not a verdict). */
+function chainVerdict(codec, tx, info) {
+    return executed(codec.readRaw(tx.rawHex), tx, info);
+}
+/**
+ * The verdict of our own included transaction (observe with an ordering, `includedFinal`).
+ * The driver built it, so its bytes read, its call is a canonical `transfer` that sends no
+ * value, a node's answer for it carries `contractRet`, and a TRX transfer in a block executed;
+ * anything else contradicts the signed transaction or the chain's rules and decides nothing
+ * (retryable), as does a token `Transfer` event that does not read.
+ */
+function verdictOf(codec, tx, info) {
+    const raw = codec.readRaw(tx.rawHex);
+    if (raw === null)
+        throw (0, http_1.malformed)('raw_data_hex');
+    if (tx.contractRet === undefined)
+        throw (0, http_1.malformed)('contractRet');
+    if (carriesValue(raw.contract))
+        throw (0, http_1.malformed)('call value');
+    // An included TransferContract executed (java-tron never includes one that
+    // failed), so any other answer on our own is impossible: a false `failed` on a proof path
+    // would invite a second payment. The chain's view reports what the node says.
+    if (raw.contract.type === 'TransferContract' &&
+        (tx.contractRet !== 'SUCCESS' || info.failed)) {
+        throw (0, http_1.malformed)('contractRet');
+    }
+    // Our own TRC-20 call is a canonical `transfer(to, amount)` (the builder
+    // writes nothing else), so other call data contradicts the signed transaction.
+    if (raw.contract.type === 'TriggerSmartContract' &&
+        (0, abi_1.decodeTransferCall)(raw.contract.data) === null) {
+        throw (0, http_1.malformed)('call data');
+    }
+    const chain = executed(raw, tx, info);
+    if (!chain.success)
+        return chain;
+    const evidence = transferEvidence(raw, info);
+    if (evidence === 'unreadable')
+        throw (0, http_1.malformed)('Transfer log');
+    return evidence === 'landed'
+        ? chain
+        : { success: false, reason: 'token transfer not evidenced' };
+}
+const UTF8 = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });
+/**
+ * The memo (`raw_data.data`) as text: `undefined` without one, `null` when its bytes are not
+ * UTF-8 (replacement characters would make two different memos read the same). Any size the
+ * chain accepts reads: the driver's own 256-byte cap applies to what it writes.
+ */
+function memoOf(raw) {
+    if (raw.data === undefined)
+        return undefined;
+    try {
+        return UTF8.decode((0, bytes_1.fromHex)(raw.data));
+    }
+    catch {
+        return null;
+    }
+}
+/** A canonical `T…` address, or `null` for bytes that are not one (never thrown). */
+function base58(hex) {
+    try {
+        return (0, address_1.toBase58Address)(hex);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Any transaction as the chain reports it. `info` and `blockHash` come together for an
+ * included transaction; `pending` marks one the node holds in its pool.
+ */
+function decodeTransaction(codec, tx, info, blockHash, pending = false) {
+    if (info !== null && blockHash === undefined)
+        throw (0, http_1.notServable)();
+    const raw = codec.readRaw(tx.rawHex);
+    const chain = info ? executed(raw, tx, info) : undefined;
+    const observation = info && chain && blockHash !== undefined
+        ? {
+            seen: 'block',
+            txHash: tx.id,
+            blockHeight: info.blockNumber,
+            blockHash,
+            success: chain.success,
+            ...(chain.reason ? { reason: chain.reason } : {}),
+        }
+        : pending
+            ? { seen: 'mempool', txHash: tx.id }
+            : { seen: 'none' };
+    const memo = raw ? memoOf(raw) : undefined;
+    const owner = raw ? base58(raw.contract.owner) : null;
+    const transfers = [];
+    let decoding = 'complete';
+    /** A movement with the memo; `null` (an address that does not read) is left out. */
+    const add = (transfer) => {
+        if (!transfer)
+            decoding = 'partial';
+        else
+            transfers.push(typeof memo === 'string' ? { ...transfer, memo } : transfer);
+    };
+    const native = (to, amount) => {
+        const recipient = base58(to);
+        add(owner && recipient
+            ? {
+                locator: 'native',
+                from: [owner],
+                to: recipient,
+                asset: 'native',
+                amount,
+                source: 'native',
+            }
+            : null);
+    };
+    if (raw === null) {
+        decoding = 'none';
+    }
+    else if (!info) {
+        decoding = 'partial';
+    }
+    else if (chain?.success) {
+        if (memo === null)
+            decoding = 'partial';
+        const { contract } = raw;
+        if (contract.type === 'TransferContract') {
+            native(contract.to, contract.amount);
+        }
+        else {
+            // Value can move without a log (internal transfers), and a TRC-10 value has no asset
+            // here: a contract call is partial.
+            decoding = 'partial';
+            if (contract.callValue !== undefined)
+                native(contract.contract, contract.callValue);
+            info.logs.forEach((log, index) => {
+                const event = (0, abi_1.decodeTransferLog)(log);
+                if (!event)
+                    return;
+                const from = base58(event.from);
+                const to = base58(event.to);
+                const token = base58(`41${log.address}`);
+                add(from && to && token
+                    ? {
+                        locator: `log:${index}`,
+                        from: [from],
+                        to,
+                        asset: { standard: 'trc20', contract: token },
+                        amount: event.amount,
+                        source: 'token-event',
+                    }
+                    : null);
+            });
+        }
+    }
+    const call = raw?.contract.type === 'TriggerSmartContract' ? raw.contract : undefined;
+    return {
+        id: tx.id,
+        observation,
+        ...(info ? { fee: [{ asset: 'native', amount: info.fee }] } : {}),
+        transfers,
+        decoding,
+        // The block's time: the client-set `raw_data.timestamp` is display only.
+        ...(info ? { timestamp: info.blockTimestamp } : {}),
+        details: {
+            contract: raw?.contract.type ?? 'unknown',
+            ...(owner ? { owner } : {}),
+            ...(tx.contractRet !== undefined ? { result: tx.contractRet } : {}),
+            ...(info?.receiptResult !== undefined ? { receipt: info.receiptResult } : {}),
+            ...(raw?.feeLimit !== undefined ? { feeLimit: BigInt(raw.feeLimit) } : {}),
+            ...(call?.callValue !== undefined ? { callValue: call.callValue } : {}),
+            ...(call?.callTokenValue !== undefined
+                ? { callTokenValue: call.callTokenValue }
+                : {}),
+            ...(call?.tokenId !== undefined ? { tokenId: call.tokenId } : {}),
+        },
+    };
+}
+//# sourceMappingURL=decode.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,12 @@
+/**
+ * The Tron driver factory, for any `TronCodec`: validates the network and options,
+ * configures the identity (block 0's id) and height probes exactly once on every transport it
+ * receives, before any traffic, and assembles the ports. Without probes an endpoint is
+ * never identity-verified, and only verified endpoints feed health heights.
+ * `address-history` needs an indexer transport (TronGrid's `/v1`). This module imports no
+ * SDK: the codec module exports the library's factory (`tronwebDriverFactory`), so there
+ * is no import cycle.
+ */
+import type { DriverFactory } from '../../core/driver/types';
+import type { TronCodec } from './types';
+export declare function tronDriverFactory(codec: TronCodec): DriverFactory;

package/dist/adapters/tron/driver.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tronDriverFactory = tronDriverFactory;
+const address_1 = require("./address");
+const builder_1 = require("./builder");
+const http_1 = require("./http");
+const network_1 = require("./network");
+const proofs_1 = require("./proofs");
+const reader_1 = require("./reader");
+async function blockField(call, path, body) {
+    const answer = await call.http({
+        method: 'POST',
+        path,
+        body,
+        route: path,
+    });
+    const raw = answer?.block_header
+        ?.raw_data;
+    const id = answer?.blockID;
+    const number = raw?.number ?? 0;
+    if (typeof id !== 'string' ||
+        !/^[0-9a-f]{64}$/.test(id) ||
+        !Number.isSafeInteger(number)) {
+        throw (0, http_1.malformed)('probe block');
+    }
+    return { id, number: BigInt(number) };
+}
+function tronDriverFactory(codec) {
+    return {
+        async create(ctx) {
+            const config = (0, network_1.tronNetworkConfig)(ctx.chain, ctx.network, ctx.options);
+            const height = async (call) => (await blockField(call, '/wallet/getblock', { detail: false })).number;
+            // The rpc endpoint must serve the full node, the solidity node and JSON-RPC for one
+            // network; a partial endpoint fails its identity check loudly instead of stalling proofs.
+            // java-tron serves the three from separate HTTP services, so a self-hosted node
+            // needs a reverse proxy that maps all three paths under one URL, as TronGrid does.
+            ctx.transport.setProbes({
+                identity: async (call) => {
+                    const full = (await blockField(call, '/wallet/getblockbynum', { num: 0 })).id;
+                    const solid = (await blockField(call, '/walletsolidity/getblockbynum', { num: 0 })).id;
+                    const rpc = await call.http({
+                        method: 'POST',
+                        path: '/jsonrpc',
+                        route: '/jsonrpc',
+                        body: {
+                            jsonrpc: '2.0',
+                            id: 1,
+                            method: 'eth_getBlockByNumber',
+                            params: ['0x0', false],
+                        },
+                    });
+                    const hash = rpc?.result?.hash;
+                    if (solid !== full ||
+                        typeof hash !== 'string' ||
+                        hash.toLowerCase() !== `0x${full}`) {
+                        throw (0, http_1.malformed)('endpoint services');
+                    }
+                    return full;
+                },
+                expectedIdentity: config.identity,
+                height,
+            });
+            // The indexer (TronGrid's /v1) answers the full-node paths only.
+            ctx.indexer?.setProbes({
+                identity: async (call) => (await blockField(call, '/wallet/getblockbynum', { num: 0 })).id,
+                expectedIdentity: config.identity,
+                height,
+            });
+            const tron = {
+                api: new http_1.TronApi(ctx.transport),
+                codec,
+                chain: ctx.chain,
+                network: ctx.network,
+                config,
+                clock: ctx.clock,
+                log: ctx.log,
+            };
+            const reader = (0, reader_1.createTronReader)(tron);
+            const { builder, broadcaster } = (0, builder_1.createTronBuilder)(tron);
+            const capabilities = new Set(network_1.TRON_CAPABILITIES);
+            if (ctx.indexer)
+                for (const c of network_1.TRON_INDEXER_CAPABILITIES)
+                    capabilities.add(c);
+            const ext = (0, reader_1.createTronExt)(tron);
+            return {
+                ordering: 'expiry',
+                capabilities,
+                address: address_1.tronAddressCodec,
+                reader,
+                builder,
+                broadcaster,
+                proofs: (0, proofs_1.createTronProofs)(tron),
+                blocks: (0, proofs_1.createTronBlocks)(tron),
+                ...(ctx.indexer
+                    ? {
+                        history: (0, proofs_1.createTronHistory)(tron, ctx.indexer, (id) => reader.getTransaction(id)),
+                    }
+                    : {}),
+                ext: { tron: { getResources: ext.tron.getResources } },
+                limits: () => ({ maxOutputs: 1 }),
+                createNativeClient: () => codec.createNative(ctx.transport),
+            };
+        },
+    };
+}
+//# sourceMappingURL=driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/adapters/tron/driver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Tron driver factory, for any `TronCodec`: validates the network and options,\n * configures the identity (block 0's id) and height probes exactly once on every transport it\n * receives, before any traffic, and assembles the ports. Without probes an endpoint is\n * never identity-verified, and only verified endpoints feed health heights.\n * `address-history` needs an indexer transport (TronGrid's `/v1`). This module imports no\n * SDK: the codec module exports the library's factory (`tronwebDriverFactory`), so there\n * is no import cycle.\n */\nimport type { ChainDriver, DriverFactory } from '../../core/driver/types';\nimport type { Capability } from '../../core/model/capability';\nimport type { EndpointCall } from '../../core/transport/types';\nimport { tronAddressCodec } from './address';\nimport { createTronBuilder } from './builder';\nimport { TronApi, malformed } from './http';\nimport {\n  TRON_CAPABILITIES,\n  TRON_INDEXER_CAPABILITIES,\n  tronNetworkConfig,\n} from './network';\nimport { createTronBlocks, createTronHistory, createTronProofs } from './proofs';\nimport { createTronExt, createTronReader, type TronContext } from './reader';\nimport type { TronCodec, TronExt } from './types';\n\nasync function blockField(\n  call: EndpointCall,\n  path: string,\n  body: Record<string, unknown>,\n): Promise<{ readonly id: string; readonly number: bigint }> {\n  const answer = await call.http<Record<string, unknown>>({\n    method: 'POST',\n    path,\n    body,\n    route: path,\n  });\n  const raw = (answer?.block_header as { raw_data?: { number?: unknown } } | undefined)\n    ?.raw_data;\n  const id = answer?.blockID;\n  const number = raw?.number ?? 0;\n  if (\n    typeof id !== 'string' ||\n    !/^[0-9a-f]{64}$/.test(id) ||\n    !Number.isSafeInteger(number)\n  ) {\n    throw malformed('probe block');\n  }\n  return { id, number: BigInt(number as number) };\n}\n\nexport function tronDriverFactory(codec: TronCodec): DriverFactory {\n  return {\n    async create(ctx): Promise<ChainDriver> {\n      const config = tronNetworkConfig(ctx.chain, ctx.network, ctx.options);\n      const height = async (call: EndpointCall) =>\n        (await blockField(call, '/wallet/getblock', { detail: false })).number;\n      // The rpc endpoint must serve the full node, the solidity node and JSON-RPC for one\n      // network; a partial endpoint fails its identity check loudly instead of stalling proofs.\n      // java-tron serves the three from separate HTTP services, so a self-hosted node\n      // needs a reverse proxy that maps all three paths under one URL, as TronGrid does.\n      ctx.transport.setProbes({\n        identity: async (call) => {\n          const full = (await blockField(call, '/wallet/getblockbynum', { num: 0 })).id;\n          const solid = (\n            await blockField(call, '/walletsolidity/getblockbynum', { num: 0 })\n          ).id;\n          const rpc = await call.http<{ result?: { hash?: unknown } } | null>({\n            method: 'POST',\n            path: '/jsonrpc',\n            route: '/jsonrpc',\n            body: {\n              jsonrpc: '2.0',\n              id: 1,\n              method: 'eth_getBlockByNumber',\n              params: ['0x0', false],\n            },\n          });\n          const hash = rpc?.result?.hash;\n          if (\n            solid !== full ||\n            typeof hash !== 'string' ||\n            hash.toLowerCase() !== `0x${full}`\n          ) {\n            throw malformed('endpoint services');\n          }\n          return full;\n        },\n        expectedIdentity: config.identity,\n        height,\n      });\n      // The indexer (TronGrid's /v1) answers the full-node paths only.\n      ctx.indexer?.setProbes({\n        identity: async (call) =>\n          (await blockField(call, '/wallet/getblockbynum', { num: 0 })).id,\n        expectedIdentity: config.identity,\n        height,\n      });\n\n      const tron: TronContext = {\n        api: new TronApi(ctx.transport),\n        codec,\n        chain: ctx.chain,\n        network: ctx.network,\n        config,\n        clock: ctx.clock,\n        log: ctx.log,\n      };\n      const reader = createTronReader(tron);\n      const { builder, broadcaster } = createTronBuilder(tron);\n      const capabilities = new Set<Capability>(TRON_CAPABILITIES);\n      if (ctx.indexer) for (const c of TRON_INDEXER_CAPABILITIES) capabilities.add(c);\n      const ext = createTronExt(tron);\n      return {\n        ordering: 'expiry',\n        capabilities,\n        address: tronAddressCodec,\n        reader,\n        builder,\n        broadcaster,\n        proofs: createTronProofs(tron),\n        blocks: createTronBlocks(tron),\n        ...(ctx.indexer\n          ? {\n              history: createTronHistory(tron, ctx.indexer, (id) =>\n                reader.getTransaction(id),\n              ),\n            }\n          : {}),\n        ext: { tron: { getResources: ext.tron.getResources } } satisfies TronExt,\n        limits: () => ({ maxOutputs: 1 }),\n        createNativeClient: () => codec.createNative(ctx.transport),\n      };\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,74 @@
+/**
+ * Broadcast classification, pure. java-tron answers
+ * `/wallet/broadcasthex` with HTTP 200 and `{ result: false, code, message }`, so the
+ * transport never sees these as errors. The codes, texts and their order are java-tron's
+ * (`Wallet.broadcastTransaction`, `Manager.pushTransaction` and `processTransaction`,
+ * checked against GreatVoyage-v4.8.2.2, `d5c3d1d1`).
+ * - `rejected` only on definitive evidence: the refusal code plus an exact, anchored text
+ *   that consensus also refuses for these bytes on every node at every time — a signature
+ *   under 65 bytes, no contract, a transfer to self, a non-positive amount, or a size over
+ *   the constant 512,000-byte limit (the signature and size rules only for bytes with one
+ *   signature). Numbers in those texts must show the defect: a text that
+ *   contradicts itself decides nothing.
+ * - Refusal codes java-tron gives before it pools the transaction are `refused`, the
+ *   default for any text: account state, permissions, chain parameters and node policy
+ *   can change.
+ * - Node-local codes (busy, not connected, not solidified, "P2P broadcast failed.", which
+ *   java-tron returns after it pooled the transaction), `OTHER_ERROR` (its catch-all, which
+ *   also covers a failure after pooling) and any empty or unknown code are thrown as a
+ *   retryable `PROVIDER_UNAVAILABLE` marked `ambiguous`: possibly sent, even for a bare
+ *   `Blockchain.broadcast` caller.
+ * Nothing here decides from text alone: the code gates every result. Reasons are
+ * fixed literals: no address, amount, transaction id or node text. Every pattern is
+ * anchored and linear, whatever the message's length.
+ *
+ * A node's rejection is a claim. `classifyBroadcast` takes the node at
+ * its word; `classifyOwnBroadcast`, which the broadcaster uses, keeps a `rejected` only when
+ * the claimed reason holds for the bytes that were sent (`txBytesOf`, read with the SDK-free
+ * reader the codec shares, `protobuf.ts`), and makes every other one `refused`, which
+ * is not terminal. A terminal `rejected`
+ * lets a caller pay again, so a lying endpoint that relayed the bytes, or keeps them to relay
+ * later, would make that a second payment. Our builder refuses every byte-only defect before
+ * signing, so a true rejection of our own bytes should not happen; a refusal costs liveness
+ * only, and the expiry proof still ends the Operation.
+ */
+import type { BroadcastResult } from '../../core/driver/types';
+import type { BroadcastAnswer } from './http';
+/**
+ * Our signed transaction as java-tron's byte-only checks read it, from the hex
+ * that was sent.
+ */
+export interface TronTxBytes {
+    /** The serialized `Transaction` without `ret`, which java-tron clears before measuring it. */
+    readonly size: number;
+    /** Each signature's length, in bytes. */
+    readonly signatures: readonly number[];
+    /** How many contracts `raw_data` holds (field 11). */
+    readonly contracts: number;
+    /**
+     * The one contract when it is a TransferContract: its addresses as hex and its amount as
+     * java-tron reads the `int64` (negative above 2^63 − 1; 0 when absent).
+     */
+    readonly transfer?: {
+        readonly owner: string;
+        readonly to: string;
+        readonly amount: bigint;
+    };
+}
+/** The node's answer at its word (see `classifyOwnBroadcast` for our own broadcasts). */
+export declare function classifyBroadcast(answer: BroadcastAnswer): BroadcastResult;
+/**
+ * The node's answer to bytes this driver sent, `sent` being those bytes read by
+ * `txBytesOf` (`undefined` when they do not read). A `rejected` stands only when its claimed
+ * reason holds for `sent`; otherwise the answer is `refused`. Every other answer is the
+ * node's, as `classifyBroadcast` reads it: acceptance, duplicates, state-dependent refusals
+ * (balance, a missing account, bandwidth, TaPoS, expiry, the fee limit) and possibly sent.
+ */
+export declare function classifyOwnBroadcast(answer: BroadcastAnswer, sent: TronTxBytes | undefined): BroadcastResult;
+/**
+ * The bytes a broadcast sent, as the rejection checks read them, SDK-free: `Transaction`
+ * (`raw_data` once, signatures, `ret` entries left out of the size), the contracts in
+ * `raw_data`, and a single TransferContract's fields. `undefined` for hex that does not read
+ * strictly, or is longer than `MAX_READ_BYTES`; no claim holds for it.
+ */
+export declare function txBytesOf(hex: string): TronTxBytes | undefined;