crypto-aio 0.0.2 → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.js","sourceRoot":"","sources":["../../../src/adapters/tron/protobuf.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The protobuf wire reader the Tron family shares: the codec (`codec.ts`) reads\n * chain transactions with it, and the broadcast classifier (`errors.ts`) the bytes it sent.\n * SDK-free, so the classifier never loads tronweb. Linear in the input: each\n * length is checked against the bytes left before it is used, a varint stops at 64 bits,\n * and field number 0, a group or an unknown wire type makes the message unreadable (`null`),\n * as does a truncated field.\n */\n\n/** A varint as a bigint, length-delimited bytes, or `null` for an opaque fixed-width field. */\nexport type WireValue = bigint | Uint8Array | null;\n\nexport interface WireField {\n  readonly field: number;\n  readonly value: WireValue;\n  /** The field's encoded length, tag included. */\n  readonly length: number;\n}\n\n/**\n * What a reader does with a fixed-width field (wire types 1 and 5): `opaque` keeps it as a\n * `null` value, for chain data that may carry fields the reader never reads (the codec);\n * `refuse` makes the message unreadable, for a reader that names every field it accepts\n * (the classifier).\n */\nexport type FixedWidth = 'opaque' | 'refuse';\n\n/** The wire type a known field must have (`singular`). */\nexport type FieldKinds = Readonly<Record<number, 'varint' | 'bytes'>>;\n\n/** One protobuf message's fields, in order; `null` when the bytes do not read. */\nexport function wireFields(bytes: Uint8Array, fixed: FixedWidth): WireField[] | null {\n  const out: WireField[] = [];\n  let i = 0;\n  const varint = (): bigint | null => {\n    let result = 0n;\n    for (let shift = 0n; shift < 64n; shift += 7n) {\n      const byte = bytes[i++];\n      // The tenth byte carries the 64th bit only.\n      if (byte === undefined || (shift === 63n && byte > 1)) return null;\n      result |= BigInt(byte & 0x7f) << shift;\n      if ((byte & 0x80) === 0) return result;\n    }\n    return null;\n  };\n  while (i < bytes.length) {\n    const start = i;\n    const key = varint();\n    if (key === null || key >> 3n === 0n) return null;\n    const wire = key & 7n;\n    let value: WireValue;\n    if (wire === 0n) {\n      value = varint();\n      if (value === null) return null;\n    } else if (wire === 2n) {\n      const length = varint();\n      if (length === null || length > BigInt(bytes.length - i)) return null;\n      value = bytes.subarray(i, i + Number(length));\n      i += Number(length);\n    } else if ((wire === 1n || wire === 5n) && fixed === 'opaque') {\n      i += wire === 1n ? 8 : 4;\n      if (i > bytes.length) return null;\n      value = null;\n    } else {\n      return null;\n    }\n    out.push({ field: Number(key >> 3n), value, length: i - start });\n  }\n  return out;\n}\n\n/**\n * A message whose fields are each singular, by number; `null` when the bytes do not read or\n * a field number repeats, so a value is never guessed between protobuf's merge and last-wins\n * rules. With `kinds`, only the listed fields are accepted, each of its wire type, and a\n * fixed-width field is refused; without, any field is kept and a fixed-width one is opaque.\n */\nexport function singular(\n  bytes: Uint8Array | null,\n  kinds?: FieldKinds,\n): Map<number, WireValue> | null {\n  const fields = bytes ? wireFields(bytes, kinds ? 'refuse' : 'opaque') : null;\n  if (!fields) return null;\n  const out = new Map<number, WireValue>();\n  for (const { field, value } of fields) {\n    if (out.has(field)) return null;\n    if (kinds) {\n      const kind = Object.hasOwn(kinds, field) ? kinds[field] : undefined;\n      if (kind === undefined || (kind === 'varint') !== (typeof value === 'bigint')) {\n        return null;\n      }\n    }\n    out.set(field, value);\n  }\n  return out;\n}\n\n/** A field's bytes, or `null` when it is absent or not length-delimited. */\nexport const bytesOf = (value: WireValue | undefined): Uint8Array | null =>\n  value instanceof Uint8Array ? value : null;\n"]}

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

@@ -0,0 +1,47 @@
+/**
+ * The Tron `ChainReader` and `ext.tron`. Tags follow the `ChainDriver` contract table:
+ * reads `read`, heights and `observe` `monitor`. Addresses reach the node as `41…` hex.
+ * A transaction the node holds but cannot serve whole yet (its receipt, its block) is a
+ * retryable `PROVIDER_UNAVAILABLE`, never "not seen".
+ */
+import type { ChainReader, DriverTxObservation } from '../../core/driver/types';
+import type { Logger } from '../../core/events/logger';
+import type { AssetRef } from '../../core/model/asset';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+import type { Clock } from '../../core/util/clock';
+import { type TronApi } from './http';
+import type { TronNetworkConfig } from './network';
+import type { TronCallTags, TronCodec, TronExt } from './types';
+export interface TronContext {
+    readonly api: TronApi;
+    readonly codec: TronCodec;
+    readonly chain: ChainInfo;
+    readonly network: NetworkInfo;
+    readonly config: TronNetworkConfig;
+    readonly clock: Clock;
+    readonly log: Logger;
+}
+/**
+ * The `41…` hex contract of a TRC-20 ref. `UNSUPPORTED_CAPABILITY` for TRX or another token
+ * standard; `ASSET_RESOLUTION` for a contract that is not a Tron address.
+ */
+export declare function trc20Contract(ref: AssetRef): string;
+/**
+ * A constant call on a token: a revert, a VM failure or no contract is the
+ * token's own permanent problem (`ASSET_RESOLUTION`, cached by the core); node refusals stay
+ * retryable and every other error propagates unchanged. "No contract" is a node's text, so
+ * it counts only once `/wallet/getcontract` confirms it structurally with the same tags; a
+ * node that shows a contract there decides nothing.
+ */
+export declare function tokenCall(ctx: TronContext, owner: string, contract: string, data: string, tags: TronCallTags): Promise<string>;
+/** A holder's TRC-20 balance. */
+export declare function trc20Balance(ctx: TronContext, contract: string, holder: string, tags?: TronCallTags): Promise<bigint>;
+/**
+ * An included transaction's observation. `guard` applies the verdict guard (on-chain
+ * evidence that value moved) to our own Attempts; without it (a status lookup by id,
+ * `ordering === undefined`), the chain's own view is reported.
+ */
+export declare function observeIncluded(ctx: TronContext, id: string, tags: TronCallTags, guard: boolean): Promise<DriverTxObservation | null>;
+export declare function createTronReader(ctx: TronContext): ChainReader;
+/** `ext.tron`, the Tron family extension. */
+export declare function createTronExt(ctx: TronContext): TronExt;

package/dist/adapters/tron/reader.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trc20Contract = trc20Contract;
+exports.tokenCall = tokenCall;
+exports.trc20Balance = trc20Balance;
+exports.observeIncluded = observeIncluded;
+exports.createTronReader = createTronReader;
+exports.createTronExt = createTronExt;
+const error_1 = require("../../core/errors/error");
+const abi_1 = require("./abi");
+const address_1 = require("./address");
+const decode_1 = require("./decode");
+const http_1 = require("./http");
+const TX_ID = /^[0-9a-f]{64}$/;
+/** java-tron's block heights are `long`s. */
+const INT64_MAX = 2n ** 63n - 1n;
+/** A lower-case transaction or block id, or `null` (length checked before any work). */
+function idOf(value) {
+    if (typeof value !== 'string' || value.length !== 64)
+        return null;
+    const id = value.toLowerCase();
+    return TX_ID.test(id) ? id : null;
+}
+/**
+ * Token metadata is read under the proof quorum: the core caches a token's decimals,
+ * symbol and "no such token" for the container's life, so one lagging or buggy endpoint
+ * must not decide them. The constant call's quorum key compares the verdict only, since
+ * honest nodes never agree on its whole answer; endpoints that disagree throw retryable
+ * `PROVIDER_INCONSISTENT`.
+ */
+const METADATA = { ...http_1.READ, quorum: 'proof' };
+function tokenProblem(reason) {
+    return new error_1.ValidationError('ASSET_RESOLUTION', `TRC-20 token unusable: ${reason}`);
+}
+/**
+ * The `41…` hex contract of a TRC-20 ref. `UNSUPPORTED_CAPABILITY` for TRX or another token
+ * standard; `ASSET_RESOLUTION` for a contract that is not a Tron address.
+ */
+function trc20Contract(ref) {
+    if (ref === 'native' || ref.standard !== 'trc20') {
+        throw new error_1.UnsupportedCapabilityError('UNSUPPORTED_CAPABILITY', 'Tron supports TRX and TRC-20 tokens only');
+    }
+    if (!(0, address_1.isTronAddress)(ref.contract))
+        throw tokenProblem('not a Tron contract address');
+    return (0, address_1.toHexAddress)(ref.contract);
+}
+/**
+ * A constant call on a token: a revert, a VM failure or no contract is the
+ * token's own permanent problem (`ASSET_RESOLUTION`, cached by the core); node refusals stay
+ * retryable and every other error propagates unchanged. "No contract" is a node's text, so
+ * it counts only once `/wallet/getcontract` confirms it structurally with the same tags; a
+ * node that shows a contract there decides nothing.
+ */
+async function tokenCall(ctx, owner, contract, data, tags) {
+    const answer = await ctx.api.constantCall(owner, contract, data, tags);
+    if (answer.kind === 'no-contract') {
+        if (await ctx.api.contractExists(contract, tags)) {
+            throw new error_1.ProviderError('PROVIDER_INCONSISTENT', 'the node both holds and lacks this contract', { retryable: true });
+        }
+        throw tokenProblem('no contract at this address');
+    }
+    if (answer.kind === 'failed')
+        throw tokenProblem('the call failed');
+    return answer.result;
+}
+/** A holder's TRC-20 balance. */
+async function trc20Balance(ctx, contract, holder, tags = http_1.READ) {
+    const result = await tokenCall(ctx, (0, address_1.toHexAddress)(holder), contract, (0, abi_1.encodeBalanceOf)(holder), tags);
+    try {
+        return (0, abi_1.decodeUint256)(result);
+    }
+    catch {
+        throw tokenProblem('balanceOf returned no uint256');
+    }
+}
+/**
+ * An included transaction's observation. `guard` applies the verdict guard (on-chain
+ * evidence that value moved) to our own Attempts; without it (a status lookup by id,
+ * `ordering === undefined`), the chain's own view is reported.
+ */
+async function observeIncluded(ctx, id, tags, guard) {
+    const info = await ctx.api.transactionInfo('full', id, tags);
+    if (!info)
+        return null;
+    const [tx, header] = await Promise.all([
+        ctx.api.transaction('full', id, tags),
+        ctx.api.block('full', info.blockNumber, tags),
+    ]);
+    // The node indexed the info but cannot serve the transaction or its block yet: decide
+    // nothing now (the core keeps its current observation on a retryable error).
+    if (!tx || !header)
+        throw (0, http_1.notServable)();
+    const verdict = guard
+        ? (0, decode_1.verdictOf)(ctx.codec, tx, info)
+        : (0, decode_1.chainVerdict)(ctx.codec, tx, info);
+    return {
+        seen: 'block',
+        txHash: id,
+        blockHeight: info.blockNumber,
+        blockHash: header.id,
+        success: verdict.success,
+        ...(verdict.reason ? { reason: verdict.reason } : {}),
+    };
+}
+function createTronReader(ctx) {
+    const { api } = ctx;
+    async function getTransaction(id) {
+        const txId = idOf(id);
+        if (txId === null)
+            return null;
+        const tx = await api.transaction('full', txId, http_1.READ);
+        if (!tx) {
+            const pending = await api.pending(txId, http_1.READ);
+            return pending
+                ? (0, decode_1.decodeTransaction)(ctx.codec, pending, null, undefined, true)
+                : null;
+        }
+        // java-tron serves only included transactions here: without its receipt or its block
+        // the answer is "not yet", never "not seen".
+        const info = await api.transactionInfo('full', txId, http_1.READ);
+        if (!info)
+            throw (0, http_1.notServable)();
+        const header = await api.block('full', info.blockNumber, http_1.READ);
+        if (!header)
+            throw (0, http_1.notServable)();
+        return (0, decode_1.decodeTransaction)(ctx.codec, tx, info, header.id);
+    }
+    return {
+        async getBalance(address, asset) {
+            if (asset === 'native')
+                return (await api.account((0, address_1.toHexAddress)(address), http_1.READ)).balance;
+            return trc20Balance(ctx, trc20Contract(asset), address);
+        },
+        async getBlockHeight() {
+            return (await api.block('full', undefined, http_1.MONITOR)).number;
+        },
+        async getFinalizedHeight() {
+            return (await api.block('solid', undefined, http_1.MONITOR))
+                .number;
+        },
+        async getBlock(ref) {
+            const key = typeof ref === 'string' ? idOf(ref) : ref;
+            if (key === null || (typeof key === 'bigint' && (key < 0n || key > INT64_MAX))) {
+                return null;
+            }
+            const header = await api.block('full', key, http_1.READ);
+            return header
+                ? {
+                    height: header.number,
+                    hash: header.id,
+                    parentHash: header.parentId,
+                    timestamp: header.timestamp,
+                }
+                : null;
+        },
+        getTransaction,
+        async observe(ref, ordering) {
+            const id = idOf(ref.id);
+            if (id === null)
+                return { seen: 'none' };
+            const included = await observeIncluded(ctx, id, http_1.MONITOR, ordering !== undefined);
+            if (included)
+                return included;
+            return (await api.pending(id, http_1.MONITOR)) ? { seen: 'mempool' } : { seen: 'none' };
+        },
+        async getTokenMetadata(ref) {
+            const contract = trc20Contract(ref);
+            // The contract's own account is the caller: it always exists.
+            const decimalsWord = await tokenCall(ctx, contract, contract, abi_1.SELECTORS.decimals, METADATA);
+            const symbolWord = await tokenCall(ctx, contract, contract, abi_1.SELECTORS.symbol, METADATA);
+            let decimals;
+            let symbol;
+            try {
+                decimals = (0, abi_1.decodeUint256)(decimalsWord);
+                symbol = (0, abi_1.decodeString)(symbolWord);
+            }
+            catch {
+                throw tokenProblem('unreadable decimals or symbol');
+            }
+            if (decimals > 255n || symbol.length === 0) {
+                throw tokenProblem('decimals or symbol out of range');
+            }
+            return { symbol, decimals: Number(decimals) };
+        },
+        normalizeTokenRef(ref) {
+            if (ref.standard !== 'trc20') {
+                throw new error_1.ValidationError('ASSET_RESOLUTION', 'Tron tokens use the trc20 standard');
+            }
+            if (!(0, address_1.isTronAddress)(ref.contract))
+                throw tokenProblem('not a Tron contract address');
+            return { standard: 'trc20', contract: (0, address_1.toBase58Address)(ref.contract) };
+        },
+    };
+}
+/** `ext.tron`, the Tron family extension. */
+function createTronExt(ctx) {
+    return {
+        tron: {
+            getResources: (address) => ctx.api.resources((0, address_1.toHexAddress)(address), http_1.READ),
+        },
+    };
+}
+//# sourceMappingURL=reader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/adapters/tron/reader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Tron `ChainReader` and `ext.tron`. Tags follow the `ChainDriver` contract table:\n * reads `read`, heights and `observe` `monitor`. Addresses reach the node as `41…` hex.\n * A transaction the node holds but cannot serve whole yet (its receipt, its block) is a\n * retryable `PROVIDER_UNAVAILABLE`, never \"not seen\".\n */\nimport type {\n  ChainReader,\n  DriverBlock,\n  DriverTransaction,\n  DriverTxObservation,\n} from '../../core/driver/types';\nimport {\n  ProviderError,\n  UnsupportedCapabilityError,\n  ValidationError,\n} from '../../core/errors/error';\nimport type { Logger } from '../../core/events/logger';\nimport type { AssetMetadata, AssetRef, TokenRef } from '../../core/model/asset';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport type { Clock } from '../../core/util/clock';\nimport { SELECTORS, decodeString, decodeUint256, encodeBalanceOf } from './abi';\nimport { isTronAddress, toBase58Address, toHexAddress } from './address';\nimport { chainVerdict, decodeTransaction, verdictOf } from './decode';\nimport { MONITOR, READ, notServable, type TronApi, type TronTxJson } from './http';\nimport type { TronNetworkConfig } from './network';\nimport type { TronCallTags, TronCodec, TronExt, TronResources } from './types';\n\nexport interface TronContext {\n  readonly api: TronApi;\n  readonly codec: TronCodec;\n  readonly chain: ChainInfo;\n  readonly network: NetworkInfo;\n  readonly config: TronNetworkConfig;\n  readonly clock: Clock;\n  readonly log: Logger;\n}\n\nconst TX_ID = /^[0-9a-f]{64}$/;\n/** java-tron's block heights are `long`s. */\nconst INT64_MAX = 2n ** 63n - 1n;\n\n/** A lower-case transaction or block id, or `null` (length checked before any work). */\nfunction idOf(value: string): string | null {\n  if (typeof value !== 'string' || value.length !== 64) return null;\n  const id = value.toLowerCase();\n  return TX_ID.test(id) ? id : null;\n}\n\n/**\n * Token metadata is read under the proof quorum: the core caches a token's decimals,\n * symbol and \"no such token\" for the container's life, so one lagging or buggy endpoint\n * must not decide them. The constant call's quorum key compares the verdict only, since\n * honest nodes never agree on its whole answer; endpoints that disagree throw retryable\n * `PROVIDER_INCONSISTENT`.\n */\nconst METADATA: TronCallTags = { ...READ, quorum: 'proof' };\n\nfunction tokenProblem(reason: string): ValidationError {\n  return new ValidationError('ASSET_RESOLUTION', `TRC-20 token unusable: ${reason}`);\n}\n\n/**\n * The `41…` hex contract of a TRC-20 ref. `UNSUPPORTED_CAPABILITY` for TRX or another token\n * standard; `ASSET_RESOLUTION` for a contract that is not a Tron address.\n */\nexport function trc20Contract(ref: AssetRef): string {\n  if (ref === 'native' || ref.standard !== 'trc20') {\n    throw new UnsupportedCapabilityError(\n      'UNSUPPORTED_CAPABILITY',\n      'Tron supports TRX and TRC-20 tokens only',\n    );\n  }\n  if (!isTronAddress(ref.contract)) throw tokenProblem('not a Tron contract address');\n  return toHexAddress(ref.contract);\n}\n\n/**\n * A constant call on a token: a revert, a VM failure or no contract is the\n * token's own permanent problem (`ASSET_RESOLUTION`, cached by the core); node refusals stay\n * retryable and every other error propagates unchanged. \"No contract\" is a node's text, so\n * it counts only once `/wallet/getcontract` confirms it structurally with the same tags; a\n * node that shows a contract there decides nothing.\n */\nexport async function tokenCall(\n  ctx: TronContext,\n  owner: string,\n  contract: string,\n  data: string,\n  tags: TronCallTags,\n): Promise<string> {\n  const answer = await ctx.api.constantCall(owner, contract, data, tags);\n  if (answer.kind === 'no-contract') {\n    if (await ctx.api.contractExists(contract, tags)) {\n      throw new ProviderError(\n        'PROVIDER_INCONSISTENT',\n        'the node both holds and lacks this contract',\n        { retryable: true },\n      );\n    }\n    throw tokenProblem('no contract at this address');\n  }\n  if (answer.kind === 'failed') throw tokenProblem('the call failed');\n  return answer.result;\n}\n\n/** A holder's TRC-20 balance. */\nexport async function trc20Balance(\n  ctx: TronContext,\n  contract: string,\n  holder: string,\n  tags: TronCallTags = READ,\n): Promise<bigint> {\n  const result = await tokenCall(\n    ctx,\n    toHexAddress(holder),\n    contract,\n    encodeBalanceOf(holder),\n    tags,\n  );\n  try {\n    return decodeUint256(result);\n  } catch {\n    throw tokenProblem('balanceOf returned no uint256');\n  }\n}\n\n/**\n * An included transaction's observation. `guard` applies the verdict guard (on-chain\n * evidence that value moved) to our own Attempts; without it (a status lookup by id,\n * `ordering === undefined`), the chain's own view is reported.\n */\nexport async function observeIncluded(\n  ctx: TronContext,\n  id: string,\n  tags: TronCallTags,\n  guard: boolean,\n): Promise<DriverTxObservation | null> {\n  const info = await ctx.api.transactionInfo('full', id, tags);\n  if (!info) return null;\n  const [tx, header] = await Promise.all([\n    ctx.api.transaction('full', id, tags),\n    ctx.api.block('full', info.blockNumber, tags),\n  ]);\n  // The node indexed the info but cannot serve the transaction or its block yet: decide\n  // nothing now (the core keeps its current observation on a retryable error).\n  if (!tx || !header) throw notServable();\n  const verdict = guard\n    ? verdictOf(ctx.codec, tx, info)\n    : chainVerdict(ctx.codec, tx, info);\n  return {\n    seen: 'block',\n    txHash: id,\n    blockHeight: info.blockNumber,\n    blockHash: header.id,\n    success: verdict.success,\n    ...(verdict.reason ? { reason: verdict.reason } : {}),\n  };\n}\n\nexport function createTronReader(ctx: TronContext): ChainReader {\n  const { api } = ctx;\n\n  async function getTransaction(id: string): Promise<DriverTransaction | null> {\n    const txId = idOf(id);\n    if (txId === null) return null;\n    const tx = await api.transaction('full', txId, READ);\n    if (!tx) {\n      const pending: TronTxJson | null = await api.pending(txId, READ);\n      return pending\n        ? decodeTransaction(ctx.codec, pending, null, undefined, true)\n        : null;\n    }\n    // java-tron serves only included transactions here: without its receipt or its block\n    // the answer is \"not yet\", never \"not seen\".\n    const info = await api.transactionInfo('full', txId, READ);\n    if (!info) throw notServable();\n    const header = await api.block('full', info.blockNumber, READ);\n    if (!header) throw notServable();\n    return decodeTransaction(ctx.codec, tx, info, header.id);\n  }\n\n  return {\n    async getBalance(address, asset) {\n      if (asset === 'native')\n        return (await api.account(toHexAddress(address), READ)).balance;\n      return trc20Balance(ctx, trc20Contract(asset), address);\n    },\n    async getBlockHeight() {\n      return ((await api.block('full', undefined, MONITOR)) as { number: bigint }).number;\n    },\n    async getFinalizedHeight() {\n      return ((await api.block('solid', undefined, MONITOR)) as { number: bigint })\n        .number;\n    },\n    async getBlock(ref): Promise<DriverBlock | null> {\n      const key = typeof ref === 'string' ? idOf(ref) : ref;\n      if (key === null || (typeof key === 'bigint' && (key < 0n || key > INT64_MAX))) {\n        return null;\n      }\n      const header = await api.block('full', key, READ);\n      return header\n        ? {\n            height: header.number,\n            hash: header.id,\n            parentHash: header.parentId,\n            timestamp: header.timestamp,\n          }\n        : null;\n    },\n    getTransaction,\n    async observe(ref, ordering) {\n      const id = idOf(ref.id);\n      if (id === null) return { seen: 'none' };\n      const included = await observeIncluded(ctx, id, MONITOR, ordering !== undefined);\n      if (included) return included;\n      return (await api.pending(id, MONITOR)) ? { seen: 'mempool' } : { seen: 'none' };\n    },\n    async getTokenMetadata(ref: TokenRef): Promise<AssetMetadata> {\n      const contract = trc20Contract(ref);\n      // The contract's own account is the caller: it always exists.\n      const decimalsWord = await tokenCall(\n        ctx,\n        contract,\n        contract,\n        SELECTORS.decimals,\n        METADATA,\n      );\n      const symbolWord = await tokenCall(\n        ctx,\n        contract,\n        contract,\n        SELECTORS.symbol,\n        METADATA,\n      );\n      let decimals: bigint;\n      let symbol: string;\n      try {\n        decimals = decodeUint256(decimalsWord);\n        symbol = decodeString(symbolWord);\n      } catch {\n        throw tokenProblem('unreadable decimals or symbol');\n      }\n      if (decimals > 255n || symbol.length === 0) {\n        throw tokenProblem('decimals or symbol out of range');\n      }\n      return { symbol, decimals: Number(decimals) };\n    },\n    normalizeTokenRef(ref: TokenRef): TokenRef {\n      if (ref.standard !== 'trc20') {\n        throw new ValidationError(\n          'ASSET_RESOLUTION',\n          'Tron tokens use the trc20 standard',\n        );\n      }\n      if (!isTronAddress(ref.contract)) throw tokenProblem('not a Tron contract address');\n      return { standard: 'trc20', contract: toBase58Address(ref.contract) };\n    },\n  };\n}\n\n/** `ext.tron`, the Tron family extension. */\nexport function createTronExt(ctx: TronContext): TronExt {\n  return {\n    tron: {\n      getResources: (address: string): Promise<TronResources> =>\n        ctx.api.resources(toHexAddress(address), READ),\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,7 @@
+/**
+ * Well-known tokens: USDT, which Tether deploys natively on Tron mainnet
+ * (Tether's supported-protocols page); decimals and symbol read from the contract. Circle
+ * lists no Tron USDC, so there is none. The contract is the base58 form, the canonical one.
+ */
+import type { AssetRegistration } from '../../core/registry/assets';
+export declare const TRON_TOKENS: readonly AssetRegistration[];

package/dist/adapters/tron/tokens.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRON_TOKENS = void 0;
+const freeze_1 = require("../../core/util/freeze");
+exports.TRON_TOKENS = (0, freeze_1.deepFreeze)([
+    {
+        chain: 'tron',
+        network: 'mainnet',
+        ref: { standard: 'trc20', contract: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t' },
+        metadata: { symbol: 'USDT', decimals: 6 },
+        aliases: ['USDT'],
+    },
+]);
+//# sourceMappingURL=tokens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/adapters/tron/tokens.ts"],"names":[],"mappings":";;;AAMA,mDAAoD;AAEvC,QAAA,WAAW,GAAiC,IAAA,mBAAU,EAAC;IAClE;QACE,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,oCAAoC,EAAE;QAC1E,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;QACzC,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;CACF,CAAC,CAAC","sourcesContent":["/**\n * Well-known tokens: USDT, which Tether deploys natively on Tron mainnet\n * (Tether's supported-protocols page); decimals and symbol read from the contract. Circle\n * lists no Tron USDC, so there is none. The contract is the base58 form, the canonical one.\n */\nimport type { AssetRegistration } from '../../core/registry/assets';\nimport { deepFreeze } from '../../core/util/freeze';\n\nexport const TRON_TOKENS: readonly AssetRegistration[] = deepFreeze([\n  {\n    chain: 'tron',\n    network: 'mainnet',\n    ref: { standard: 'trc20', contract: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t' },\n    metadata: { symbol: 'USDT', decimals: 6 },\n    aliases: ['USDT'],\n  },\n]);\n"]}

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

@@ -0,0 +1,166 @@
+/**
+ * SDK-free types of the Tron family: the `ext.tron` API, fee details and overrides, the
+ * plain raw-data model the driver builds, and the narrow `TronCodec` strategy that the
+ * tronweb module implements (protobuf serialization and the native client only). Nothing
+ * here imports an SDK, so the composition root can export these types.
+ */
+import type { DisposableNativeClient } from '../../core/driver/types';
+import type { CallOptions, Transport } from '../../core/transport/types';
+declare module '../../index' {
+    interface ChainRegistry {
+        tron: {
+            family: 'tron';
+            network: 'mainnet' | 'shasta' | 'nile';
+        };
+    }
+    interface FamilyRegistry {
+        tron: {
+            library: 'tronweb';
+            ext: TronExt;
+            fee: TronFeeDetails;
+        };
+    }
+}
+/** An account's resources (`ext.tron.getResources`), from `getaccountresource`. */
+export interface TronResources {
+    /** Whether the account exists on chain (it was activated by a first TRX transfer). */
+    readonly activated: boolean;
+    /** Free bandwidth left today, in bytes. */
+    readonly freeBandwidth: bigint;
+    /** Bandwidth left from staked or delegated TRX, in bytes. */
+    readonly stakedBandwidth: bigint;
+    /** Energy left from staked or delegated TRX. */
+    readonly energy: bigint;
+}
+/** `bc.ext.tron`: the Tron family extension. */
+export interface TronExt {
+    readonly tron: {
+        /** The account's bandwidth and energy, as the full node reports them now. */
+        getResources(address: string): Promise<TronResources>;
+    };
+}
+/**
+ * `FeeEstimate.details` of the `tron` fee kind. Sun (1 TRX = 10^6 sun), bytes and energy
+ * units. The charges are upper bounds for the account's resources at estimate time.
+ */
+export interface TronFeeDetails {
+    /** Bandwidth the signed transaction consumes, in bytes (its size plus 64). */
+    readonly bandwidth: bigint;
+    /** The chain's price of one byte of bandwidth, in sun (`getTransactionFee`). */
+    readonly bandwidthPrice: bigint;
+    /** TRC-20 only: the simulated energy plus the safety margin. */
+    readonly energy?: bigint;
+    /** TRC-20 only: the chain's price of one energy unit, in sun (`getEnergyFee`). */
+    readonly energyPrice?: bigint;
+    /**
+     * TRC-20 only: `raw_data.fee_limit`, which caps the energy the call may use:
+     * min(energy × price, the network's maximum, the handle's `maxFeeLimit`).
+     */
+    readonly feeLimit?: bigint;
+    /** A TRX transfer to an address that is not activated yet pays account creation. */
+    readonly activation: boolean;
+}
+/**
+ * An explicit Tron fee (`TransferIntent.fee`): TRC-20 transfers only. `feeLimit` (sun)
+ * replaces the estimated fee limit; it may not be lower than the estimated energy cost,
+ * because a lower cap makes the transaction fail on chain (`OUT_OF_ENERGY`) and still pay,
+ * nor higher than the network's maximum or the handle's `maxFeeLimit` option.
+ */
+export type TronFeeOverride = {
+    readonly feeLimit: bigint;
+};
+/**
+ * The expiry ordering a Tron build records: the signed expiration, and the reference
+ * block the transaction names for TaPoS. `lastValidHeight` is the height the build-time
+ * head claimed plus the TaPoS window (65,536 blocks), so only its low 16 bits are signed
+ * (`ref_block_bytes`); `refBlockHash` is the signed `ref_block_hash`. A proof trusts the
+ * height only when the solidified block there carries `refBlockHash`, because a forged
+ * head can claim a height whose low 16 bits name a block 65,536 lower; otherwise it
+ * searches the heights TaPoS can match. It is a core `expiry` ordering with one more
+ * property, which the core stores whole. A durable store must keep it exact: a changed
+ * hash or height, or a rounded-down `expiresAtMs`, can prove the transfer expired while
+ * a block holds it.
+ */
+export interface TronExpiryOrdering {
+    readonly kind: 'expiry';
+    /** `raw_data.expiration`, in milliseconds: invalid in a block whose parent is at or past it. */
+    readonly expiresAtMs: number;
+    /** The reference block's height (as the build-time head claimed it) plus 65,536. */
+    readonly lastValidHeight: bigint;
+    /** `raw_data.ref_block_hash`: bytes 8..16 of the reference block's id, 16 lower-case hex digits. */
+    readonly refBlockHash: string;
+}
+/**
+ * The transport tags every Tron I/O call carries: purpose, retry, quorum, fanout,
+ * signal, an optional caller `quorumKey` that replaces the path's default consensus key
+ * (for a monotone predicate attested at its own height), and `exactIntegers`,
+ * which `TronApi` always sets: java-tron answers sun and energy as JSON numbers.
+ */
+export type TronCallTags = Pick<CallOptions, 'purpose' | 'retry' | 'quorum' | 'quorumKey' | 'exactIntegers' | 'fanout' | 'signal'>;
+/** A TRX transfer (`TransferContract`); addresses are 21-byte hex with the `41` prefix. */
+export interface TronTransferContract {
+    readonly type: 'TransferContract';
+    readonly owner: string;
+    readonly to: string;
+    /** Sun; at most `Number.MAX_SAFE_INTEGER` (the codec refuses more). */
+    readonly amount: bigint;
+}
+/**
+ * A contract call (`TriggerSmartContract`), e.g. a TRC-20 `transfer`. The driver builds calls
+ * without value; a chain call may also send TRX or a TRC-10 token, which `readRaw` reports
+ * (exactly, and only when non-zero) and `encodeRaw` refuses.
+ */
+export interface TronTriggerContract {
+    readonly type: 'TriggerSmartContract';
+    readonly owner: string;
+    readonly contract: string;
+    /** ABI call data, lower-case hex without `0x`. */
+    readonly data: string;
+    /** Read only: TRX sent to the contract with the call (`call_value`), in sun. */
+    readonly callValue?: bigint;
+    /** Read only: a TRC-10 amount sent with the call (`call_token_value`). */
+    readonly callTokenValue?: bigint;
+    /** Read only: the TRC-10 token id of `callTokenValue` (`token_id`). */
+    readonly tokenId?: bigint;
+}
+export type TronContract = TronTransferContract | TronTriggerContract;
+/** `Transaction.raw` as plain data: what the driver builds and the signer's txID covers. */
+export interface TronRawData {
+    /** Bytes 6..8 of the reference block's id (4 hex digits). */
+    readonly refBlockBytes: string;
+    /** Bytes 8..16 of the reference block's id (16 hex digits). */
+    readonly refBlockHash: string;
+    /** Milliseconds since the epoch; the transaction is invalid in a block whose parent is at or past it. */
+    readonly expiration: number;
+    /** Milliseconds since the epoch, informational. */
+    readonly timestamp: number;
+    /** TRC-20 calls: the energy cap in sun. */
+    readonly feeLimit?: number;
+    /** The memo bytes, lower-case hex; absent when there is no memo. */
+    readonly data?: string;
+    readonly contract: TronContract;
+}
+/**
+ * The SDK part of the Tron driver: protobuf work and the native client. Codec
+ * methods are synchronous and pure; they never perform I/O.
+ */
+export interface TronCodec {
+    readonly library: 'tronweb';
+    /** `Transaction.raw` protobuf bytes as lower-case hex. Throws `ValidationError` on out-of-range values. */
+    encodeRaw(raw: TronRawData): string;
+    /**
+     * Decodes `Transaction.raw` bytes holding exactly one Transfer or TriggerSmartContract.
+     * Throws `ValidationError('INVALID_INTENT')` for anything else.
+     */
+    decodeRaw(hex: string): TronRawData;
+    /**
+     * Lenient reading of any chain transaction's raw bytes (already bound to its txID): the
+     * contract of a Transfer or TriggerSmartContract even with fields this model does not
+     * carry (a call's TRX or TRC-10 value is reported), or `null` for other contract types and
+     * anything unreadable. Display only: `timestamp` (client-set, so it may be rounded or
+     * negative), and `feeLimit` (left out when a number cannot hold it exactly). Never throws.
+     */
+    readRaw(hex: string): TronRawData | null;
+    /** A fresh TronWeb instance whose providers send through `transport`. */
+    createNative(transport: Transport): DisposableNativeClient;
+}

package/dist/adapters/tron/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/tron/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * SDK-free types of the Tron family: the `ext.tron` API, fee details and overrides, the\n * plain raw-data model the driver builds, and the narrow `TronCodec` strategy that the\n * tronweb module implements (protobuf serialization and the native client only). Nothing\n * here imports an SDK, so the composition root can export these types.\n */\nimport type { DisposableNativeClient } from '../../core/driver/types';\nimport type { CallOptions, Transport } from '../../core/transport/types';\n\n// Augment the registries through the package entry, as users do with 'crypto-aio'.\ndeclare module '../../index' {\n  interface ChainRegistry {\n    tron: { family: 'tron'; network: 'mainnet' | 'shasta' | 'nile' };\n  }\n  interface FamilyRegistry {\n    tron: { library: 'tronweb'; ext: TronExt; fee: TronFeeDetails };\n  }\n}\n\n/** An account's resources (`ext.tron.getResources`), from `getaccountresource`. */\nexport interface TronResources {\n  /** Whether the account exists on chain (it was activated by a first TRX transfer). */\n  readonly activated: boolean;\n  /** Free bandwidth left today, in bytes. */\n  readonly freeBandwidth: bigint;\n  /** Bandwidth left from staked or delegated TRX, in bytes. */\n  readonly stakedBandwidth: bigint;\n  /** Energy left from staked or delegated TRX. */\n  readonly energy: bigint;\n}\n\n/** `bc.ext.tron`: the Tron family extension. */\nexport interface TronExt {\n  readonly tron: {\n    /** The account's bandwidth and energy, as the full node reports them now. */\n    getResources(address: string): Promise<TronResources>;\n  };\n}\n\n/**\n * `FeeEstimate.details` of the `tron` fee kind. Sun (1 TRX = 10^6 sun), bytes and energy\n * units. The charges are upper bounds for the account's resources at estimate time.\n */\nexport interface TronFeeDetails {\n  /** Bandwidth the signed transaction consumes, in bytes (its size plus 64). */\n  readonly bandwidth: bigint;\n  /** The chain's price of one byte of bandwidth, in sun (`getTransactionFee`). */\n  readonly bandwidthPrice: bigint;\n  /** TRC-20 only: the simulated energy plus the safety margin. */\n  readonly energy?: bigint;\n  /** TRC-20 only: the chain's price of one energy unit, in sun (`getEnergyFee`). */\n  readonly energyPrice?: bigint;\n  /**\n   * TRC-20 only: `raw_data.fee_limit`, which caps the energy the call may use:\n   * min(energy × price, the network's maximum, the handle's `maxFeeLimit`).\n   */\n  readonly feeLimit?: bigint;\n  /** A TRX transfer to an address that is not activated yet pays account creation. */\n  readonly activation: boolean;\n}\n\n/**\n * An explicit Tron fee (`TransferIntent.fee`): TRC-20 transfers only. `feeLimit` (sun)\n * replaces the estimated fee limit; it may not be lower than the estimated energy cost,\n * because a lower cap makes the transaction fail on chain (`OUT_OF_ENERGY`) and still pay,\n * nor higher than the network's maximum or the handle's `maxFeeLimit` option.\n */\nexport type TronFeeOverride = { readonly feeLimit: bigint };\n\n/**\n * The expiry ordering a Tron build records: the signed expiration, and the reference\n * block the transaction names for TaPoS. `lastValidHeight` is the height the build-time\n * head claimed plus the TaPoS window (65,536 blocks), so only its low 16 bits are signed\n * (`ref_block_bytes`); `refBlockHash` is the signed `ref_block_hash`. A proof trusts the\n * height only when the solidified block there carries `refBlockHash`, because a forged\n * head can claim a height whose low 16 bits name a block 65,536 lower; otherwise it\n * searches the heights TaPoS can match. It is a core `expiry` ordering with one more\n * property, which the core stores whole. A durable store must keep it exact: a changed\n * hash or height, or a rounded-down `expiresAtMs`, can prove the transfer expired while\n * a block holds it.\n */\nexport interface TronExpiryOrdering {\n  readonly kind: 'expiry';\n  /** `raw_data.expiration`, in milliseconds: invalid in a block whose parent is at or past it. */\n  readonly expiresAtMs: number;\n  /** The reference block's height (as the build-time head claimed it) plus 65,536. */\n  readonly lastValidHeight: bigint;\n  /** `raw_data.ref_block_hash`: bytes 8..16 of the reference block's id, 16 lower-case hex digits. */\n  readonly refBlockHash: string;\n}\n\n/**\n * The transport tags every Tron I/O call carries: purpose, retry, quorum, fanout,\n * signal, an optional caller `quorumKey` that replaces the path's default consensus key\n * (for a monotone predicate attested at its own height), and `exactIntegers`,\n * which `TronApi` always sets: java-tron answers sun and energy as JSON numbers.\n */\nexport type TronCallTags = Pick<\n  CallOptions,\n  'purpose' | 'retry' | 'quorum' | 'quorumKey' | 'exactIntegers' | 'fanout' | 'signal'\n>;\n\n/** A TRX transfer (`TransferContract`); addresses are 21-byte hex with the `41` prefix. */\nexport interface TronTransferContract {\n  readonly type: 'TransferContract';\n  readonly owner: string;\n  readonly to: string;\n  /** Sun; at most `Number.MAX_SAFE_INTEGER` (the codec refuses more). */\n  readonly amount: bigint;\n}\n\n/**\n * A contract call (`TriggerSmartContract`), e.g. a TRC-20 `transfer`. The driver builds calls\n * without value; a chain call may also send TRX or a TRC-10 token, which `readRaw` reports\n * (exactly, and only when non-zero) and `encodeRaw` refuses.\n */\nexport interface TronTriggerContract {\n  readonly type: 'TriggerSmartContract';\n  readonly owner: string;\n  readonly contract: string;\n  /** ABI call data, lower-case hex without `0x`. */\n  readonly data: string;\n  /** Read only: TRX sent to the contract with the call (`call_value`), in sun. */\n  readonly callValue?: bigint;\n  /** Read only: a TRC-10 amount sent with the call (`call_token_value`). */\n  readonly callTokenValue?: bigint;\n  /** Read only: the TRC-10 token id of `callTokenValue` (`token_id`). */\n  readonly tokenId?: bigint;\n}\n\nexport type TronContract = TronTransferContract | TronTriggerContract;\n\n/** `Transaction.raw` as plain data: what the driver builds and the signer's txID covers. */\nexport interface TronRawData {\n  /** Bytes 6..8 of the reference block's id (4 hex digits). */\n  readonly refBlockBytes: string;\n  /** Bytes 8..16 of the reference block's id (16 hex digits). */\n  readonly refBlockHash: string;\n  /** Milliseconds since the epoch; the transaction is invalid in a block whose parent is at or past it. */\n  readonly expiration: number;\n  /** Milliseconds since the epoch, informational. */\n  readonly timestamp: number;\n  /** TRC-20 calls: the energy cap in sun. */\n  readonly feeLimit?: number;\n  /** The memo bytes, lower-case hex; absent when there is no memo. */\n  readonly data?: string;\n  readonly contract: TronContract;\n}\n\n/**\n * The SDK part of the Tron driver: protobuf work and the native client. Codec\n * methods are synchronous and pure; they never perform I/O.\n */\nexport interface TronCodec {\n  readonly library: 'tronweb';\n  /** `Transaction.raw` protobuf bytes as lower-case hex. Throws `ValidationError` on out-of-range values. */\n  encodeRaw(raw: TronRawData): string;\n  /**\n   * Decodes `Transaction.raw` bytes holding exactly one Transfer or TriggerSmartContract.\n   * Throws `ValidationError('INVALID_INTENT')` for anything else.\n   */\n  decodeRaw(hex: string): TronRawData;\n  /**\n   * Lenient reading of any chain transaction's raw bytes (already bound to its txID): the\n   * contract of a Transfer or TriggerSmartContract even with fields this model does not\n   * carry (a call's TRX or TRC-10 value is reported), or `null` for other contract types and\n   * anything unreadable. Display only: `timestamp` (client-set, so it may be rounded or\n   * negative), and `feeLimit` (left out when a number cannot hold it exactly). Never throws.\n   */\n  readRaw(hex: string): TronRawData | null;\n  /** A fresh TronWeb instance whose providers send through `transport`. */\n  createNative(transport: Transport): DisposableNativeClient;\n}\n"]}

package/dist/adapters/utxo/address.d.ts

@@ -0,0 +1,51 @@
+import type { AddressParams, UtxoAddressType, UtxoOutputType } from './types';
+export type { AddressParams } from './types';
+export interface DecodedAddress {
+    readonly type: UtxoOutputType;
+    /** Lowercase bech32, or the base58 string as given. */
+    readonly canonical: string;
+    readonly script: Uint8Array;
+}
+export declare const hash160: (data: Uint8Array) => Uint8Array;
+/** The standard output script of each type; the program must have that type's length. */
+export declare function outputScript(type: UtxoOutputType, program: Uint8Array): Uint8Array;
+/** Whether 32 bytes are the x coordinate of a curve point (BIP340 `lift_x`). */
+export declare function isXOnlyPoint(bytes: Uint8Array): boolean;
+/** Decodes an address of this network; throws `INVALID_ADDRESS`. */
+export declare function decodeAddress(address: string, params: AddressParams): DecodedAddress;
+/**
+ * The address an output script pays on this network: the inverse of `outputScript` for the
+ * five standard types, as `decodeAddress` returns it. Any other script (a bare key or
+ * multisig, a data carrier, a future witness version or program length) has no address, and
+ * neither has a taproot key off the curve, which `decodeAddress` refuses.
+ */
+export declare function addressFromScript(script: Uint8Array, params: AddressParams): DecodedAddress | undefined;
+/** BIP341/BIP86 key-path tweak of an internal key with no script tree. */
+export declare function taprootTweak(internalKey: Uint8Array): {
+    readonly tweak: Uint8Array;
+    readonly outputKey: Uint8Array;
+};
+export interface WalletAddress {
+    readonly address: string;
+    readonly type: UtxoAddressType;
+    readonly script: Uint8Array;
+    /** The key the wallet signs with: compressed (ECDSA) or x-only internal key (p2tr). */
+    readonly publicKey: Uint8Array;
+    /** p2sh-p2wpkh: the redeem script pushed in the scriptSig. */
+    readonly redeemScript?: Uint8Array;
+    /** p2tr: the BIP341 tweak and the tweaked output key the signature verifies against. */
+    readonly tweak?: Uint8Array;
+    readonly outputKey?: Uint8Array;
+}
+/** The wallet address of `type` for this public key. */
+export declare function walletAddress(publicKey: Uint8Array, type: UtxoAddressType, params: AddressParams): WalletAddress;
+/** The wallet address type a sending address implies (a p2sh wallet is p2sh-p2wpkh). */
+export declare function walletTypeOf(decoded: DecodedAddress): UtxoAddressType;
+/** The byte length of Bitcoin's CompactSize encoding of `n` (a count or a length). */
+export declare const compactSize: (n: number) => number;
+/**
+ * Bitcoin Core's `GetDustThreshold` (policy.cpp) at `dustRelayFee` sat/kvB, rounded up.
+ * An unspendable script (`IsUnspendable`: OP_RETURN first, or over `MAX_SCRIPT_SIZE`) has
+ * no dust threshold.
+ */
+export declare function dustThreshold(script: Uint8Array, dustRelayFee: bigint): bigint;