@getomnichain/omnichain 0.2.0

package/dist/evm/evm_gas_estimate.d.ts

@@ -0,0 +1,45 @@
+export type EvmGasEstimateKind = 'legacy' | 'eip1559';
+export interface EvmLegacyGasEstimateInit {
+    kind: 'legacy';
+    units?: bigint;
+    gasPrice: bigint;
+}
+export interface EvmEip1559GasEstimateInit {
+    kind: 'eip1559';
+    units?: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}
+export type EvmGasEstimateInit = EvmLegacyGasEstimateInit | EvmEip1559GasEstimateInit;
+/**
+ * Discriminated `EvmGasEstimate` — the `kind` field tells consumers which fee
+ * fields are populated. Iter-15 medium #4 fix: without the discriminant the
+ * legacy path returned `{gasPrice}` only and 1559 returned
+ * `{maxFeePerGas, maxPriorityFeePerGas}` only, but the type made both
+ * shapes look interchangeable. Consumers touching an undefined field on
+ * the wrong branch got runtime `undefined` with a non-null assertion
+ * silencing the type system.
+ *
+ * Type-guards: `isLegacyGasEstimate(g)` and `isEip1559GasEstimate(g)`
+ * narrow the estimate to its concrete shape at the call site.
+ */
+export declare class EvmGasEstimate {
+    readonly kind: EvmGasEstimateKind;
+    readonly units: bigint | undefined;
+    readonly gasPrice: bigint | undefined;
+    readonly maxFeePerGas: bigint | undefined;
+    readonly maxPriorityFeePerGas: bigint | undefined;
+    constructor(init: EvmGasEstimateInit);
+    effectiveGasPrice(): bigint;
+    nativeCost(): bigint | undefined;
+}
+export declare function isLegacyGasEstimate(g: EvmGasEstimate): g is EvmGasEstimate & {
+    kind: 'legacy';
+    gasPrice: bigint;
+};
+export declare function isEip1559GasEstimate(g: EvmGasEstimate): g is EvmGasEstimate & {
+    kind: 'eip1559';
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+//# sourceMappingURL=evm_gas_estimate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evm_gas_estimate.d.ts","sourceRoot":"","sources":["../../evm/evm_gas_estimate.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,yBAAyB,CAAC;AAEtF;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEtC,IAAI,EAAE,kBAAkB;IAqCpC,iBAAiB,IAAI,MAAM;IAY3B,UAAU,IAAI,MAAM,GAAG,SAAS;CAIjC;AAED,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,cAAc,GAChB,CAAC,IAAI,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAE5D;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,cAAc,GAChB,CAAC,IAAI,cAAc,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAE/F"}

package/dist/evm/evm_gas_estimate.js

@@ -0,0 +1,70 @@
+import { ChainError, ChainErrorKinds } from "../errors.js";
+/**
+ * Discriminated `EvmGasEstimate` — the `kind` field tells consumers which fee
+ * fields are populated. Iter-15 medium #4 fix: without the discriminant the
+ * legacy path returned `{gasPrice}` only and 1559 returned
+ * `{maxFeePerGas, maxPriorityFeePerGas}` only, but the type made both
+ * shapes look interchangeable. Consumers touching an undefined field on
+ * the wrong branch got runtime `undefined` with a non-null assertion
+ * silencing the type system.
+ *
+ * Type-guards: `isLegacyGasEstimate(g)` and `isEip1559GasEstimate(g)`
+ * narrow the estimate to its concrete shape at the call site.
+ */
+export class EvmGasEstimate {
+    kind;
+    units;
+    gasPrice;
+    maxFeePerGas;
+    maxPriorityFeePerGas;
+    constructor(init) {
+        this.kind = init.kind;
+        this.units = init.units;
+        if (init.kind === 'legacy') {
+            // Accept 0 for subsidised chains / devnets that report a zero
+            // gas price. EvmChain.suggestGas feeds node-reported values in
+            // directly; throwing here would turn a read-only estimate into
+            // an exception on any zero-fee network. Symmetric with
+            // EvmTransactionGasFees, which accepts 0 for the same fields.
+            if (init.gasPrice < 0n) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasEstimate(legacy).gasPrice must be >= 0, got ${init.gasPrice}`);
+            }
+            this.gasPrice = init.gasPrice;
+            this.maxFeePerGas = undefined;
+            this.maxPriorityFeePerGas = undefined;
+        }
+        else {
+            if (init.maxFeePerGas < 0n) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasEstimate(eip1559).maxFeePerGas must be >= 0, got ${init.maxFeePerGas}`);
+            }
+            if (init.maxPriorityFeePerGas < 0n) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasEstimate(eip1559).maxPriorityFeePerGas must be >= 0, got ${init.maxPriorityFeePerGas}`);
+            }
+            this.gasPrice = undefined;
+            this.maxFeePerGas = init.maxFeePerGas;
+            this.maxPriorityFeePerGas = init.maxPriorityFeePerGas;
+        }
+    }
+    effectiveGasPrice() {
+        // Discriminant narrowing — no cast needed. The constructor sets exactly
+        // one side of the shape based on `kind`, and the >= 0 validators
+        // guarantee both are bigints (never undefined) within their branch.
+        if (isLegacyGasEstimate(this))
+            return this.gasPrice;
+        if (isEip1559GasEstimate(this))
+            return this.maxFeePerGas;
+        throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasEstimate: unknown kind '${String(this.kind)}'`);
+    }
+    nativeCost() {
+        if (this.units === undefined)
+            return undefined;
+        return this.units * this.effectiveGasPrice();
+    }
+}
+export function isLegacyGasEstimate(g) {
+    return g.kind === 'legacy';
+}
+export function isEip1559GasEstimate(g) {
+    return g.kind === 'eip1559';
+}
+//# sourceMappingURL=evm_gas_estimate.js.map

package/dist/evm/evm_gas_estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm_gas_estimate.js","sourceRoot":"","sources":["../../evm/evm_gas_estimate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAmB3D;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,CAAqB;IACzB,KAAK,CAAqB;IAC1B,QAAQ,CAAqB;IAC7B,YAAY,CAAqB;IACjC,oBAAoB,CAAqB;IAElD,YAAY,IAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,8DAA8D;YAC9D,+DAA+D;YAC/D,+DAA+D;YAC/D,uDAAuD;YACvD,8DAA8D;YAC9D,IAAI,IAAI,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;gBACvB,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,qDAAqD,IAAI,CAAC,QAAQ,EAAE,CACrE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,CAAC,oBAAoB,GAAG,SAAS,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,YAAY,GAAG,EAAE,EAAE,CAAC;gBAC3B,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,0DAA0D,IAAI,CAAC,YAAY,EAAE,CAC9E,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,oBAAoB,GAAG,EAAE,EAAE,CAAC;gBACnC,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,kEAAkE,IAAI,CAAC,oBAAoB,EAAE,CAC9F,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACtC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACxD,CAAC;IACH,CAAC;IAED,iBAAiB;QACf,wEAAwE;QACxE,iEAAiE;QACjE,oEAAoE;QACpE,IAAI,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACpD,IAAI,oBAAoB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QACzD,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,iCAAiC,MAAM,CAAE,IAAyB,CAAC,IAAI,CAAC,GAAG,CAC5E,CAAC;IACJ,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC/C,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CACjC,CAAiB;IAEjB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,CAAiB;IAEjB,OAAO,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AAC9B,CAAC"}

package/dist/evm/evm_gas_pricing.d.ts

@@ -0,0 +1,40 @@
+import { AbstractGasPricing } from '../abstract_gas_pricing.ts';
+import { NetworkType } from '../network_type.ts';
+export interface EvmLegacyGasPricingInit {
+    kind: 'legacy';
+    gasPrice: bigint;
+}
+export interface EvmEip1559GasPricingInit {
+    kind: 'eip1559';
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}
+export type EvmGasPricingInit = EvmLegacyGasPricingInit | EvmEip1559GasPricingInit;
+/**
+ * EVM explicit-fee override — mirrors Python's `EvmGasPricing` at
+ * `impl/evm/base.py`. Discriminated by `kind` for the same reason
+ * `EvmGasEstimate` is: consumers reading `.gasPrice` on a 1559 pricing
+ * would otherwise silently get `undefined`.
+ *
+ * Legacy pricing populates `gasPrice`; EIP-1559 pricing populates
+ * `maxFeePerGas` + `maxPriorityFeePerGas`. Cross-branch reads are
+ * `undefined`.
+ */
+export declare class EvmGasPricing extends AbstractGasPricing {
+    readonly networkType = NetworkType.EVM;
+    readonly kind: 'legacy' | 'eip1559';
+    readonly gasPrice: bigint | undefined;
+    readonly maxFeePerGas: bigint | undefined;
+    readonly maxPriorityFeePerGas: bigint | undefined;
+    constructor(init: EvmGasPricingInit);
+}
+export declare function isLegacyGasPricing(p: EvmGasPricing): p is EvmGasPricing & {
+    kind: 'legacy';
+    gasPrice: bigint;
+};
+export declare function isEip1559GasPricing(p: EvmGasPricing): p is EvmGasPricing & {
+    kind: 'eip1559';
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+//# sourceMappingURL=evm_gas_pricing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evm_gas_pricing.d.ts","sourceRoot":"","sources":["../../evm/evm_gas_pricing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAEnF;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,kBAAkB;IACnD,QAAQ,CAAC,WAAW,mBAAmB;IACvC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEtC,IAAI,EAAE,iBAAiB;CAwCpC;AAED,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,aAAa,GACf,CAAC,IAAI,aAAa,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAE3D;AAED,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,aAAa,GACf,CAAC,IAAI,aAAa,GAAG;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAEA"}

package/dist/evm/evm_gas_pricing.js

@@ -0,0 +1,56 @@
+import { AbstractGasPricing } from "../abstract_gas_pricing.js";
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { NetworkType } from "../network_type.js";
+/**
+ * EVM explicit-fee override — mirrors Python's `EvmGasPricing` at
+ * `impl/evm/base.py`. Discriminated by `kind` for the same reason
+ * `EvmGasEstimate` is: consumers reading `.gasPrice` on a 1559 pricing
+ * would otherwise silently get `undefined`.
+ *
+ * Legacy pricing populates `gasPrice`; EIP-1559 pricing populates
+ * `maxFeePerGas` + `maxPriorityFeePerGas`. Cross-branch reads are
+ * `undefined`.
+ */
+export class EvmGasPricing extends AbstractGasPricing {
+    networkType = NetworkType.EVM;
+    kind;
+    gasPrice;
+    maxFeePerGas;
+    maxPriorityFeePerGas;
+    constructor(init) {
+        super();
+        this.kind = init.kind;
+        if (init.kind === 'legacy') {
+            if (init.gasPrice < 0n) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasPricing(legacy).gasPrice must be >= 0, got ${init.gasPrice}`);
+            }
+            this.gasPrice = init.gasPrice;
+            this.maxFeePerGas = undefined;
+            this.maxPriorityFeePerGas = undefined;
+        }
+        else {
+            if (init.maxFeePerGas < 0n) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasPricing(eip1559).maxFeePerGas must be >= 0, got ${init.maxFeePerGas}`);
+            }
+            if (init.maxPriorityFeePerGas < 0n) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasPricing(eip1559).maxPriorityFeePerGas must be >= 0, got ${init.maxPriorityFeePerGas}`);
+            }
+            // EIP-1559 invariant: maxPriorityFeePerGas must be <= maxFeePerGas.
+            // Every execution client enforces this at admission (a tx that
+            // violates it can never be mined). Fail loud at construction.
+            if (init.maxPriorityFeePerGas > init.maxFeePerGas) {
+                throw new ChainError(ChainErrorKinds.InvalidArgument, `EvmGasPricing(eip1559): maxPriorityFeePerGas (${init.maxPriorityFeePerGas}) must be <= maxFeePerGas (${init.maxFeePerGas}) per EIP-1559`);
+            }
+            this.gasPrice = undefined;
+            this.maxFeePerGas = init.maxFeePerGas;
+            this.maxPriorityFeePerGas = init.maxPriorityFeePerGas;
+        }
+    }
+}
+export function isLegacyGasPricing(p) {
+    return p.kind === 'legacy';
+}
+export function isEip1559GasPricing(p) {
+    return p.kind === 'eip1559';
+}
+//# sourceMappingURL=evm_gas_pricing.js.map

package/dist/evm/evm_gas_pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm_gas_pricing.js","sourceRoot":"","sources":["../../evm/evm_gas_pricing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAejD;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAc,SAAQ,kBAAkB;IAC1C,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC;IAC9B,IAAI,CAAuB;IAC3B,QAAQ,CAAqB;IAC7B,YAAY,CAAqB;IACjC,oBAAoB,CAAqB;IAElD,YAAY,IAAuB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;gBACvB,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,oDAAoD,IAAI,CAAC,QAAQ,EAAE,CACpE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,CAAC,oBAAoB,GAAG,SAAS,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,YAAY,GAAG,EAAE,EAAE,CAAC;gBAC3B,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,yDAAyD,IAAI,CAAC,YAAY,EAAE,CAC7E,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,oBAAoB,GAAG,EAAE,EAAE,CAAC;gBACnC,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,iEAAiE,IAAI,CAAC,oBAAoB,EAAE,CAC7F,CAAC;YACJ,CAAC;YACD,oEAAoE;YACpE,+DAA+D;YAC/D,8DAA8D;YAC9D,IAAI,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClD,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,iDAAiD,IAAI,CAAC,oBAAoB,8BAA8B,IAAI,CAAC,YAAY,gBAAgB,CAC1I,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACtC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAChC,CAAgB;IAEhB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,CAAgB;IAMhB,OAAO,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AAC9B,CAAC"}

package/dist/evm/evm_token.d.ts

@@ -0,0 +1,7 @@
+import { Token } from '../token.ts';
+export declare class EvmToken extends Token {
+    constructor(chainId: number, symbol: string, identifier: string | undefined, decimals: number);
+    static native(chainId: number, symbol: string, decimals?: number): EvmToken;
+    static erc20(chainId: number, symbol: string, contractAddress: string, decimals: number): EvmToken;
+}
+//# sourceMappingURL=evm_token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evm_token.d.ts","sourceRoot":"","sources":["../../evm/evm_token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,qBAAa,QAAS,SAAQ,KAAK;gBAE/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM;IAalB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,QAAQ;IAIvE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ;CAGnG"}

package/dist/evm/evm_token.js

@@ -0,0 +1,22 @@
+import { Token } from "../token.js";
+import { EvmAddress } from "./evm_address.js";
+export class EvmToken extends Token {
+    constructor(chainId, symbol, identifier, decimals) {
+        // Normalize identifier to EIP-55 checksum form so `sameAsset` /
+        // `strictEquals` / any Map<Token>-keyed logic sees the same key
+        // regardless of whether the consumer passed lowercase, uppercase,
+        // or mixed-case. Without this, a consumer building
+        // `new EvmToken(1, 'USDT', '0xdac1…' lowercase, 6)` would not compare
+        // equal to `ETHEREUM_USDT` and `requiresZeroResetApproval` would
+        // return false — silently reverting a USDT approve.
+        const normalized = identifier !== undefined ? new EvmAddress(identifier).toChecksum() : undefined;
+        super(chainId, symbol, normalized, decimals);
+    }
+    static native(chainId, symbol, decimals = 18) {
+        return new EvmToken(chainId, symbol, undefined, decimals);
+    }
+    static erc20(chainId, symbol, contractAddress, decimals) {
+        return new EvmToken(chainId, symbol, contractAddress, decimals);
+    }
+}
+//# sourceMappingURL=evm_token.js.map

package/dist/evm/evm_token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm_token.js","sourceRoot":"","sources":["../../evm/evm_token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YACE,OAAe,EACf,MAAc,EACd,UAA8B,EAC9B,QAAgB;QAEhB,gEAAgE;QAChE,gEAAgE;QAChE,kEAAkE;QAClE,mDAAmD;QACnD,sEAAsE;QACtE,iEAAiE;QACjE,oDAAoD;QACpD,MAAM,UAAU,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAClG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,MAAc,EAAE,QAAQ,GAAG,EAAE;QAC1D,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAe,EAAE,MAAc,EAAE,eAAuB,EAAE,QAAgB;QACrF,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/evm/evm_tokens.d.ts

@@ -0,0 +1,81 @@
+import { EvmToken } from './evm_token.ts';
+/**
+ * Pre-baked EvmToken instances. Mirrors
+ * omnichain-py/src/omnichain/impl/evm/assets.py — token-for-token.
+ * Each entry cites the Sinan source line.
+ */
+export declare const ETHEREUM_ETH: EvmToken;
+export declare const ETHEREUM_USDC: EvmToken;
+export declare const ETHEREUM_USDT: EvmToken;
+export declare const ETHEREUM_WETH: EvmToken;
+export declare const ETHEREUM_EURC: EvmToken;
+export declare const ETHEREUM_WBTC: EvmToken;
+export declare const SEPOLIA_TESTNET_ETH: EvmToken;
+export declare const SEPOLIA_TESTNET_USDC: EvmToken;
+export declare const SEPOLIA_TESTNET_EURC: EvmToken;
+export declare const OPTIMISM_ETH: EvmToken;
+export declare const OPTIMISM_USDC: EvmToken;
+export declare const ARBITRUM_ETH: EvmToken;
+export declare const ARBITRUM_USDC: EvmToken;
+export declare const ARBITRUM_USDT: EvmToken;
+export declare const ARBITRUM_WBTC: EvmToken;
+export declare const BNB_BNB: EvmToken;
+export declare const BNB_USDC: EvmToken;
+export declare const BNB_USDT: EvmToken;
+export declare const BASE_ETH: EvmToken;
+export declare const BASE_USDC: EvmToken;
+export declare const BASE_EURC: EvmToken;
+export declare const POLYGON_POL: EvmToken;
+export declare const POLYGON_USDC: EvmToken;
+export declare const AVALANCHE_AVAX: EvmToken;
+export declare const AVALANCHE_USDC: EvmToken;
+export declare const AVALANCHE_EURC: EvmToken;
+export declare const SONIC_S: EvmToken;
+export declare const SONIC_USDC: EvmToken;
+export declare const LINEA_ETH: EvmToken;
+export declare const LINEA_USDC: EvmToken;
+export declare const BLAST_ETH: EvmToken;
+export declare const BOBA_ETH: EvmToken;
+export declare const ZKSYNC_ETH: EvmToken;
+export declare const WORLDCHAIN_ETH: EvmToken;
+export declare const WORLDCHAIN_USDC: EvmToken;
+export declare const WORLDCHAIN_EURC: EvmToken;
+export declare const WANCHAIN_WAN: EvmToken;
+export declare const STABLE_USDT0: EvmToken;
+export declare const HYPEREVM_HYPER: EvmToken;
+export declare const HYPEREVM_USDC: EvmToken;
+export declare const CELO_CELO: EvmToken;
+export declare const CELO_USDC: EvmToken;
+export declare const SCROLL_ETH: EvmToken;
+export declare const CRONOS_CRO: EvmToken;
+export declare const ZORA_ETH: EvmToken;
+export declare const METIS_METIS: EvmToken;
+export declare const MODE_ETH: EvmToken;
+export declare const TAIKO_ETH: EvmToken;
+export declare const MONAD_MON: EvmToken;
+export declare const MONAD_USDC: EvmToken;
+export declare const MEGAETH_ETH: EvmToken;
+export declare const SEI_SEI: EvmToken;
+export declare const SEI_USDC: EvmToken;
+export declare const CELO_SEPOLIA_CELO: EvmToken;
+export declare const MOONBEAM_GLMR: EvmToken;
+/**
+ * ERC-20 assets that require zero-then-approve for a fresh allowance
+ * (USDT-on-Ethereum being the canonical example).
+ *
+ * Mirrors omnichain-py/impl/evm/assets.py:139
+ * (`EVM_ASSETS_REQUIRING_ZERO_RESET_APPROVAL`).
+ *
+ * Declarative list only — the SDK does not enforce an approval layer
+ * (Wallet/approvals architecture deferred to a follow-up). Consumer
+ * approval logic uses the `requiresZeroResetApproval(token)` predicate
+ * below.
+ */
+export declare const EVM_ASSETS_REQUIRING_ZERO_RESET_APPROVAL: ReadonlyArray<EvmToken>;
+/**
+ * Membership check using identifier-based equality (`Token.sameAsset`) rather
+ * than reference identity — so a caller who constructs their own USDT-Ethereum
+ * `EvmToken` instance still gets `true`.
+ */
+export declare function requiresZeroResetApproval(token: EvmToken): boolean;
+//# sourceMappingURL=evm_tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evm_tokens.d.ts","sourceRoot":"","sources":["../../evm/evm_tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiC1C;;;;GAIG;AAGH,eAAO,MAAM,YAAY,UAAuB,CAAC;AACjD,eAAO,MAAM,aAAa,UAAkF,CAAC;AAC7G,eAAO,MAAM,aAAa,UAAkF,CAAC;AAC7G,eAAO,MAAM,aAAa,UAAmF,CAAC;AAC9G,eAAO,MAAM,aAAa,UAAkF,CAAC;AAC7G,eAAO,MAAM,aAAa,UAAkF,CAAC;AAG7G,eAAO,MAAM,mBAAmB,UAAqC,CAAC;AACtE,eAAO,MAAM,oBAAoB,UAAgG,CAAC;AAClI,eAAO,MAAM,oBAAoB,UAAgG,CAAC;AAGlI,eAAO,MAAM,YAAY,UAAuB,CAAC;AACjD,eAAO,MAAM,aAAa,UAAkF,CAAC;AAG7G,eAAO,MAAM,YAAY,UAAuB,CAAC;AACjD,eAAO,MAAM,aAAa,UAAkF,CAAC;AAC7G,eAAO,MAAM,aAAa,UAAmF,CAAC;AAC9G,eAAO,MAAM,aAAa,UAAkF,CAAC;AAG7G,eAAO,MAAM,OAAO,UAAuB,CAAC;AAC5C,eAAO,MAAM,QAAQ,UAAmF,CAAC;AACzG,eAAO,MAAM,QAAQ,UAAmF,CAAC;AAGzG,eAAO,MAAM,QAAQ,UAAmB,CAAC;AACzC,eAAO,MAAM,SAAS,UAA8E,CAAC;AACrG,eAAO,MAAM,SAAS,UAA8E,CAAC;AAGrG,eAAO,MAAM,WAAW,UAAsB,CAAC;AAC/C,eAAO,MAAM,YAAY,UAAiF,CAAC;AAG3G,eAAO,MAAM,cAAc,UAAwB,CAAC;AACpD,eAAO,MAAM,cAAc,UAAmF,CAAC;AAC/G,eAAO,MAAM,cAAc,UAAmF,CAAC;AAG/G,eAAO,MAAM,OAAO,UAAoB,CAAC;AACzC,eAAO,MAAM,UAAU,UAA+E,CAAC;AAGvG,eAAO,MAAM,SAAS,UAAoB,CAAC;AAC3C,eAAO,MAAM,UAAU,UAA+E,CAAC;AAGvG,eAAO,MAAM,SAAS,UAAoB,CAAC;AAC3C,eAAO,MAAM,QAAQ,UAAmB,CAAC;AACzC,eAAO,MAAM,UAAU,UAAqB,CAAC;AAC7C,eAAO,MAAM,cAAc,UAAyB,CAAC;AAIrD,eAAO,MAAM,eAAe,UAAoF,CAAC;AACjH,eAAO,MAAM,eAAe,UAAoF,CAAC;AAGjH,eAAO,MAAM,YAAY,UAAuB,CAAC;AACjD,eAAO,MAAM,YAAY,UAAqB,CAAC;AAC/C,eAAO,MAAM,cAAc,UAAuB,CAAC;AACnD,eAAO,MAAM,aAAa,UAAkF,CAAC;AAG7G,eAAO,MAAM,SAAS,UAAmB,CAAC;AAC1C,eAAO,MAAM,SAAS,UAA8E,CAAC;AAGrG,eAAO,MAAM,UAAU,UAAqB,CAAC;AAC7C,eAAO,MAAM,UAAU,UAAqB,CAAC;AAC7C,eAAO,MAAM,QAAQ,UAAmB,CAAC;AACzC,eAAO,MAAM,WAAW,UAAoB,CAAC;AAC7C,eAAO,MAAM,QAAQ,UAAmB,CAAC;AACzC,eAAO,MAAM,SAAS,UAAoB,CAAC;AAG3C,eAAO,MAAM,SAAS,UAAoB,CAAC;AAC3C,eAAO,MAAM,UAAU,UAA+E,CAAC;AAGvG,eAAO,MAAM,WAAW,UAAsB,CAAC;AAG/C,eAAO,MAAM,OAAO,UAAkB,CAAC;AACvC,eAAO,MAAM,QAAQ,UAA6E,CAAC;AAGnG,eAAO,MAAM,iBAAiB,UAAiC,CAAC;AAChE,eAAO,MAAM,aAAa,UAAuB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wCAAwC,EAAE,aAAa,CAAC,QAAQ,CAAmB,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAElE"}

package/dist/evm/evm_tokens.js

@@ -0,0 +1,104 @@
+import { Arbitrum, Avalanche, Base, Blast, BnbChain, Boba, Celo, CeloSepoliaTestnet, Cronos, Ethereum, EthereumSepoliaTestnet, HyperEVM, Linea, MegaETH, Metis, Mode, Monad, MoonBeam, Optimism, Polygon, Scroll, Sei, Sonic, Stable, Taiko, WanChain, WorldChain, ZKSync, Zora, } from "./evm_chains.js";
+/**
+ * Pre-baked EvmToken instances. Mirrors
+ * omnichain-py/src/omnichain/impl/evm/assets.py — token-for-token.
+ * Each entry cites the Sinan source line.
+ */
+// assets.py:6-21 — Ethereum
+export const ETHEREUM_ETH = Ethereum.nativeToken;
+export const ETHEREUM_USDC = Ethereum.getErc20Token('USDC', '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', 6);
+export const ETHEREUM_USDT = Ethereum.getErc20Token('USDT', '0xdac17f958d2ee523a2206206994597c13d831ec7', 6);
+export const ETHEREUM_WETH = Ethereum.getErc20Token('WETH', '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2', 18);
+export const ETHEREUM_EURC = Ethereum.getErc20Token('EURC', '0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c', 6);
+export const ETHEREUM_WBTC = Ethereum.getErc20Token('WBTC', '0x2260fac5e5542a773aa44fbcfedf7c193bc2c599', 8);
+// assets.py:23-29 — Sepolia testnet
+export const SEPOLIA_TESTNET_ETH = EthereumSepoliaTestnet.nativeToken;
+export const SEPOLIA_TESTNET_USDC = EthereumSepoliaTestnet.getErc20Token('USDC', '0x1c7d4b196cb0c7b01d743fbc6116a902379c7238', 6);
+export const SEPOLIA_TESTNET_EURC = EthereumSepoliaTestnet.getErc20Token('EURC', '0x08210f9170f89ab7658f0b5e3ff39b0e03c594d4', 6);
+// assets.py:31-34 — Optimism
+export const OPTIMISM_ETH = Optimism.nativeToken;
+export const OPTIMISM_USDC = Optimism.getErc20Token('USDC', '0x0b2c639c533813f4aa9d7837caf62653d097ff85', 6);
+// assets.py:36-45 — Arbitrum. Symbol "USD₮0" mirrors Python's on-chain symbol.
+export const ARBITRUM_ETH = Arbitrum.nativeToken;
+export const ARBITRUM_USDC = Arbitrum.getErc20Token('USDC', '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', 6);
+export const ARBITRUM_USDT = Arbitrum.getErc20Token('USD₮0', '0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9', 6);
+export const ARBITRUM_WBTC = Arbitrum.getErc20Token('WBTC', '0x2f2a2543b76a4166549f7aab2e75bef0aefc5b0f', 8);
+// assets.py:47-53 — BNB
+export const BNB_BNB = BnbChain.nativeToken;
+export const BNB_USDC = BnbChain.getErc20Token('USDC', '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', 18);
+export const BNB_USDT = BnbChain.getErc20Token('USDT', '0x55d398326f99059fF775485246999027B3197955', 18);
+// assets.py:55-61 — Base
+export const BASE_ETH = Base.nativeToken;
+export const BASE_USDC = Base.getErc20Token('USDC', '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913', 6);
+export const BASE_EURC = Base.getErc20Token('EURC', '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42', 6);
+// assets.py:63-66 — Polygon
+export const POLYGON_POL = Polygon.nativeToken;
+export const POLYGON_USDC = Polygon.getErc20Token('USDC', '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359', 6);
+// assets.py:68-74 — Avalanche
+export const AVALANCHE_AVAX = Avalanche.nativeToken;
+export const AVALANCHE_USDC = Avalanche.getErc20Token('USDC', '0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e', 6);
+export const AVALANCHE_EURC = Avalanche.getErc20Token('EURC', '0xc891eb4cbdeff6e073e859e987815ed1505c2acd', 6);
+// assets.py:76-79 — Sonic
+export const SONIC_S = Sonic.nativeToken;
+export const SONIC_USDC = Sonic.getErc20Token('USDC', '0x29219dd400f2bf60e5a23d13be72b486d4038894', 6);
+// assets.py:81-84 — Linea
+export const LINEA_ETH = Linea.nativeToken;
+export const LINEA_USDC = Linea.getErc20Token('USDC', '0x176211869cA2b568f2A7D4EE941E073a821EE1ff', 6);
+// assets.py:86-96 — Blast / Boba / ZKSync / WorldChain
+export const BLAST_ETH = Blast.nativeToken;
+export const BOBA_ETH = Boba.nativeToken;
+export const ZKSYNC_ETH = ZKSync.nativeToken;
+export const WORLDCHAIN_ETH = WorldChain.nativeToken;
+// USDC uses lowercase to bypass EIP-55 mixed-case validation — Python
+// assets.py:94 mis-cases this literal; TS EvmAddress rejects mis-checksummed
+// mixed-case at import time. EURC's Python literal is already valid EIP-55.
+export const WORLDCHAIN_USDC = WorldChain.getErc20Token('USDC', '0x79a02482a880bce3f13e09da970dc34db4cd24d1', 6);
+export const WORLDCHAIN_EURC = WorldChain.getErc20Token('EURC', '0x1C60ba0A0eD1019e8Eb035E6daF4155A5cE2380B', 6);
+// assets.py:100-107 — Wan / Stable / HyperEVM
+export const WANCHAIN_WAN = WanChain.nativeToken;
+export const STABLE_USDT0 = Stable.nativeToken;
+export const HYPEREVM_HYPER = HyperEVM.nativeToken;
+export const HYPEREVM_USDC = HyperEVM.getErc20Token('USDC', '0xb88339CB7199b77E23DB6E890353E22632Ba630f', 6);
+// assets.py:109-112 — Celo
+export const CELO_CELO = Celo.nativeToken;
+export const CELO_USDC = Celo.getErc20Token('USDC', '0xcebA9300f2b948710d2653dD7B07f33A8B32118C', 6);
+// assets.py:114-125 — Scroll / Cronos / Zora / Metis / Mode / Taiko
+export const SCROLL_ETH = Scroll.nativeToken;
+export const CRONOS_CRO = Cronos.nativeToken;
+export const ZORA_ETH = Zora.nativeToken;
+export const METIS_METIS = Metis.nativeToken;
+export const MODE_ETH = Mode.nativeToken;
+export const TAIKO_ETH = Taiko.nativeToken;
+// assets.py:126-129 — Monad
+export const MONAD_MON = Monad.nativeToken;
+export const MONAD_USDC = Monad.getErc20Token('USDC', '0x754704Bc059F8C67012fEd69BC8A327a5aafb603', 6);
+// assets.py:131 — MegaETH
+export const MEGAETH_ETH = MegaETH.nativeToken;
+// assets.py:133-136 — Sei
+export const SEI_SEI = Sei.nativeToken;
+export const SEI_USDC = Sei.getErc20Token('USDC', '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392', 6);
+// Not in Python assets.py — native-only convenience for consumers.
+export const CELO_SEPOLIA_CELO = CeloSepoliaTestnet.nativeToken;
+export const MOONBEAM_GLMR = MoonBeam.nativeToken;
+/**
+ * ERC-20 assets that require zero-then-approve for a fresh allowance
+ * (USDT-on-Ethereum being the canonical example).
+ *
+ * Mirrors omnichain-py/impl/evm/assets.py:139
+ * (`EVM_ASSETS_REQUIRING_ZERO_RESET_APPROVAL`).
+ *
+ * Declarative list only — the SDK does not enforce an approval layer
+ * (Wallet/approvals architecture deferred to a follow-up). Consumer
+ * approval logic uses the `requiresZeroResetApproval(token)` predicate
+ * below.
+ */
+export const EVM_ASSETS_REQUIRING_ZERO_RESET_APPROVAL = [ETHEREUM_USDT];
+/**
+ * Membership check using identifier-based equality (`Token.sameAsset`) rather
+ * than reference identity — so a caller who constructs their own USDT-Ethereum
+ * `EvmToken` instance still gets `true`.
+ */
+export function requiresZeroResetApproval(token) {
+    return EVM_ASSETS_REQUIRING_ZERO_RESET_APPROVAL.some((a) => a.sameAsset(token));
+}
+//# sourceMappingURL=evm_tokens.js.map

package/dist/evm/evm_tokens.js.map

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

package/dist/evm/evm_transaction_status.d.ts

@@ -0,0 +1,108 @@
+import { NestedBalanceChanges, TransactionErrorInfo, TransactionStatus, TransactionStatusType } from '../transaction_status.ts';
+export interface EvmTransactionGasFeesInit {
+    /**
+     * The sender-set gas limit (`tx.gasLimit`). Nullable because the tx body
+     * may be unavailable (pruned node, receipt-only fetch); passing
+     * `gasLimitUsed` here as a fallback would fabricate a "100% utilization"
+     * that consumers can't distinguish from a real observation.
+     */
+    gasLimit: bigint | null;
+    gasLimitUsed: bigint;
+    effectiveGasPrice: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    /**
+     * OP-stack L1 data fee (wei) — present on Optimism / Base / Unichain /
+     * WorldChain / Boba / Sonic and other L2s that publish tx data to L1.
+     * Omitted on L1 chains. Included in the sender's native debit computed
+     * by `decodeBalanceChanges` when populated.
+     */
+    l1FeeWei?: bigint;
+}
+export declare class EvmTransactionGasFees {
+    readonly gasLimit: bigint | null;
+    readonly gasLimitUsed: bigint;
+    readonly effectiveGasPrice: bigint;
+    readonly gasPrice: bigint | undefined;
+    readonly maxFeePerGas: bigint | undefined;
+    readonly maxPriorityFeePerGas: bigint | undefined;
+    readonly l1FeeWei: bigint | undefined;
+    constructor(init: EvmTransactionGasFeesInit);
+    /** L2 execution gas only. Does NOT include OP-stack `l1FeeWei`. */
+    get totalGasInWei(): bigint;
+    /** Full sender native debit: L2 gas + OP-stack L1 data fee (when present). */
+    get totalNativeDebitWei(): bigint;
+}
+/**
+ * Canonical ERC-20 `Transfer(address indexed from, address indexed to,
+ * uint256 value)` topic0 — keccak256("Transfer(address,address,uint256)").
+ */
+export declare const ERC20_TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
+export interface EvmErc20TransferLog {
+    tokenContract: string;
+    fromAddress: string;
+    toAddress: string;
+    value: bigint;
+}
+/**
+ * Event log entry surfaced on a receipt. `isTransferLog()` / `asTransferLog()`
+ * mirror Python's `EvmParsedTransactionLog` API (`impl/evm/base.py:1551+`).
+ *
+ * The `evm_chain.ts` receipt-decoder shares the `ERC20_TRANSFER_TOPIC`
+ * topic0 constant with this class but runs its own **lenient** parse
+ * (skips non-standard logs) for the `NestedBalanceChanges` construction.
+ * This class's `asTransferLog()` is **strict** (throws on wrong length /
+ * bad hex). Rewiring the decoder to consume the strict accessor requires
+ * a policy decision on whether non-standard logs should silently drop
+ * or surface as `TransactionDecodeFailed`, and is deferred to a
+ * follow-up card. Consumers doing their own log extraction should
+ * either use the guard/accessor pair with a `try/catch` per log or
+ * wait for a `tryAsTransferLog()` variant to land.
+ */
+export declare class EvmParsedTransactionLog {
+    readonly address: string;
+    readonly topics: readonly string[];
+    readonly data: string;
+    constructor(address: string, topics: readonly string[], data: string);
+    isTransferLog(): boolean;
+    /**
+     * Decode this log as an ERC-20 Transfer. Throws
+     * `ChainError(InvalidArgument)` if the log doesn't match the topic0
+     * / topic-count shape, or `ChainError(TransactionDecodeFailed)` if
+     * `data` isn't parseable as a `uint256`. Addresses are returned
+     * lowercased (matches the `balanceChanges` wallet-key convention;
+     * consumers who need EIP-55 should checksum via `EvmAddress`).
+     */
+    asTransferLog(): EvmErc20TransferLog;
+}
+export interface EvmTransactionStatusInit {
+    chainId: number;
+    status: TransactionStatusType;
+    inclusionAt?: Date | null;
+    error?: TransactionErrorInfo | null;
+    balanceChanges?: NestedBalanceChanges | null;
+    logs?: readonly EvmParsedTransactionLog[] | null;
+    fees?: EvmTransactionGasFees | null;
+}
+export declare class EvmTransactionStatus extends TransactionStatus {
+    readonly logs: readonly EvmParsedTransactionLog[] | null;
+    readonly fees: EvmTransactionGasFees | null;
+    constructor(init: EvmTransactionStatusInit);
+    static successful(args: {
+        chainId: number;
+        inclusionAt: Date | null;
+        balanceChanges: NestedBalanceChanges;
+        logs: readonly EvmParsedTransactionLog[];
+        fees: EvmTransactionGasFees;
+    }): EvmTransactionStatus;
+    static failed(args: {
+        chainId: number;
+        inclusionAt: Date | null;
+        error: TransactionErrorInfo;
+        fees: EvmTransactionGasFees;
+    }): EvmTransactionStatus;
+    static pending(chainId: number): EvmTransactionStatus;
+    static notFound(chainId: number, error: TransactionErrorInfo | null): EvmTransactionStatus;
+}
+//# sourceMappingURL=evm_transaction_status.d.ts.map

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

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