@getomnichain/omnichain 0.2.0 → 0.3.0

package/dist/cjs/abstract_gas_pricing.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractGasPricing = void 0;
+exports.isAbstractGasPricing = isAbstractGasPricing;
+/**
+ * Base for chain-specific *explicit* fee overrides — mirrors Python's
+ * `AbstractGasPricing(pydantic.BaseModel)` at `base/base.py:141-158`.
+ * A subclass declares its `networkType` and carries the concrete fee
+ * fields for that chain (`EvmGasPricing`, `SolanaGasPricing`,
+ * `UtxoGasPricing`).
+ *
+ * A caller who wants exact numeric control passes an `AbstractGasPricing`
+ * subclass to `createTransferUnsignedTransaction`; passing a
+ * `FeePriority` tier (SLOW/NORMAL/FAST) instead defers to each chain's
+ * `suggest*` estimator. See `GasPricingType`.
+ */
+class AbstractGasPricing {
+}
+exports.AbstractGasPricing = AbstractGasPricing;
+/**
+ * Runtime discriminator for `GasPricingType`. `FeePriority` is a
+ * string enum; `AbstractGasPricing` is a class instance.
+ */
+function isAbstractGasPricing(value) {
+    return value instanceof AbstractGasPricing;
+}
+//# sourceMappingURL=abstract_gas_pricing.js.map

package/dist/cjs/abstract_gas_pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract_gas_pricing.js","sourceRoot":"","sources":["../../abstract_gas_pricing.ts"],"names":[],"mappings":";;;AAgCA,oDAEC;AA/BD;;;;;;;;;;;GAWG;AACH,MAAsB,kBAAkB;CAEvC;AAFD,gDAEC;AAWD;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,KAAqB;IACxD,OAAO,KAAK,YAAY,kBAAkB,CAAC;AAC7C,CAAC"}

package/dist/cjs/address.factory.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addressFor = addressFor;
+exports.canonicalizeAddress = canonicalizeAddress;
+exports.tryCanonicalizeAddress = tryCanonicalizeAddress;
+exports.canonicalizeAddressStrict = canonicalizeAddressStrict;
+const errors_ts_1 = require("./errors.js");
+const network_type_ts_1 = require("./network_type.js");
+const evm_address_ts_1 = require("./evm/evm_address.js");
+const solana_address_ts_1 = require("./solana/solana_address.js");
+const ton_address_ts_1 = require("./ton/ton_address.js");
+const btc_address_ts_1 = require("./utxo/btc/btc_address.js");
+const network_params_ts_1 = require("./utxo/btc/network_params.js");
+function addressFor(chainId, raw) {
+    const family = (0, network_type_ts_1.networkTypeOf)(chainId);
+    switch (family) {
+        case network_type_ts_1.NetworkType.EVM:
+            return new evm_address_ts_1.EvmAddress(raw);
+        case network_type_ts_1.NetworkType.SOLANA:
+            return new solana_address_ts_1.SolanaAddress(raw);
+        case network_type_ts_1.NetworkType.BTC:
+            return new btc_address_ts_1.BtcAddress(raw, (0, network_params_ts_1.btcParamsForChainId)(BigInt(chainId)));
+        case network_type_ts_1.NetworkType.TON:
+            return new ton_address_ts_1.TonAddress(raw);
+        // TRON / COSMOS have no in-repo Address class yet. Rather than fall through
+        // to EvmAddress (which would silently accept a valid EVM address for a
+        // Tron chain and un-canonicalize base58 T… addresses), fail closed until
+        // the concrete implementations land.
+        case network_type_ts_1.NetworkType.TRON:
+        case network_type_ts_1.NetworkType.COSMOS:
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.ChainNotSupported, `${family} address parsing is not implemented for chainId ${chainId}`, { chainId });
+        default: {
+            // Exhaustiveness guard — a new NetworkType value should force this
+            // switch to be updated rather than fall through to EVM.
+            const exhaustive = family;
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.ChainNotSupported, `Unhandled NetworkType ${String(exhaustive)} for chainId ${chainId}`, { chainId });
+        }
+    }
+}
+function canonicalizeAddress(chainId, raw) {
+    return addressFor(chainId, raw).canonical();
+}
+/**
+ * Total function — never throws. Returns the raw input on any failure
+ * (address-format error, unsupported chain, malformed args).
+ *
+ * Callers that need to fail loudly on stale/unsupported chainIds while
+ * still tolerating address-format errors should use
+ * `canonicalizeAddressStrict` instead.
+ */
+function tryCanonicalizeAddress(chainId, raw) {
+    try {
+        return canonicalizeAddress(chainId, raw);
+    }
+    catch {
+        return raw;
+    }
+}
+/**
+ * Swallows address-format errors (returns raw input) but re-throws
+ * `ChainError(ChainNotSupported)` so a stale chainId (e.g. un-migrated
+ * legacy Solana `-100`) fails loudly rather than passing a bogus routing
+ * signal downstream. Use in application code where an unsupported chain
+ * is a hard error the caller wants to surface, and address-format
+ * errors are reported by a separate validation layer.
+ *
+ * NOT for class-transformer `@Transform` callbacks — a throw there also
+ * fires during response serialization when an entity carries a stale
+ * chainId, killing every read of a legacy row.
+ */
+function canonicalizeAddressStrict(chainId, raw) {
+    try {
+        return canonicalizeAddress(chainId, raw);
+    }
+    catch (e) {
+        if ((0, errors_ts_1.isChainError)(e, errors_ts_1.ChainErrorKinds.ChainNotSupported))
+            throw e;
+        return raw;
+    }
+}
+//# sourceMappingURL=address.factory.js.map

package/dist/cjs/address.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.factory.js","sourceRoot":"","sources":["../../address.factory.ts"],"names":[],"mappings":";;AAUA,gCAiCC;AAED,kDAEC;AAUD,wDAMC;AAcD,8DAOC;AApFD,2CAAwE;AACxE,uDAA+D;AAG/D,yDAAkD;AAClD,kEAA2D;AAC3D,yDAAkD;AAClD,8DAAuD;AACvD,oEAAmE;AAEnE,SAAgB,UAAU,CAAC,OAAe,EAAE,GAAW;IACrD,MAAM,MAAM,GAAG,IAAA,+BAAa,EAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,6BAAW,CAAC,GAAG;YAClB,OAAO,IAAI,2BAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,KAAK,6BAAW,CAAC,MAAM;YACrB,OAAO,IAAI,iCAAa,CAAC,GAAG,CAAC,CAAC;QAChC,KAAK,6BAAW,CAAC,GAAG;YAClB,OAAO,IAAI,2BAAU,CAAC,GAAG,EAAE,IAAA,uCAAmB,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnE,KAAK,6BAAW,CAAC,GAAG;YAClB,OAAO,IAAI,2BAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,4EAA4E;QAC5E,uEAAuE;QACvE,yEAAyE;QACzE,qCAAqC;QACrC,KAAK,6BAAW,CAAC,IAAI,CAAC;QACtB,KAAK,6BAAW,CAAC,MAAM;YACrB,MAAM,IAAI,sBAAU,CAClB,2BAAe,CAAC,iBAAiB,EACjC,GAAG,MAAM,mDAAmD,OAAO,EAAE,EACrE,EAAE,OAAO,EAAE,CACZ,CAAC;QACJ,OAAO,CAAC,CAAC,CAAC;YACR,mEAAmE;YACnE,wDAAwD;YACxD,MAAM,UAAU,GAAU,MAAM,CAAC;YACjC,MAAM,IAAI,sBAAU,CAClB,2BAAe,CAAC,iBAAiB,EACjC,yBAAyB,MAAM,CAAC,UAAU,CAAC,gBAAgB,OAAO,EAAE,EACpE,EAAE,OAAO,EAAE,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAe,EAAE,GAAW;IAC9D,OAAO,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CAAC,OAAe,EAAE,GAAW;IACjE,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,yBAAyB,CAAC,OAAe,EAAE,GAAW;IACpE,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,IAAA,wBAAY,EAAC,CAAC,EAAE,2BAAe,CAAC,iBAAiB,CAAC;YAAE,MAAM,CAAC,CAAC;QAChE,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/cjs/address.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Address = void 0;
+class Address {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    equals(other) {
+        return (this.networkType === other.networkType && this.canonical() === other.canonical());
+    }
+    toString() {
+        return this.canonical();
+    }
+}
+exports.Address = Address;
+//# sourceMappingURL=address.js.map

package/dist/cjs/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../address.ts"],"names":[],"mappings":";;;AAEA,MAAsB,OAAO;IACc;IAAzC,YAAyC,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAKxD,MAAM,CAAC,KAAc;QACnB,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,KAAK,CAAC,SAAS,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;CACF;AAfD,0BAeC"}

package/dist/cjs/address_field.decorator.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressField = AddressField;
+const class_transformer_1 = require("class-transformer");
+const address_factory_ts_1 = require("./address.factory.js");
+const is_address_decorator_ts_1 = require("./is_address.decorator.js");
+/**
+ * Combines a `class-transformer` `@Transform` that canonicalizes the address
+ * value with an `@IsAddress` validator.
+ *
+ * The transform uses `tryCanonicalizeAddress` — a total function that
+ * swallows **every** failure (including `ChainNotSupported`) and returns the
+ * raw input. `@IsAddress` is the sole reporter of the failure at DTO
+ * validation time. This is deliberate: a `@Transform` also runs during
+ * `instanceToPlain` (response serialization), and a throw there would fail
+ * every read of a legacy-chainId entity row.
+ *
+ * For application code outside a class-transformer boundary that wants
+ * `ChainNotSupported` to fail loud (e.g. a service layer processing a
+ * migration queue), use `canonicalizeAddressStrict` instead.
+ */
+function AddressField(chainIdProperty) {
+    const transform = (0, class_transformer_1.Transform)(({ obj, value }) => {
+        if (typeof value !== 'string')
+            return value;
+        const chainId = obj[chainIdProperty];
+        if (typeof chainId !== 'number')
+            return value;
+        return (0, address_factory_ts_1.tryCanonicalizeAddress)(chainId, value);
+    });
+    const validate = (0, is_address_decorator_ts_1.IsAddress)(chainIdProperty);
+    return (target, propertyKey) => {
+        transform(target, propertyKey);
+        validate(target, propertyKey);
+    };
+}
+//# sourceMappingURL=address_field.decorator.js.map

package/dist/cjs/address_field.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address_field.decorator.js","sourceRoot":"","sources":["../../address_field.decorator.ts"],"names":[],"mappings":";;AAoBA,oCAYC;AAhCD,yDAA8C;AAE9C,6DAA8D;AAC9D,uEAAsD;AAEtD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,YAAY,CAAC,eAAuB;IAClD,MAAM,SAAS,GAAG,IAAA,6BAAS,EAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,MAAM,OAAO,GAAI,GAA+B,CAAC,eAAe,CAAC,CAAC;QAClE,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,OAAO,IAAA,2CAAsB,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAA,mCAAS,EAAC,eAAe,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC/B,QAAQ,CAAC,MAAM,EAAE,WAAqB,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/chain.base.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chain = void 0;
+exports.resolveTransferAmount = resolveTransferAmount;
+const decimal_js_1 = require("decimal.js");
+const errors_ts_1 = require("./errors.js");
+const transaction_status_ts_1 = require("./transaction_status.js");
+/**
+ * Validates that exactly one of `{amount, amountHr, isFullBalance}` was
+ * supplied and normalizes to a common shape the chain builders consume.
+ * Chain-agnostic — the caller supplies `decimals` (from the resolved
+ * token). Rounds `amountHr` via `Decimal.trunc()` matching Python's
+ * `hr_to_mr`.
+ *
+ * Non-integer decimals / negative amount / etc. throw
+ * `ChainError(InvalidArgument)`.
+ */
+function resolveTransferAmount(req, decimals) {
+    // Upfront typeof gate for isFullBalance — silently coercing a non-boolean
+    // to "unset" here would let `{amount, isFullBalance: 'true'}` (JSON boundary
+    // realistic) take the amount branch instead of failing the exactly-one-of.
+    if (req.isFullBalance !== undefined && typeof req.isFullBalance !== 'boolean') {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.isFullBalance must be a boolean (got ${typeof req.isFullBalance})`);
+    }
+    const provided = [];
+    if (req.amount !== undefined)
+        provided.push('amount');
+    if (req.amountHr !== undefined)
+        provided.push('amountHr');
+    if (req.isFullBalance === true)
+        provided.push('isFullBalance');
+    if (provided.length === 0) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, 'CreateTransferRequest: one of {amount, amountHr, isFullBalance} is required');
+    }
+    if (provided.length > 1) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest: exactly one of {amount, amountHr, isFullBalance} may be set (got ${provided.join(', ')})`);
+    }
+    if (req.isFullBalance === true)
+        return { kind: 'full' };
+    if (req.amount !== undefined) {
+        // Explicit typeof check: JS mixed-type comparison lets '1000000' <= 0n
+        // return false (`StringToBigInt`), so a string/number amount would
+        // otherwise pass this guard and land verbatim in tx.value /
+        // lamports / ERC-20 calldata. Realistic vector: consumers
+        // deserializing amounts from HTTP/DB JSON.
+        if (typeof req.amount !== 'bigint') {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.amount must be a bigint (got ${typeof req.amount})`);
+        }
+        if (req.amount <= 0n) {
+            throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.amount must be > 0, got ${req.amount}`);
+        }
+        return { kind: 'exact', amountMr: req.amount };
+    }
+    // amountHr branch. Cross-copy-safe structural probe: `instanceof
+    // Decimal` and `Decimal.isDecimal` both key off constructor identity
+    // in practice (isDecimal's toStringTag branch is dead against the
+    // shipped prototype), so a `Decimal` from a nested/duplicated copy of
+    // decimal.js in the consumer tree would falsely reject. Instead:
+    // probe for the two methods we actually need (`toFixed`, `isFinite`),
+    // then normalize via `Decimal.prototype.toString` — an exact,
+    // always-reparseable serialization — into our own Decimal instance.
+    const rawHr = req.amountHr;
+    if (rawHr === null ||
+        typeof rawHr !== 'object' ||
+        typeof rawHr.toFixed !== 'function' ||
+        typeof rawHr.isFinite !== 'function' ||
+        typeof rawHr.toString !== 'function') {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, 'CreateTransferRequest.amountHr must be a Decimal value (structural probe: needs toFixed + isFinite + toString)');
+    }
+    let hr;
+    try {
+        hr = new decimal_js_1.Decimal(rawHr.toString());
+    }
+    catch (err) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, 'CreateTransferRequest.amountHr: string round-trip failed', undefined, err instanceof Error ? err : undefined);
+    }
+    if (!hr.isFinite()) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.amountHr must be finite, got ${hr.toString()}`);
+    }
+    if (!Number.isInteger(decimals) || decimals < 0) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.amountHr requires a non-negative integer decimals, got ${decimals}`);
+    }
+    if (hr.isNegative()) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.amountHr must be >= 0, got ${hr.toString()}`);
+    }
+    // Exact conversion via string-shift (bypasses decimal.js's 20-sig-digit
+    // precision limit that would silently round the last wei on 18-decimal
+    // amounts ≥ ~100 tokens).
+    const amountMr = (0, transaction_status_ts_1.hrDecimalToMinorUnits)(hr, decimals);
+    if (amountMr <= 0n) {
+        throw new errors_ts_1.ChainError(errors_ts_1.ChainErrorKinds.InvalidArgument, `CreateTransferRequest.amountHr must convert to > 0 minor units, got ${amountMr} (from ${hr.toString()} @ ${decimals} decimals)`);
+    }
+    return { kind: 'exact', amountMr };
+}
+class Chain {
+    chainId;
+    name;
+    networkType;
+    blockTimeSeconds;
+    nativeSymbol;
+    explorerBaseUrl;
+    constructor(chainId, name, networkType, blockTimeSeconds, nativeSymbol, explorerBaseUrl) {
+        if (!Number.isInteger(chainId)) {
+            throw new Error('Chain chainId must be an integer');
+        }
+        this.chainId = chainId;
+        this.name = name;
+        this.networkType = networkType;
+        this.blockTimeSeconds = blockTimeSeconds;
+        this.nativeSymbol = nativeSymbol;
+        this.explorerBaseUrl = explorerBaseUrl.replace(/\/$/, '');
+    }
+    toString() {
+        return `Chain[chainId=${this.chainId}, name=${this.name}, networkType=${this.networkType}]`;
+    }
+}
+exports.Chain = Chain;
+//# sourceMappingURL=chain.base.js.map

package/dist/cjs/chain.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.base.js","sourceRoot":"","sources":["../../chain.base.ts"],"names":[],"mappings":"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"}

package/dist/cjs/chain_ids.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Chain ID constants — mirrors omnichain-py/src/omnichain/chain_ids.py.
+ * Source of truth: https://github.com/getomnichain/omnichain-py
+ *
+ * EVM chain IDs are the canonical EIP-155 numbers.
+ * Non-EVM chains use synthetic negative IDs (Python convention) so a single
+ * `number` fits every chain and the sign disambiguates families.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHAIN_ID_HYPER_EVM = exports.CHAIN_ID_STABLE = exports.CHAIN_ID_WANCHAIN = exports.CHAIN_ID_WORLD_CHAIN = exports.CHAIN_ID_ZKSYNC = exports.CHAIN_ID_BOBA = exports.CHAIN_ID_FANTOM = exports.CHAIN_ID_OPBNB = exports.CHAIN_ID_XLAYER = exports.CHAIN_ID_SHIMMER = exports.CHAIN_ID_SONIC = exports.CHAIN_ID_MONAD = exports.CHAIN_ID_POLYGON = exports.CHAIN_ID_UNICHAIN = exports.CHAIN_ID_GNOSIS = exports.CHAIN_ID_OKX_CHAIN = exports.CHAIN_ID_BNB_CHAIN = exports.CHAIN_ID_CRONOS = exports.CHAIN_ID_OPTIMISM = exports.CHAIN_ID_GOERLI = exports.CHAIN_ID_ETHEREUM = exports.CHAIN_FAMILY_TRON = exports.CHAIN_ID_TRON_SHASTA = exports.CHAIN_ID_TRON_MAINNET = exports.CHAIN_FAMILY_TON = exports.CHAIN_ID_TON_TESTNET = exports.CHAIN_ID_TON_MAINNET = exports.CHAIN_FAMILY_STELLAR = exports.CHAIN_ID_STELLAR_TESTNET = exports.CHAIN_ID_STELLAR_MAINNET = exports.CHAIN_FAMILY_XRPL = exports.CHAIN_ID_XRPL_TESTNET = exports.CHAIN_ID_XRPL_MAINNET = exports.CHAIN_FAMILY_SUI = exports.CHAIN_ID_SUI_DEVNET = exports.CHAIN_ID_SUI_TESTNET = exports.CHAIN_ID_SUI_MAINNET = exports.CHAIN_FAMILY_SOLANA = exports.CHAIN_ID_SOLANA_DEVNET = exports.CHAIN_ID_SOLANA_TESTNET = exports.CHAIN_ID_SOLANA_MAINNET = exports.CHAIN_FAMILY_UTXO = exports.CHAIN_ID_BITCOIN_CASH_MAINNET = exports.CHAIN_ID_ZCASH_MAINNET = exports.CHAIN_ID_DASH_MAINNET = exports.CHAIN_ID_DOGECOIN_MAINNET = exports.CHAIN_ID_LITECOIN_MAINNET = exports.CHAIN_ID_BITCOIN_SIGNET = exports.CHAIN_ID_BITCOIN_TESTNET = exports.CHAIN_ID_BITCOIN_MAINNET = void 0;
+exports.CHAIN_ID_AURORA = exports.CHAIN_ID_CELO_SEPOLIA = exports.CHAIN_ID_SEPOLIA = exports.CHAIN_ID_ZORA = exports.CHAIN_ID_ZKLINK_NOVA = exports.CHAIN_ID_KATANA = exports.CHAIN_ID_SCROLL = exports.CHAIN_ID_TAIKO = exports.CHAIN_ID_BLAST = exports.CHAIN_ID_BERA_CHAIN = exports.CHAIN_ID_BOB = exports.CHAIN_ID_LINEA = exports.CHAIN_ID_INK = exports.CHAIN_ID_AVALANCHE_C_CHAIN = exports.CHAIN_ID_CELO = exports.CHAIN_ID_ARBITRUM = exports.CHAIN_ID_MODE = exports.CHAIN_ID_PLASMA = exports.CHAIN_ID_IOTA_EVM = exports.CHAIN_ID_BASE = exports.CHAIN_ID_ZETACHAIN = exports.CHAIN_ID_MANTLE = exports.CHAIN_ID_MEGA_ETH = exports.CHAIN_ID_TEMPO = exports.CHAIN_ID_CITREA = exports.CHAIN_ID_ABSTRACT = exports.CHAIN_ID_SONEIUM = exports.CHAIN_ID_SEI_EVM = exports.CHAIN_ID_MOONRIVER = exports.CHAIN_ID_MOONBEAM = exports.CHAIN_ID_POLYGON_ZKEVM = exports.CHAIN_ID_METIS = void 0;
+exports.isUtxo = isUtxo;
+exports.isSolana = isSolana;
+exports.isSui = isSui;
+exports.isXrpl = isXrpl;
+exports.isStellar = isStellar;
+exports.isTon = isTon;
+exports.isTron = isTron;
+exports.isEvm = isEvm;
+// -----------------------------------------------------------------------------
+// UTXO family (mirrors chain_ids.py:17-25)
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_BITCOIN_MAINNET = -1;
+exports.CHAIN_ID_BITCOIN_TESTNET = -2;
+exports.CHAIN_ID_BITCOIN_SIGNET = -3;
+exports.CHAIN_ID_LITECOIN_MAINNET = -10;
+exports.CHAIN_ID_DOGECOIN_MAINNET = -12;
+exports.CHAIN_ID_DASH_MAINNET = -14;
+exports.CHAIN_ID_ZCASH_MAINNET = -16;
+exports.CHAIN_ID_BITCOIN_CASH_MAINNET = -18;
+exports.CHAIN_FAMILY_UTXO = new Set([
+    exports.CHAIN_ID_BITCOIN_MAINNET,
+    exports.CHAIN_ID_BITCOIN_TESTNET,
+    exports.CHAIN_ID_BITCOIN_SIGNET,
+    exports.CHAIN_ID_LITECOIN_MAINNET,
+    exports.CHAIN_ID_DOGECOIN_MAINNET,
+    exports.CHAIN_ID_DASH_MAINNET,
+    exports.CHAIN_ID_ZCASH_MAINNET,
+    exports.CHAIN_ID_BITCOIN_CASH_MAINNET,
+]);
+/**
+ * True for any chainId in the static UTXO family set (Python parity).
+ *
+ * **Divergence warning**: `networkTypeOf` currently routes only `-1/-2/-3`
+ * (BTC) statically. `LTC (-10)`, `DOGE (-12)`, `DASH (-14)`, `ZCASH (-16)`,
+ * `BCH (-18)` return `true` here for family membership, but v0 has no
+ * `addressFor` path for them — construct the chain instance and call
+ * `chain.validateAddress(raw)` directly. Do not use `isUtxo` as a routing
+ * precondition; use `tryNetworkTypeOf` or per-chain registration checks.
+ */
+function isUtxo(chainId) {
+    return exports.CHAIN_FAMILY_UTXO.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Solana family (mirrors chain_ids.py:43-55)
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_SOLANA_MAINNET = -2000;
+exports.CHAIN_ID_SOLANA_TESTNET = -2001;
+exports.CHAIN_ID_SOLANA_DEVNET = -2002;
+exports.CHAIN_FAMILY_SOLANA = new Set([
+    exports.CHAIN_ID_SOLANA_MAINNET,
+    exports.CHAIN_ID_SOLANA_TESTNET,
+    exports.CHAIN_ID_SOLANA_DEVNET,
+]);
+function isSolana(chainId) {
+    return exports.CHAIN_FAMILY_SOLANA.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Sui family (mirrors chain_ids.py:57-67) — not implemented on TS v0.
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_SUI_MAINNET = -2500;
+exports.CHAIN_ID_SUI_TESTNET = -2501;
+exports.CHAIN_ID_SUI_DEVNET = -2502;
+exports.CHAIN_FAMILY_SUI = new Set([
+    exports.CHAIN_ID_SUI_MAINNET,
+    exports.CHAIN_ID_SUI_TESTNET,
+    exports.CHAIN_ID_SUI_DEVNET,
+]);
+function isSui(chainId) {
+    return exports.CHAIN_FAMILY_SUI.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// XRPL family (mirrors chain_ids.py:69-78) — not implemented on TS v0.
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_XRPL_MAINNET = -3000;
+exports.CHAIN_ID_XRPL_TESTNET = -3001;
+exports.CHAIN_FAMILY_XRPL = new Set([
+    exports.CHAIN_ID_XRPL_MAINNET,
+    exports.CHAIN_ID_XRPL_TESTNET,
+]);
+function isXrpl(chainId) {
+    return exports.CHAIN_FAMILY_XRPL.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Stellar family (mirrors chain_ids.py:80-89) — not implemented on TS v0.
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_STELLAR_MAINNET = -3500;
+exports.CHAIN_ID_STELLAR_TESTNET = -3501;
+exports.CHAIN_FAMILY_STELLAR = new Set([
+    exports.CHAIN_ID_STELLAR_MAINNET,
+    exports.CHAIN_ID_STELLAR_TESTNET,
+]);
+function isStellar(chainId) {
+    return exports.CHAIN_FAMILY_STELLAR.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// TON family (mirrors chain_ids.py:92-100) — not implemented on TS v0
+// (only TonAddress is exported; TonChain deferred).
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_TON_MAINNET = -4000;
+exports.CHAIN_ID_TON_TESTNET = -4001;
+exports.CHAIN_FAMILY_TON = new Set([
+    exports.CHAIN_ID_TON_MAINNET,
+    exports.CHAIN_ID_TON_TESTNET,
+]);
+function isTon(chainId) {
+    return exports.CHAIN_FAMILY_TON.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Tron family (mirrors chain_ids.py:103-111) — not implemented on TS v0.
+// Note: Tron uses positive numeric IDs (not synthetic negatives).
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_TRON_MAINNET = 728126428;
+exports.CHAIN_ID_TRON_SHASTA = 2494104990;
+exports.CHAIN_FAMILY_TRON = new Set([
+    exports.CHAIN_ID_TRON_MAINNET,
+    exports.CHAIN_ID_TRON_SHASTA,
+]);
+function isTron(chainId) {
+    return exports.CHAIN_FAMILY_TRON.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// EVM chain IDs (mirrors chain_ids.py:114-167).
+// -----------------------------------------------------------------------------
+exports.CHAIN_ID_ETHEREUM = 1;
+exports.CHAIN_ID_GOERLI = 5;
+exports.CHAIN_ID_OPTIMISM = 10;
+exports.CHAIN_ID_CRONOS = 25;
+exports.CHAIN_ID_BNB_CHAIN = 56;
+exports.CHAIN_ID_OKX_CHAIN = 66;
+exports.CHAIN_ID_GNOSIS = 100;
+exports.CHAIN_ID_UNICHAIN = 130;
+exports.CHAIN_ID_POLYGON = 137;
+exports.CHAIN_ID_MONAD = 143;
+exports.CHAIN_ID_SONIC = 146;
+exports.CHAIN_ID_SHIMMER = 148;
+exports.CHAIN_ID_XLAYER = 196;
+exports.CHAIN_ID_OPBNB = 204;
+exports.CHAIN_ID_FANTOM = 250;
+exports.CHAIN_ID_BOBA = 288;
+exports.CHAIN_ID_ZKSYNC = 324;
+exports.CHAIN_ID_WORLD_CHAIN = 480;
+exports.CHAIN_ID_WANCHAIN = 888;
+exports.CHAIN_ID_STABLE = 988;
+exports.CHAIN_ID_HYPER_EVM = 999;
+exports.CHAIN_ID_METIS = 1088;
+exports.CHAIN_ID_POLYGON_ZKEVM = 1101;
+exports.CHAIN_ID_MOONBEAM = 1284;
+exports.CHAIN_ID_MOONRIVER = 1285;
+exports.CHAIN_ID_SEI_EVM = 1329;
+exports.CHAIN_ID_SONEIUM = 1868;
+exports.CHAIN_ID_ABSTRACT = 2741;
+exports.CHAIN_ID_CITREA = 4114;
+exports.CHAIN_ID_TEMPO = 4217;
+exports.CHAIN_ID_MEGA_ETH = 4326;
+exports.CHAIN_ID_MANTLE = 5000;
+exports.CHAIN_ID_ZETACHAIN = 7000;
+exports.CHAIN_ID_BASE = 8453;
+exports.CHAIN_ID_IOTA_EVM = 8822;
+exports.CHAIN_ID_PLASMA = 9745;
+exports.CHAIN_ID_MODE = 34443;
+exports.CHAIN_ID_ARBITRUM = 42161;
+exports.CHAIN_ID_CELO = 42220;
+exports.CHAIN_ID_AVALANCHE_C_CHAIN = 43114;
+exports.CHAIN_ID_INK = 57073;
+exports.CHAIN_ID_LINEA = 59144;
+exports.CHAIN_ID_BOB = 60808;
+exports.CHAIN_ID_BERA_CHAIN = 80094;
+exports.CHAIN_ID_BLAST = 81457;
+exports.CHAIN_ID_TAIKO = 167000;
+exports.CHAIN_ID_SCROLL = 534352;
+exports.CHAIN_ID_KATANA = 747474;
+exports.CHAIN_ID_ZKLINK_NOVA = 810180;
+exports.CHAIN_ID_ZORA = 7777777;
+exports.CHAIN_ID_SEPOLIA = 11155111;
+exports.CHAIN_ID_CELO_SEPOLIA = 11142220;
+exports.CHAIN_ID_AURORA = 1313161554;
+/**
+ * Sign/family test — returns `true` for any positive integer chainId that
+ * isn't a Tron chain. Does NOT assert that the chainId corresponds to a
+ * pre-baked `EvmChain`. Consumers wanting a support check should look up the
+ * chain in `ALL_DECLARED_EVM_CHAINS` (48 pre-baked chains); the smaller
+ * `ALL_EVM_CHAINS` is the pre-v0 "wired" set of 4 kept for backward compat.
+ *
+ * **Caveat on all `is*` predicates**: they operate on the immutable Python-
+ * parity family sets in this file. `networkTypeOf()` (in `network_type.ts`)
+ * reads the runtime registry that also includes consumer-registered chains,
+ * and is the authoritative routing check. The two can disagree for any
+ * chainId a consumer registered.
+ */
+function isEvm(chainId) {
+    return Number.isInteger(chainId) && chainId > 0 && !exports.CHAIN_FAMILY_TRON.has(chainId);
+}
+//# sourceMappingURL=chain_ids.js.map

package/dist/cjs/chain_ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain_ids.js","sourceRoot":"","sources":["../../chain_ids.ts"],"names":[],"mappings":"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"}

package/dist/cjs/errors.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainError = exports.ChainErrorKinds = void 0;
+exports.sanitizeMessage = sanitizeMessage;
+exports.sanitizeCause = sanitizeCause;
+exports.isChainError = isChainError;
+exports.isBlockhashExpiredError = isBlockhashExpiredError;
+exports.isSimulationError = isSimulationError;
+exports.isNonceError = isNonceError;
+exports.isTransactionTooLargeError = isTransactionTooLargeError;
+/**
+ * Replace `rpcUrl` in `message` with its host-only form so API keys carried
+ * in the URL path/query don't leak into error strings. Falls back to a
+ * `<rpc>` placeholder if the URL is unparseable.
+ */
+function sanitizeMessage(message, rpcUrl) {
+    let out = message;
+    // Long hex runs (with or without 0x prefix) are signed-tx bytes or opaque
+    // payloads. Threshold 128 hex chars = 64 bytes, above the largest transient
+    // identifier (tx hash / signature = 64 hex / 88 base58) so we don't clobber
+    // hashes but do catch even a minimal signed EVM tx (~110 bytes).
+    out = out.replace(/(?:0x)?[0-9a-fA-F]{128,}/g, (m) => {
+        const hexLen = m.startsWith('0x') || m.startsWith('0X') ? m.length - 2 : m.length;
+        return `<signed-bytes:${hexLen / 2}B>`;
+    });
+    // Long base64 runs (Solana / Jito payloads). base64 signed-tx is ~200 chars.
+    out = out.replace(/[A-Za-z0-9+/]{160,}={0,2}/g, (m) => `<signed-bytes-b64:${m.length}c>`);
+    out = out.replace(/([?&])([a-zA-Z_-]*(?:api[-_]?key|key|token|access[-_]?token|secret|auth))=[^\s"&]+/gi, '$1$2=<redacted>');
+    out = out.replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, 'Bearer <redacted>');
+    out = out.replace(/Authorization:\s*[A-Za-z0-9._~+/=-]+/gi, 'Authorization: <redacted>');
+    out = out.replace(/((?:x-)?api[-_]?key)\s*:\s*[A-Za-z0-9._~+/=-]+/gi, '$1: <redacted>');
+    out = out.replace(/(\/v\d+|\/api|\/rpc)\/[A-Za-z0-9_-]{16,}(?=[\s/,)\];.'"]|$)/gi, '$1/<redacted>');
+    out = out.replace(/https?:\/\/[^\s"'`]*\.(?:alchemy\.com|infura\.io|quiknode\.pro|helius-rpc\.com|ankr\.com|blastapi\.io|drpc\.org)\/[A-Za-z0-9_./=-]{8,}/gi, (m) => {
+        try {
+            const u = new URL(m);
+            return `${u.protocol}//${u.host}/<redacted>`;
+        }
+        catch {
+            return '<rpc>';
+        }
+    });
+    if (!rpcUrl)
+        return out;
+    try {
+        const u = new URL(rpcUrl);
+        const host = `${u.protocol}//${u.host}`;
+        return out.replaceAll(rpcUrl, host);
+    }
+    catch {
+        return out.replaceAll(rpcUrl, '<rpc>');
+    }
+}
+/**
+ * Build a fresh `Error` from `cause` with a sanitized message and stack,
+ * dropping every other property (axios errors carry `.config.headers`
+ * `Authorization` and `.config.url`/`baseURL` with API keys). Consumers'
+ * structured loggers (pino `err` serializer, `util.inspect({showHidden})`)
+ * walk `error.cause`; this ensures the API key never lands in logs.
+ * Returns `undefined` for non-Error causes so the ChainError constructor
+ * leaves cause unset.
+ */
+function sanitizeCause(cause, rpcUrl) {
+    if (!(cause instanceof Error))
+        return undefined;
+    const short = cause.shortMessage;
+    const source = typeof short === 'string' && short.length > 0 ? short : cause.message;
+    const safe = new Error(sanitizeMessage(source, rpcUrl));
+    safe.name = cause.name;
+    if (cause.stack)
+        safe.stack = sanitizeMessage(cause.stack, rpcUrl);
+    return safe;
+}
+exports.ChainErrorKinds = {
+    ChainNotSupported: 'chain_not_supported',
+    DuplicateToken: 'duplicate_token',
+    RpcNotConfigured: 'rpc_not_configured',
+    RpcError: 'rpc_error',
+    TransactionDecodeFailed: 'transaction_decode_failed',
+    InvalidAddress: 'invalid_address',
+    InvalidTokenIdentifier: 'invalid_token_identifier',
+    InvalidArgument: 'invalid_argument',
+    BroadcastRejected: 'broadcast_rejected',
+    NonceTooLow: 'nonce_too_low',
+    InsufficientFunds: 'insufficient_funds',
+    BlockhashExpired: 'blockhash_expired',
+    SimulationFailed: 'simulation_failed',
+    TransactionTooLarge: 'transaction_too_large',
+    FeatureNotSupported: 'feature_not_supported',
+};
+class ChainError extends Error {
+    kind;
+    meta;
+    constructor(kind, message, meta = {}, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = 'ChainError';
+        this.kind = kind;
+        this.meta = meta;
+    }
+}
+exports.ChainError = ChainError;
+function isChainError(err, kind) {
+    if (!(err instanceof ChainError))
+        return false;
+    return kind === undefined || err.kind === kind;
+}
+function isBlockhashExpiredError(err) {
+    return isChainError(err, exports.ChainErrorKinds.BlockhashExpired);
+}
+function isSimulationError(err) {
+    return isChainError(err, exports.ChainErrorKinds.SimulationFailed);
+}
+function isNonceError(err) {
+    return isChainError(err, exports.ChainErrorKinds.NonceTooLow);
+}
+function isTransactionTooLargeError(err) {
+    return isChainError(err, exports.ChainErrorKinds.TransactionTooLarge);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../errors.ts"],"names":[],"mappings":"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"}