@getomnichain/omnichain 0.2.0

package/dist/chain_ids.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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.
+ */
+export declare const CHAIN_ID_BITCOIN_MAINNET = -1;
+export declare const CHAIN_ID_BITCOIN_TESTNET = -2;
+export declare const CHAIN_ID_BITCOIN_SIGNET = -3;
+export declare const CHAIN_ID_LITECOIN_MAINNET = -10;
+export declare const CHAIN_ID_DOGECOIN_MAINNET = -12;
+export declare const CHAIN_ID_DASH_MAINNET = -14;
+export declare const CHAIN_ID_ZCASH_MAINNET = -16;
+export declare const CHAIN_ID_BITCOIN_CASH_MAINNET = -18;
+export declare const CHAIN_FAMILY_UTXO: ReadonlySet<number>;
+/**
+ * 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.
+ */
+export declare function isUtxo(chainId: number): boolean;
+export declare const CHAIN_ID_SOLANA_MAINNET = -2000;
+export declare const CHAIN_ID_SOLANA_TESTNET = -2001;
+export declare const CHAIN_ID_SOLANA_DEVNET = -2002;
+export declare const CHAIN_FAMILY_SOLANA: ReadonlySet<number>;
+export declare function isSolana(chainId: number): boolean;
+export declare const CHAIN_ID_SUI_MAINNET = -2500;
+export declare const CHAIN_ID_SUI_TESTNET = -2501;
+export declare const CHAIN_ID_SUI_DEVNET = -2502;
+export declare const CHAIN_FAMILY_SUI: ReadonlySet<number>;
+export declare function isSui(chainId: number): boolean;
+export declare const CHAIN_ID_XRPL_MAINNET = -3000;
+export declare const CHAIN_ID_XRPL_TESTNET = -3001;
+export declare const CHAIN_FAMILY_XRPL: ReadonlySet<number>;
+export declare function isXrpl(chainId: number): boolean;
+export declare const CHAIN_ID_STELLAR_MAINNET = -3500;
+export declare const CHAIN_ID_STELLAR_TESTNET = -3501;
+export declare const CHAIN_FAMILY_STELLAR: ReadonlySet<number>;
+export declare function isStellar(chainId: number): boolean;
+export declare const CHAIN_ID_TON_MAINNET = -4000;
+export declare const CHAIN_ID_TON_TESTNET = -4001;
+export declare const CHAIN_FAMILY_TON: ReadonlySet<number>;
+export declare function isTon(chainId: number): boolean;
+export declare const CHAIN_ID_TRON_MAINNET = 728126428;
+export declare const CHAIN_ID_TRON_SHASTA = 2494104990;
+export declare const CHAIN_FAMILY_TRON: ReadonlySet<number>;
+export declare function isTron(chainId: number): boolean;
+export declare const CHAIN_ID_ETHEREUM = 1;
+export declare const CHAIN_ID_GOERLI = 5;
+export declare const CHAIN_ID_OPTIMISM = 10;
+export declare const CHAIN_ID_CRONOS = 25;
+export declare const CHAIN_ID_BNB_CHAIN = 56;
+export declare const CHAIN_ID_OKX_CHAIN = 66;
+export declare const CHAIN_ID_GNOSIS = 100;
+export declare const CHAIN_ID_UNICHAIN = 130;
+export declare const CHAIN_ID_POLYGON = 137;
+export declare const CHAIN_ID_MONAD = 143;
+export declare const CHAIN_ID_SONIC = 146;
+export declare const CHAIN_ID_SHIMMER = 148;
+export declare const CHAIN_ID_XLAYER = 196;
+export declare const CHAIN_ID_OPBNB = 204;
+export declare const CHAIN_ID_FANTOM = 250;
+export declare const CHAIN_ID_BOBA = 288;
+export declare const CHAIN_ID_ZKSYNC = 324;
+export declare const CHAIN_ID_WORLD_CHAIN = 480;
+export declare const CHAIN_ID_WANCHAIN = 888;
+export declare const CHAIN_ID_STABLE = 988;
+export declare const CHAIN_ID_HYPER_EVM = 999;
+export declare const CHAIN_ID_METIS = 1088;
+export declare const CHAIN_ID_POLYGON_ZKEVM = 1101;
+export declare const CHAIN_ID_MOONBEAM = 1284;
+export declare const CHAIN_ID_MOONRIVER = 1285;
+export declare const CHAIN_ID_SEI_EVM = 1329;
+export declare const CHAIN_ID_SONEIUM = 1868;
+export declare const CHAIN_ID_ABSTRACT = 2741;
+export declare const CHAIN_ID_CITREA = 4114;
+export declare const CHAIN_ID_TEMPO = 4217;
+export declare const CHAIN_ID_MEGA_ETH = 4326;
+export declare const CHAIN_ID_MANTLE = 5000;
+export declare const CHAIN_ID_ZETACHAIN = 7000;
+export declare const CHAIN_ID_BASE = 8453;
+export declare const CHAIN_ID_IOTA_EVM = 8822;
+export declare const CHAIN_ID_PLASMA = 9745;
+export declare const CHAIN_ID_MODE = 34443;
+export declare const CHAIN_ID_ARBITRUM = 42161;
+export declare const CHAIN_ID_CELO = 42220;
+export declare const CHAIN_ID_AVALANCHE_C_CHAIN = 43114;
+export declare const CHAIN_ID_INK = 57073;
+export declare const CHAIN_ID_LINEA = 59144;
+export declare const CHAIN_ID_BOB = 60808;
+export declare const CHAIN_ID_BERA_CHAIN = 80094;
+export declare const CHAIN_ID_BLAST = 81457;
+export declare const CHAIN_ID_TAIKO = 167000;
+export declare const CHAIN_ID_SCROLL = 534352;
+export declare const CHAIN_ID_KATANA = 747474;
+export declare const CHAIN_ID_ZKLINK_NOVA = 810180;
+export declare const CHAIN_ID_ZORA = 7777777;
+export declare const CHAIN_ID_SEPOLIA = 11155111;
+export declare const CHAIN_ID_CELO_SEPOLIA = 11142220;
+export declare const 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.
+ */
+export declare function isEvm(chainId: number): boolean;
+//# sourceMappingURL=chain_ids.d.ts.map

package/dist/chain_ids.d.ts.map

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

package/dist/chain_ids.js

@@ -0,0 +1,193 @@
+/**
+ * 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.
+ */
+// -----------------------------------------------------------------------------
+// UTXO family (mirrors chain_ids.py:17-25)
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_BITCOIN_MAINNET = -1;
+export const CHAIN_ID_BITCOIN_TESTNET = -2;
+export const CHAIN_ID_BITCOIN_SIGNET = -3;
+export const CHAIN_ID_LITECOIN_MAINNET = -10;
+export const CHAIN_ID_DOGECOIN_MAINNET = -12;
+export const CHAIN_ID_DASH_MAINNET = -14;
+export const CHAIN_ID_ZCASH_MAINNET = -16;
+export const CHAIN_ID_BITCOIN_CASH_MAINNET = -18;
+export const CHAIN_FAMILY_UTXO = new Set([
+    CHAIN_ID_BITCOIN_MAINNET,
+    CHAIN_ID_BITCOIN_TESTNET,
+    CHAIN_ID_BITCOIN_SIGNET,
+    CHAIN_ID_LITECOIN_MAINNET,
+    CHAIN_ID_DOGECOIN_MAINNET,
+    CHAIN_ID_DASH_MAINNET,
+    CHAIN_ID_ZCASH_MAINNET,
+    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.
+ */
+export function isUtxo(chainId) {
+    return CHAIN_FAMILY_UTXO.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Solana family (mirrors chain_ids.py:43-55)
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_SOLANA_MAINNET = -2000;
+export const CHAIN_ID_SOLANA_TESTNET = -2001;
+export const CHAIN_ID_SOLANA_DEVNET = -2002;
+export const CHAIN_FAMILY_SOLANA = new Set([
+    CHAIN_ID_SOLANA_MAINNET,
+    CHAIN_ID_SOLANA_TESTNET,
+    CHAIN_ID_SOLANA_DEVNET,
+]);
+export function isSolana(chainId) {
+    return CHAIN_FAMILY_SOLANA.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Sui family (mirrors chain_ids.py:57-67) — not implemented on TS v0.
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_SUI_MAINNET = -2500;
+export const CHAIN_ID_SUI_TESTNET = -2501;
+export const CHAIN_ID_SUI_DEVNET = -2502;
+export const CHAIN_FAMILY_SUI = new Set([
+    CHAIN_ID_SUI_MAINNET,
+    CHAIN_ID_SUI_TESTNET,
+    CHAIN_ID_SUI_DEVNET,
+]);
+export function isSui(chainId) {
+    return CHAIN_FAMILY_SUI.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// XRPL family (mirrors chain_ids.py:69-78) — not implemented on TS v0.
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_XRPL_MAINNET = -3000;
+export const CHAIN_ID_XRPL_TESTNET = -3001;
+export const CHAIN_FAMILY_XRPL = new Set([
+    CHAIN_ID_XRPL_MAINNET,
+    CHAIN_ID_XRPL_TESTNET,
+]);
+export function isXrpl(chainId) {
+    return CHAIN_FAMILY_XRPL.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// Stellar family (mirrors chain_ids.py:80-89) — not implemented on TS v0.
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_STELLAR_MAINNET = -3500;
+export const CHAIN_ID_STELLAR_TESTNET = -3501;
+export const CHAIN_FAMILY_STELLAR = new Set([
+    CHAIN_ID_STELLAR_MAINNET,
+    CHAIN_ID_STELLAR_TESTNET,
+]);
+export function isStellar(chainId) {
+    return CHAIN_FAMILY_STELLAR.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// TON family (mirrors chain_ids.py:92-100) — not implemented on TS v0
+// (only TonAddress is exported; TonChain deferred).
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_TON_MAINNET = -4000;
+export const CHAIN_ID_TON_TESTNET = -4001;
+export const CHAIN_FAMILY_TON = new Set([
+    CHAIN_ID_TON_MAINNET,
+    CHAIN_ID_TON_TESTNET,
+]);
+export function isTon(chainId) {
+    return 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).
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_TRON_MAINNET = 728126428;
+export const CHAIN_ID_TRON_SHASTA = 2494104990;
+export const CHAIN_FAMILY_TRON = new Set([
+    CHAIN_ID_TRON_MAINNET,
+    CHAIN_ID_TRON_SHASTA,
+]);
+export function isTron(chainId) {
+    return CHAIN_FAMILY_TRON.has(chainId);
+}
+// -----------------------------------------------------------------------------
+// EVM chain IDs (mirrors chain_ids.py:114-167).
+// -----------------------------------------------------------------------------
+export const CHAIN_ID_ETHEREUM = 1;
+export const CHAIN_ID_GOERLI = 5;
+export const CHAIN_ID_OPTIMISM = 10;
+export const CHAIN_ID_CRONOS = 25;
+export const CHAIN_ID_BNB_CHAIN = 56;
+export const CHAIN_ID_OKX_CHAIN = 66;
+export const CHAIN_ID_GNOSIS = 100;
+export const CHAIN_ID_UNICHAIN = 130;
+export const CHAIN_ID_POLYGON = 137;
+export const CHAIN_ID_MONAD = 143;
+export const CHAIN_ID_SONIC = 146;
+export const CHAIN_ID_SHIMMER = 148;
+export const CHAIN_ID_XLAYER = 196;
+export const CHAIN_ID_OPBNB = 204;
+export const CHAIN_ID_FANTOM = 250;
+export const CHAIN_ID_BOBA = 288;
+export const CHAIN_ID_ZKSYNC = 324;
+export const CHAIN_ID_WORLD_CHAIN = 480;
+export const CHAIN_ID_WANCHAIN = 888;
+export const CHAIN_ID_STABLE = 988;
+export const CHAIN_ID_HYPER_EVM = 999;
+export const CHAIN_ID_METIS = 1088;
+export const CHAIN_ID_POLYGON_ZKEVM = 1101;
+export const CHAIN_ID_MOONBEAM = 1284;
+export const CHAIN_ID_MOONRIVER = 1285;
+export const CHAIN_ID_SEI_EVM = 1329;
+export const CHAIN_ID_SONEIUM = 1868;
+export const CHAIN_ID_ABSTRACT = 2741;
+export const CHAIN_ID_CITREA = 4114;
+export const CHAIN_ID_TEMPO = 4217;
+export const CHAIN_ID_MEGA_ETH = 4326;
+export const CHAIN_ID_MANTLE = 5000;
+export const CHAIN_ID_ZETACHAIN = 7000;
+export const CHAIN_ID_BASE = 8453;
+export const CHAIN_ID_IOTA_EVM = 8822;
+export const CHAIN_ID_PLASMA = 9745;
+export const CHAIN_ID_MODE = 34443;
+export const CHAIN_ID_ARBITRUM = 42161;
+export const CHAIN_ID_CELO = 42220;
+export const CHAIN_ID_AVALANCHE_C_CHAIN = 43114;
+export const CHAIN_ID_INK = 57073;
+export const CHAIN_ID_LINEA = 59144;
+export const CHAIN_ID_BOB = 60808;
+export const CHAIN_ID_BERA_CHAIN = 80094;
+export const CHAIN_ID_BLAST = 81457;
+export const CHAIN_ID_TAIKO = 167000;
+export const CHAIN_ID_SCROLL = 534352;
+export const CHAIN_ID_KATANA = 747474;
+export const CHAIN_ID_ZKLINK_NOVA = 810180;
+export const CHAIN_ID_ZORA = 7777777;
+export const CHAIN_ID_SEPOLIA = 11155111;
+export const CHAIN_ID_CELO_SEPOLIA = 11142220;
+export const 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.
+ */
+export function isEvm(chainId) {
+    return Number.isInteger(chainId) && chainId > 0 && !CHAIN_FAMILY_TRON.has(chainId);
+}
+//# sourceMappingURL=chain_ids.js.map

package/dist/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/errors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+export declare function sanitizeMessage(message: string, rpcUrl: string | null): string;
+/**
+ * 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.
+ */
+export declare function sanitizeCause(cause: unknown, rpcUrl: string | null): Error | undefined;
+export declare const ChainErrorKinds: {
+    readonly ChainNotSupported: "chain_not_supported";
+    readonly DuplicateToken: "duplicate_token";
+    readonly RpcNotConfigured: "rpc_not_configured";
+    readonly RpcError: "rpc_error";
+    readonly TransactionDecodeFailed: "transaction_decode_failed";
+    readonly InvalidAddress: "invalid_address";
+    readonly InvalidTokenIdentifier: "invalid_token_identifier";
+    readonly InvalidArgument: "invalid_argument";
+};
+export type ChainErrorKind = (typeof ChainErrorKinds)[keyof typeof ChainErrorKinds];
+export interface ChainErrorMeta {
+    chainId?: number;
+    txHash?: string;
+    address?: string;
+    identifier?: string;
+    rpcHost?: string;
+    envCandidates?: string[];
+}
+export declare class ChainError extends Error {
+    readonly kind: ChainErrorKind;
+    readonly meta: ChainErrorMeta;
+    constructor(kind: ChainErrorKind, message: string, meta?: ChainErrorMeta, cause?: unknown);
+}
+export declare function isChainError(err: unknown, kind?: ChainErrorKind): err is ChainError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAU9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,CAMtF;AAED,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,EAAE,KAAK,CAAC,EAAE,OAAO;CAM9F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,GAAG,IAAI,UAAU,CAGnF"}

package/dist/errors.js

@@ -0,0 +1,62 @@
+/**
+ * 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.
+ */
+export function sanitizeMessage(message, rpcUrl) {
+    if (!rpcUrl)
+        return message;
+    let host;
+    try {
+        const u = new URL(rpcUrl);
+        host = `${u.protocol}//${u.host}`;
+    }
+    catch {
+        return message.replaceAll(rpcUrl, '<rpc>');
+    }
+    return message.replaceAll(rpcUrl, host);
+}
+/**
+ * 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.
+ */
+export function sanitizeCause(cause, rpcUrl) {
+    if (!(cause instanceof Error))
+        return undefined;
+    const safe = new Error(sanitizeMessage(cause.message, rpcUrl));
+    safe.name = cause.name;
+    if (cause.stack)
+        safe.stack = sanitizeMessage(cause.stack, rpcUrl);
+    return safe;
+}
+export const 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',
+};
+export 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;
+    }
+}
+export function isChainError(err, kind) {
+    if (!(err instanceof ChainError))
+        return false;
+    return kind === undefined || err.kind === kind;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,MAAqB;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,GAAG,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,MAAqB;IACjE,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACvB,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB,EAAE,qBAAqB;IACxC,cAAc,EAAE,iBAAiB;IACjC,gBAAgB,EAAE,oBAAoB;IACtC,QAAQ,EAAE,WAAW;IACrB,uBAAuB,EAAE,2BAA2B;IACpD,cAAc,EAAE,iBAAiB;IACjC,sBAAsB,EAAE,0BAA0B;IAClD,eAAe,EAAE,kBAAkB;CAC3B,CAAC;AAaX,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,IAAI,CAAiB;IAE9B,YAAY,IAAoB,EAAE,OAAe,EAAE,OAAuB,EAAE,EAAE,KAAe;QAC3F,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,IAAqB;IAC9D,IAAI,CAAC,CAAC,GAAG,YAAY,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;AACjD,CAAC"}

package/dist/evm/evm_address.d.ts

@@ -0,0 +1,11 @@
+import { NetworkType } from '../network_type.ts';
+import { Address } from '../address.ts';
+export declare class EvmAddress extends Address {
+    constructor(raw: string);
+    canonical(): string;
+    toChecksum(): string;
+    get networkType(): NetworkType;
+    private static normalize;
+    private static assertChecksumIfMixedCase;
+}
+//# sourceMappingURL=evm_address.d.ts.map

package/dist/evm/evm_address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm_address.d.ts","sourceRoot":"","sources":["../../evm/evm_address.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAMxC,qBAAa,UAAW,SAAQ,OAAO;gBACzB,GAAG,EAAE,MAAM;IAKvB,SAAS,IAAI,MAAM;IAInB,UAAU,IAAI,MAAM;IAWpB,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED,OAAO,CAAC,MAAM,CAAC,SAAS;IAYxB,OAAO,CAAC,MAAM,CAAC,yBAAyB;CAiBzC"}

package/dist/evm/evm_address.js

@@ -0,0 +1,56 @@
+import jsSha3 from 'js-sha3';
+import { NetworkType } from "../network_type.js";
+import { Address } from "../address.js";
+const { keccak_256 } = jsSha3;
+const EVM_ADDRESS_BODY_REGEX = /^[a-fA-F0-9]{40}$/;
+export class EvmAddress extends Address {
+    constructor(raw) {
+        super(EvmAddress.normalize(raw));
+        EvmAddress.assertChecksumIfMixedCase(this.raw);
+    }
+    canonical() {
+        return this.raw.toLowerCase();
+    }
+    toChecksum() {
+        const body = this.canonical().slice(2);
+        const hash = keccak_256(body);
+        let result = '0x';
+        for (let index = 0; index < body.length; index++) {
+            const nibble = parseInt(hash[index], 16);
+            result += nibble >= 8 ? body[index].toUpperCase() : body[index];
+        }
+        return result;
+    }
+    get networkType() {
+        return NetworkType.EVM;
+    }
+    static normalize(raw) {
+        if (typeof raw !== 'string') {
+            throw new Error(`Invalid EVM address: not a string`);
+        }
+        const withPrefix = raw.startsWith('0x') || raw.startsWith('0X') ? raw : `0x${raw}`;
+        const body = withPrefix.slice(2);
+        if (!EVM_ADDRESS_BODY_REGEX.test(body)) {
+            throw new Error(`Invalid EVM address: "${raw}"`);
+        }
+        return `0x${body}`;
+    }
+    static assertChecksumIfMixedCase(prefixed) {
+        const body = prefixed.slice(2);
+        const isAllLower = body === body.toLowerCase();
+        const isAllUpper = body === body.toUpperCase();
+        if (isAllLower || isAllUpper)
+            return;
+        const hash = keccak_256(body.toLowerCase());
+        for (let index = 0; index < body.length; index++) {
+            const nibble = parseInt(hash[index], 16);
+            const expectedUpper = nibble >= 8;
+            const actualIsUpper = body[index] >= 'A' && body[index] <= 'F';
+            const actualIsAlpha = actualIsUpper || (body[index] >= 'a' && body[index] <= 'f');
+            if (actualIsAlpha && actualIsUpper !== expectedUpper) {
+                throw new Error(`Invalid EVM address checksum: "${prefixed}"`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=evm_address.js.map

package/dist/evm/evm_address.js.map

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

package/dist/evm/evm_chain.d.ts

@@ -0,0 +1,123 @@
+import { JsonRpcProvider, TransactionReceipt } from 'ethers';
+import { Chain, CreateTransferRequest } from '../chain.base.ts';
+import { Priority } from '../priority.ts';
+import { EvmGasEstimate } from './evm_gas_estimate.ts';
+import { NestedBalanceChanges } from '../transaction_status.ts';
+import { EvmTransactionStatus } from './evm_transaction_status.ts';
+import { EvmToken } from './evm_token.ts';
+import { UnsignedEvmTransaction } from './unsigned_evm_transaction.ts';
+export interface EvmChainInit {
+    chainId: number;
+    name: string;
+    blockTimeSeconds: number;
+    explorerBaseUrl: string;
+    nativeSymbol: string;
+    nativeDecimals?: number;
+    /**
+     * Optional. When set, used verbatim. When omitted, the env-var fallback
+     * chain is tried: `<NAME_UPPERCASE_UNDERSCORED>_RPC_URL`
+     * (e.g. `ARBITRUM_RPC_URL`), then `EVM_<chainId>_RPC_URL`, then throws.
+     */
+    rpcUrl?: string;
+    supportsEip1559?: boolean;
+    /**
+     * OP-stack rollups (Optimism/Base/Unichain/WorldChain/Boba/Sonic and
+     * similar) charge an additional L1 data fee returned as `l1Fee` on the
+     * raw receipt JSON. Ethers v6 strips `l1Fee`/`l1GasUsed`/`l1GasPrice`
+     * from its parsed `TransactionReceipt` shape (whitelist-based), so
+     * reading it requires a raw `eth_getTransactionReceipt` call. Flag
+     * defaults to `false`; enable on chains that carry the L1 fee.
+     */
+    hasL1Fee?: boolean;
+    /**
+     * Default gas limit for a native (non-ERC20) transfer. Mirrors Python default 21_000
+     * (impl/evm/base.py:479). Scroll overrides to 360_000 etc.
+     *
+     * **Declarative-only in v0**: stored on the chain instance and readable by
+     * consumers, but NOT consumed by `createTransferUnsignedTransaction` yet —
+     * gas fields on the returned `UnsignedEvmTransaction` are populated by the
+     * caller. Wired into the builder in the follow-up architectural PR (Phase 3
+     * of Sinan parity).
+     */
+    nativeTransferGasLimit?: number;
+    /**
+     * Multiplier applied to the eth_gasPrice / effective gas price when building
+     * a native transfer. Mirrors Python default 1.4 (impl/evm/base.py:480).
+     * Scroll overrides to 50.0.
+     *
+     * **Declarative-only in v0** — see `nativeTransferGasLimit` note above.
+     */
+    nativeTransferGasMultiplier?: number;
+}
+export declare class EvmChain extends Chain {
+    readonly rpcUrl: string | undefined;
+    readonly supportsEip1559: boolean;
+    readonly hasL1Fee: boolean;
+    /**
+     * Default gas limit for native transfers. Matches Python's public attribute
+     * at `impl/evm/base.py:495` — v0 does not consume it inside the TS SDK
+     * (see `createTransferUnsignedTransaction`) but exposes it so consumers
+     * building their own transfer paths get identical numbers to Python. Wired
+     * into the SDK-owned transfer builder in a follow-up branch.
+     */
+    readonly nativeTransferGasLimit: number;
+    /**
+     * Legacy `eth_gasPrice` multiplier for native transfers on non-1559 chains.
+     * Matches Python's public attribute at `impl/evm/base.py:496`. Same
+     * "declarative for consumers, unused internally in v0" note as
+     * `nativeTransferGasLimit`.
+     */
+    readonly nativeTransferGasMultiplier: number;
+    private readonly _nativeToken;
+    private _provider;
+    private _resolvedRpcUrl;
+    constructor(init: EvmChainInit);
+    get nativeToken(): EvmToken;
+    getErc20Token(symbol: string, contractAddress: string, decimals: number): EvmToken;
+    getProvider(): JsonRpcProvider;
+    /**
+     * Suggest gas fees for a priority tier. Mirrors Python's `_resolve_gas_pricing`
+     * dispatch (impl/evm/base.py:807-833):
+     *
+     *   - legacy chains (`supportsEip1559 === false`): scale `eth_gasPrice` by
+     *     the priority tier's legacy multiplier.
+     *   - 1559 chains: sample eth_feeHistory across the last 10 blocks at the
+     *     tier's reward percentile, sort, pick the p90 across blocks. On empty
+     *     rewards, use 2 gwei. On RPC failure, bubble as `ChainError(RpcError)`
+     *     (Python bubbles too — no defensive fallback).
+     */
+    suggestGas(priority: Priority): Promise<EvmGasEstimate>;
+    private readRpcUrl;
+    private rpcHost;
+    getWalletExplorerUrl(address: string): string;
+    getTokenExplorerUrl(tokenIdentifier?: string): string;
+    getTransactionExplorerUrl(txHash: string): string;
+    validateAddress(raw: string): boolean;
+    validateTokenIdentifier(raw: string | undefined): boolean;
+    getBalance(owner: string, tokenIdentifier?: string): Promise<bigint>;
+    createTransferUnsignedTransaction(req: CreateTransferRequest): Promise<UnsignedEvmTransaction>;
+    getChainTipHeight(): Promise<number>;
+    getTransactionStatus(txHash: string): Promise<EvmTransactionStatus>;
+    decodeBalanceChanges(args: {
+        from: string;
+        to: string | null;
+        value: bigint;
+        gasCost: bigint;
+        receipt: TransactionReceipt;
+    }): Promise<NestedBalanceChanges>;
+    private resolveErc20TokenDefensive;
+    /**
+     * STRICT decimals resolver for the transfer builder — throws
+     * `ChainError(RpcError)` on any failure to reach the contract.
+     * Used exclusively when converting `amountHr: Decimal` →
+     * `amountMr: bigint`, where a defensive fallback to `decimals=0`
+     * would silently sign a transaction for a wildly wrong amount
+     * (e.g. `1.5 USDC` → `1n` minor units instead of `1_500_000n`).
+     * The receipt-decoder still uses the defensive variant, since a
+     * placeholder token there is a display concern, not a money one.
+     */
+    private resolveErc20DecimalsStrict;
+    private rpcError;
+}
+export declare function decodeRevertData(data: string | undefined): string | undefined;
+//# sourceMappingURL=evm_chain.d.ts.map