ox 0.14.29 → 1.0.0-beta.0

package/dist/core/Ens.d.ts

@@ -0,0 +1,88 @@
+import * as Bytes from './Bytes.js';
+import * as Errors from './Errors.js';
+import * as Hash from './Hash.js';
+import * as Hex from './Hex.js';
+import * as internal from './internal/ens.js';
+/**
+ * Hashes ENS label.
+ *
+ * Since ENS labels prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS labels](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `labelhash`. You can use the built-in {@link ox#Ens.(normalize:function)} function for this.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ * Ens.labelhash('eth')
+ * ;('0x4f5b812789fc606be1b3b16908db13fc7a9adf7ca72641f84d75b47069d3d7f0')
+ * ```
+ *
+ * @param label - ENS label.
+ * @returns ENS labelhash.
+ */
+export declare function labelhash(label: string): `0x${string}`;
+export declare namespace labelhash {
+    type ErrorType = Hex.fromBytes.ErrorType | internal.unwrapLabelhash.ErrorType | Hash.keccak256.ErrorType | Hex.fromString.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Hashes ENS name.
+ *
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `namehash`. You can use the built-in {@link ox#Ens.(normalize:function)} function for this.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ * Ens.namehash('wevm.eth')
+ * // @log: '0xf246651c1b9a6b141d19c2604e9a58f567973833990f830d882534a747801359'
+ * ```
+ *
+ * @param name - ENS name.
+ * @returns ENS namehash.
+ */
+export declare function namehash(name: string): `0x${string}`;
+export declare namespace namehash {
+    type ErrorType = Hex.fromBytes.ErrorType | internal.unwrapLabelhash.ErrorType | Bytes.fromHex.ErrorType | Hash.keccak256.ErrorType | Bytes.fromString.ErrorType | Bytes.concat.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Normalizes ENS name according to [ENSIP-15](https://github.com/ensdomains/docs/blob/9edf9443de4333a0ea7ec658a870672d5d180d53/ens-improvement-proposals/ensip-15-normalization-standard.md).
+ *
+ * For more info see [ENS documentation](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) on name processing.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ * Ens.normalize('wevm.eth')
+ * // @log: 'wevm.eth'
+ * ```
+ *
+ * @param name - ENS name.
+ * @returns Normalized ENS name.
+ */
+export declare function normalize(name: string): string;
+export declare namespace normalize {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Converts a chain ID to an ENSIP-9 compliant coin type.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ *
+ * Ens.toCoinType(10n)
+ * // @log: 2147483658n
+ * ```
+ *
+ * @param chainId - Chain ID to convert.
+ * @returns ENS coin type.
+ */
+export declare function toCoinType(chainId: bigint): bigint;
+export declare namespace toCoinType {
+    type ErrorType = typeof InvalidChainIdError | Errors.GlobalErrorType;
+}
+/** Thrown when an ENS chain ID is invalid. */
+export declare class InvalidChainIdError extends Errors.BaseError {
+    readonly name = "Ens.InvalidChainIdError";
+    constructor({ chainId }: {
+        chainId: bigint;
+    });
+}
+//# sourceMappingURL=Ens.d.ts.map

package/dist/core/Ens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ens.d.ts","sourceRoot":"","sources":["../../src/core/Ens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAI7C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,iBAMtC;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,SAAS,GACV,GAAG,CAAC,SAAS,CAAC,SAAS,GACvB,QAAQ,CAAC,eAAe,CAAC,SAAS,GAClC,IAAI,CAAC,SAAS,CAAC,SAAS,GACxB,GAAG,CAAC,UAAU,CAAC,SAAS,GACxB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,iBAepC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAK,SAAS,GACV,GAAG,CAAC,SAAS,CAAC,SAAS,GACvB,QAAQ,CAAC,eAAe,CAAC,SAAS,GAClC,KAAK,CAAC,OAAO,CAAC,SAAS,GACvB,IAAI,CAAC,SAAS,CAAC,SAAS,GACxB,KAAK,CAAC,UAAU,CAAC,SAAS,GAC1B,KAAK,CAAC,MAAM,CAAC,SAAS,GACtB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAK,SAAS,GAAG,OAAO,mBAAmB,GAAG,MAAM,CAAC,eAAe,CAAA;CACrE;AAED,8CAA8C;AAC9C,qBAAa,mBAAoB,SAAQ,MAAM,CAAC,SAAS;IACvD,SAAkB,IAAI,6BAA4B;gBACtC,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;CAK7C"}

package/dist/core/Ens.js

@@ -0,0 +1,107 @@
+import { ens_normalize } from '@adraffy/ens-normalize';
+import * as Bytes from './Bytes.js';
+import * as Errors from './Errors.js';
+import * as Hash from './Hash.js';
+import * as Hex from './Hex.js';
+import * as internal from './internal/ens.js';
+const slip44Msb = 0x80000000n;
+/**
+ * Hashes ENS label.
+ *
+ * Since ENS labels prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS labels](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `labelhash`. You can use the built-in {@link ox#Ens.(normalize:function)} function for this.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ * Ens.labelhash('eth')
+ * ;('0x4f5b812789fc606be1b3b16908db13fc7a9adf7ca72641f84d75b47069d3d7f0')
+ * ```
+ *
+ * @param label - ENS label.
+ * @returns ENS labelhash.
+ */
+export function labelhash(label) {
+    const result = new Uint8Array(32).fill(0);
+    if (!label)
+        return Hex.fromBytes(result);
+    return (internal.unwrapLabelhash(label) || Hash.keccak256(Hex.fromString(label)));
+}
+/**
+ * Hashes ENS name.
+ *
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `namehash`. You can use the built-in {@link ox#Ens.(normalize:function)} function for this.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ * Ens.namehash('wevm.eth')
+ * // @log: '0xf246651c1b9a6b141d19c2604e9a58f567973833990f830d882534a747801359'
+ * ```
+ *
+ * @param name - ENS name.
+ * @returns ENS namehash.
+ */
+export function namehash(name) {
+    let result = new Uint8Array(32).fill(0);
+    if (!name)
+        return Hex.fromBytes(result);
+    const labels = name.split('.');
+    // Iterate in reverse order building up hash
+    for (let i = labels.length - 1; i >= 0; i -= 1) {
+        const hashFromEncodedLabel = internal.unwrapLabelhash(labels[i]);
+        const hashed = hashFromEncodedLabel
+            ? Bytes.fromHex(hashFromEncodedLabel)
+            : Hash.keccak256(Bytes.fromString(labels[i]), { as: 'Bytes' });
+        result = Hash.keccak256(Bytes.concat(result, hashed), { as: 'Bytes' });
+    }
+    return Hex.fromBytes(result);
+}
+/**
+ * Normalizes ENS name according to [ENSIP-15](https://github.com/ensdomains/docs/blob/9edf9443de4333a0ea7ec658a870672d5d180d53/ens-improvement-proposals/ensip-15-normalization-standard.md).
+ *
+ * For more info see [ENS documentation](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) on name processing.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ * Ens.normalize('wevm.eth')
+ * // @log: 'wevm.eth'
+ * ```
+ *
+ * @param name - ENS name.
+ * @returns Normalized ENS name.
+ */
+export function normalize(name) {
+    return ens_normalize(name);
+}
+/**
+ * Converts a chain ID to an ENSIP-9 compliant coin type.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Ens } from 'ox'
+ *
+ * Ens.toCoinType(10n)
+ * // @log: 2147483658n
+ * ```
+ *
+ * @param chainId - Chain ID to convert.
+ * @returns ENS coin type.
+ */
+export function toCoinType(chainId) {
+    if (chainId === 1n)
+        return 60n;
+    if (chainId >= slip44Msb || chainId < 0n)
+        throw new InvalidChainIdError({ chainId });
+    return slip44Msb | chainId;
+}
+/** Thrown when an ENS chain ID is invalid. */
+export class InvalidChainIdError extends Errors.BaseError {
+    name = 'Ens.InvalidChainIdError';
+    constructor({ chainId }) {
+        super(`Invalid ENSIP-11 chain ID: ${chainId}.`, {
+            metaMessages: ['Must be between 0 and 0x7fffffff, or 1.'],
+        });
+    }
+}
+//# sourceMappingURL=Ens.js.map

package/dist/core/Ens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ens.js","sourceRoot":"","sources":["../../src/core/Ens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAE7C,MAAM,SAAS,GAAG,WAAW,CAAA;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACxC,OAAO,CACL,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CACzE,CAAA;AACH,CAAC;AAWD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,4CAA4C;IAC5C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,oBAAoB,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAA;QACjE,MAAM,MAAM,GAAG,oBAAoB;YACjC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;QACjE,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IACxE,CAAC;IAED,OAAO,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAaD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,GAAG,CAAA;IAC9B,IAAI,OAAO,IAAI,SAAS,IAAI,OAAO,GAAG,EAAE;QACtC,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAC5C,OAAO,SAAS,GAAG,OAAO,CAAA;AAC5B,CAAC;AAMD,8CAA8C;AAC9C,MAAM,OAAO,mBAAoB,SAAQ,MAAM,CAAC,SAAS;IACrC,IAAI,GAAG,yBAAyB,CAAA;IAClD,YAAY,EAAE,OAAO,EAAuB;QAC1C,KAAK,CAAC,8BAA8B,OAAO,GAAG,EAAE;YAC9C,YAAY,EAAE,CAAC,yCAAyC,CAAC;SAC1D,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/core/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../src/core/Errors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,CAAC,IAAI,SAAS,MAAM,GAAG,OAAO,IAAI,KAAK,GAAG;IACnE,IAAI,EAAE,IAAI,CAAA;CACX,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS,CACpB,KAAK,SAAS,KAAK,GAAG,SAAS,GAAG,SAAS,CAC3C,SAAQ,KAAK;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAEnB,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,SAAc;IAE3B,MAAM,CAAC,oBAAoB;;;;MAIQ;IAEnC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,aAAa;gBAU5C,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAM;IAuDxE,IAAI,IAAI,KAAK;IACb,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,KAAK,GAAG,IAAI;CAIlD;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,OAAO,CAAC,KAAK,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,IAAI;QAClE,0BAA0B;QAC1B,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;QACzB,4BAA4B;QAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,0BAA0B;QAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,wBAAwB;QACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,yCAAyC;QACzC,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,SAAS,CAAA;QACjD,wDAAwD;QACxD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;IAED,KAAK,aAAa,GAAG;QACnB,0BAA0B;QAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,uEAAuE;QACvE,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACjC,wDAAwD;QACxD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF"}

package/dist/core/Errors.js

@@ -0,0 +1,95 @@
+import { getVersion } from './internal/errors.js';
+/**
+ * Base error class inherited by all errors thrown by ox.
+ *
+ * @example
+ * ```ts
+ * import { Errors } from 'ox'
+ * throw new Errors.BaseError('An error occurred')
+ * ```
+ */
+export class BaseError extends Error {
+    details;
+    docs;
+    docsOrigin;
+    docsPath;
+    shortMessage;
+    showVersion;
+    version;
+    cause;
+    name = 'BaseError';
+    static defaultStaticOptions = {
+        docsOrigin: 'https://oxlib.sh',
+        showVersion: false,
+        version: `ox@${getVersion()}`,
+    };
+    static setStaticOptions(options) {
+        BaseError.prototype.docsOrigin = options.docsOrigin;
+        BaseError.prototype.showVersion = options.showVersion;
+        BaseError.prototype.version = options.version;
+    }
+    static {
+        BaseError.setStaticOptions(BaseError.defaultStaticOptions);
+    }
+    constructor(shortMessage, options = {}) {
+        const details = (() => {
+            if (options.cause instanceof BaseError) {
+                if (options.cause.details)
+                    return options.cause.details;
+                if (options.cause.shortMessage)
+                    return options.cause.shortMessage;
+            }
+            if (options.cause &&
+                'details' in options.cause &&
+                typeof options.cause.details === 'string')
+                return options.cause.details;
+            if (options.cause?.message)
+                return options.cause.message;
+            return options.details;
+        })();
+        const docsPath = (() => {
+            if (options.cause instanceof BaseError)
+                return options.cause.docsPath || options.docsPath;
+            return options.docsPath;
+        })();
+        const docsBaseUrl = options.docsOrigin ?? BaseError.prototype.docsOrigin;
+        const docs = `${docsBaseUrl}${docsPath ?? ''}`;
+        const showVersion = Boolean(options.version ?? BaseError.prototype.showVersion);
+        const version = options.version ?? BaseError.prototype.version;
+        const message = [
+            shortMessage || 'An error occurred.',
+            ...(options.metaMessages ? ['', ...options.metaMessages] : []),
+            ...(details || docsPath || showVersion
+                ? [
+                    '',
+                    details ? `Details: ${details}` : undefined,
+                    docsPath ? `See: ${docs}` : undefined,
+                    showVersion ? `Version: ${version}` : undefined,
+                ]
+                : []),
+        ]
+            .filter((x) => typeof x === 'string')
+            .join('\n');
+        super(message, options.cause ? { cause: options.cause } : undefined);
+        this.cause = options.cause;
+        this.details = details;
+        this.docs = docs;
+        this.docsOrigin = docsBaseUrl;
+        this.docsPath = docsPath;
+        this.shortMessage = shortMessage;
+        this.showVersion = showVersion;
+        this.version = version;
+    }
+    walk(fn) {
+        return walk(this, fn);
+    }
+}
+/** @internal */
+function walk(err, fn) {
+    if (fn?.(err))
+        return err;
+    if (err && typeof err === 'object' && 'cause' in err && err.cause)
+        return walk(err.cause, fn);
+    return fn ? null : err;
+}
+//# sourceMappingURL=Errors.js.map

package/dist/core/Errors.js.map

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

package/dist/core/Fee.d.ts

@@ -0,0 +1,172 @@
+import type * as Errors from './Errors.js';
+import * as Hex from './Hex.js';
+import type { Compute, OneOf } from './internal/types.js';
+export type FeeHistory<bigintType = bigint> = Compute<{
+    /**
+     * An array of block base fees per gas (in wei). This includes the next block after
+     * the newest of the returned range, because this value can be derived from the newest block.
+     * Zeroes are returned for pre-EIP-1559 blocks. */
+    baseFeePerGas: bigintType[];
+    /** An array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit. */
+    gasUsedRatio: number[];
+    /** Lowest number block of the returned range. */
+    oldestBlock: bigintType;
+    /** An array of effective priority fees (in wei) per gas data points from a single block. All zeroes are returned if the block is empty. */
+    reward?: bigintType[][] | undefined;
+}>;
+export type FeeHistoryRpc = FeeHistory<Hex.Hex>;
+export type FeeValuesLegacy<bigintType = bigint> = {
+    /** Base fee per gas. */
+    gasPrice: bigintType;
+};
+export type FeeValuesLegacyRpc = FeeValuesLegacy<Hex.Hex>;
+export type FeeValuesEip1559<bigintType = bigint> = {
+    /** Total fee per gas in wei (gasPrice/baseFeePerGas + maxPriorityFeePerGas). */
+    maxFeePerGas: bigintType;
+    /** Max priority fee per gas (in wei). */
+    maxPriorityFeePerGas: bigintType;
+};
+export type FeeValuesEip1559Rpc = FeeValuesEip1559<Hex.Hex>;
+export type FeeValuesEip4844<bigintType = bigint> = {
+    /** Maximum total fee per gas sender is willing to pay for blob gas (in wei). */
+    maxFeePerBlobGas: bigintType;
+    /** Total fee per gas in wei (gasPrice/baseFeePerGas + maxPriorityFeePerGas). */
+    maxFeePerGas: bigintType;
+    /** Max priority fee per gas (in wei). */
+    maxPriorityFeePerGas: bigintType;
+};
+export type FeeValuesEip4844Rpc = FeeValuesEip4844<Hex.Hex>;
+export type FeeValues<bigintType = bigint> = OneOf<FeeValuesLegacy<bigintType> | FeeValuesEip1559<bigintType> | FeeValuesEip4844<bigintType>>;
+export type FeeValuesRpc = OneOf<FeeValuesLegacyRpc | FeeValuesEip1559Rpc | FeeValuesEip4844Rpc>;
+export type FeeValuesType = 'legacy' | 'eip1559' | 'eip4844';
+/**
+ * Converts a {@link ox#Fee.FeeHistoryRpc} to a {@link ox#Fee.FeeHistory}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * const history = Fee.fromHistoryRpc({
+ *   baseFeePerGas: ['0x01', '0x02'],
+ *   gasUsedRatio: [0.5, 0.6],
+ *   oldestBlock: '0x10',
+ *   reward: [['0x01']]
+ * })
+ * // @log: { baseFeePerGas: [1n, 2n], gasUsedRatio: [0.5, 0.6], oldestBlock: 16n, reward: [[1n]] }
+ * ```
+ *
+ * @param history - The RPC fee history to convert.
+ * @returns An instantiated {@link ox#Fee.FeeHistory}.
+ */
+export declare function fromHistoryRpc(history: FeeHistoryRpc): FeeHistory;
+export declare namespace fromHistoryRpc {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Converts a {@link ox#Fee.FeeHistory} to a {@link ox#Fee.FeeHistoryRpc}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * const rpc = Fee.toHistoryRpc({
+ *   baseFeePerGas: [1n, 2n],
+ *   gasUsedRatio: [0.5, 0.6],
+ *   oldestBlock: 16n,
+ *   reward: [[1n]]
+ * })
+ * ```
+ *
+ * @param history - The fee history to convert.
+ * @returns An RPC fee history.
+ */
+export declare function toHistoryRpc(history: FeeHistory): FeeHistoryRpc;
+export declare namespace toHistoryRpc {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Estimates a `maxFeePerGas` from a base fee, a priority tip, and a multiplier
+ * applied to the base fee:
+ *
+ * ```
+ * maxFeePerGas = baseFeePerGas * multiplier + maxPriorityFeePerGas
+ * ```
+ *
+ * The multiplier is supplied as `multiplierNumerator / multiplierDenominator`
+ * to keep the math in `bigint`. The default is `2 / 1` (i.e. 2x), matching the
+ * common wallet/relay heuristic for headroom against base-fee bumps.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * Fee.estimateMaxFeePerGas({
+ *   baseFeePerGas: 100n,
+ *   maxPriorityFeePerGas: 5n
+ * })
+ * // @log: 205n
+ *
+ * Fee.estimateMaxFeePerGas({
+ *   baseFeePerGas: 100n,
+ *   maxPriorityFeePerGas: 5n,
+ *   multiplierNumerator: 3n,
+ *   multiplierDenominator: 2n
+ * })
+ * // @log: 155n  (= 100n * 3n / 2n + 5n)
+ * ```
+ *
+ * @param args.baseFeePerGas - Block base fee per gas.
+ * @param args.maxPriorityFeePerGas - Tip per gas.
+ * @param args.multiplierNumerator - Numerator of the base-fee multiplier (default `2n`).
+ * @param args.multiplierDenominator - Denominator of the base-fee multiplier (default `1n`).
+ * @returns Suggested `maxFeePerGas`.
+ */
+export declare function estimateMaxFeePerGas(args: {
+    baseFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    multiplierNumerator?: bigint | undefined;
+    multiplierDenominator?: bigint | undefined;
+}): bigint;
+export declare namespace estimateMaxFeePerGas {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Computes the effective gas price an EIP-1559 transaction will pay:
+ *
+ * ```
+ * effective = min(maxFeePerGas, baseFeePerGas + maxPriorityFeePerGas)
+ * ```
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * Fee.effectiveGasPrice({
+ *   baseFeePerGas: 100n,
+ *   maxFeePerGas: 200n,
+ *   maxPriorityFeePerGas: 50n
+ * })
+ * // @log: 150n  (= 100n + 50n)
+ *
+ * Fee.effectiveGasPrice({
+ *   baseFeePerGas: 100n,
+ *   maxFeePerGas: 120n,
+ *   maxPriorityFeePerGas: 50n
+ * })
+ * // @log: 120n  (capped at maxFeePerGas)
+ * ```
+ *
+ * @param args.baseFeePerGas - Block base fee per gas.
+ * @param args.maxFeePerGas - Sender-supplied `maxFeePerGas`.
+ * @param args.maxPriorityFeePerGas - Sender-supplied tip.
+ * @returns Effective gas price (in wei).
+ */
+export declare function effectiveGasPrice(args: {
+    baseFeePerGas: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}): bigint;
+export declare namespace effectiveGasPrice {
+    type ErrorType = Errors.GlobalErrorType;
+}
+//# sourceMappingURL=Fee.d.ts.map

package/dist/core/Fee.d.ts.map

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

package/dist/core/Fee.js

@@ -0,0 +1,141 @@
+import * as Hex from './Hex.js';
+/**
+ * Converts a {@link ox#Fee.FeeHistoryRpc} to a {@link ox#Fee.FeeHistory}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * const history = Fee.fromHistoryRpc({
+ *   baseFeePerGas: ['0x01', '0x02'],
+ *   gasUsedRatio: [0.5, 0.6],
+ *   oldestBlock: '0x10',
+ *   reward: [['0x01']]
+ * })
+ * // @log: { baseFeePerGas: [1n, 2n], gasUsedRatio: [0.5, 0.6], oldestBlock: 16n, reward: [[1n]] }
+ * ```
+ *
+ * @param history - The RPC fee history to convert.
+ * @returns An instantiated {@link ox#Fee.FeeHistory}.
+ */
+export function fromHistoryRpc(history) {
+    return {
+        baseFeePerGas: history.baseFeePerGas.map((value) => BigInt(value)),
+        gasUsedRatio: history.gasUsedRatio,
+        oldestBlock: BigInt(history.oldestBlock),
+        ...(history.reward
+            ? {
+                reward: history.reward.map((row) => row.map((value) => BigInt(value))),
+            }
+            : {}),
+    };
+}
+/**
+ * Converts a {@link ox#Fee.FeeHistory} to a {@link ox#Fee.FeeHistoryRpc}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * const rpc = Fee.toHistoryRpc({
+ *   baseFeePerGas: [1n, 2n],
+ *   gasUsedRatio: [0.5, 0.6],
+ *   oldestBlock: 16n,
+ *   reward: [[1n]]
+ * })
+ * ```
+ *
+ * @param history - The fee history to convert.
+ * @returns An RPC fee history.
+ */
+export function toHistoryRpc(history) {
+    return {
+        baseFeePerGas: history.baseFeePerGas.map((value) => Hex.fromNumber(value)),
+        gasUsedRatio: history.gasUsedRatio,
+        oldestBlock: Hex.fromNumber(history.oldestBlock),
+        ...(history.reward
+            ? {
+                reward: history.reward.map((row) => row.map((value) => Hex.fromNumber(value))),
+            }
+            : {}),
+    };
+}
+/**
+ * Estimates a `maxFeePerGas` from a base fee, a priority tip, and a multiplier
+ * applied to the base fee:
+ *
+ * ```
+ * maxFeePerGas = baseFeePerGas * multiplier + maxPriorityFeePerGas
+ * ```
+ *
+ * The multiplier is supplied as `multiplierNumerator / multiplierDenominator`
+ * to keep the math in `bigint`. The default is `2 / 1` (i.e. 2x), matching the
+ * common wallet/relay heuristic for headroom against base-fee bumps.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * Fee.estimateMaxFeePerGas({
+ *   baseFeePerGas: 100n,
+ *   maxPriorityFeePerGas: 5n
+ * })
+ * // @log: 205n
+ *
+ * Fee.estimateMaxFeePerGas({
+ *   baseFeePerGas: 100n,
+ *   maxPriorityFeePerGas: 5n,
+ *   multiplierNumerator: 3n,
+ *   multiplierDenominator: 2n
+ * })
+ * // @log: 155n  (= 100n * 3n / 2n + 5n)
+ * ```
+ *
+ * @param args.baseFeePerGas - Block base fee per gas.
+ * @param args.maxPriorityFeePerGas - Tip per gas.
+ * @param args.multiplierNumerator - Numerator of the base-fee multiplier (default `2n`).
+ * @param args.multiplierDenominator - Denominator of the base-fee multiplier (default `1n`).
+ * @returns Suggested `maxFeePerGas`.
+ */
+export function estimateMaxFeePerGas(args) {
+    const { baseFeePerGas, maxPriorityFeePerGas, multiplierNumerator = 2n, multiplierDenominator = 1n, } = args;
+    return ((baseFeePerGas * multiplierNumerator) / multiplierDenominator +
+        maxPriorityFeePerGas);
+}
+/**
+ * Computes the effective gas price an EIP-1559 transaction will pay:
+ *
+ * ```
+ * effective = min(maxFeePerGas, baseFeePerGas + maxPriorityFeePerGas)
+ * ```
+ *
+ * @example
+ * ```ts twoslash
+ * import { Fee } from 'ox'
+ *
+ * Fee.effectiveGasPrice({
+ *   baseFeePerGas: 100n,
+ *   maxFeePerGas: 200n,
+ *   maxPriorityFeePerGas: 50n
+ * })
+ * // @log: 150n  (= 100n + 50n)
+ *
+ * Fee.effectiveGasPrice({
+ *   baseFeePerGas: 100n,
+ *   maxFeePerGas: 120n,
+ *   maxPriorityFeePerGas: 50n
+ * })
+ * // @log: 120n  (capped at maxFeePerGas)
+ * ```
+ *
+ * @param args.baseFeePerGas - Block base fee per gas.
+ * @param args.maxFeePerGas - Sender-supplied `maxFeePerGas`.
+ * @param args.maxPriorityFeePerGas - Sender-supplied tip.
+ * @returns Effective gas price (in wei).
+ */
+export function effectiveGasPrice(args) {
+    const { baseFeePerGas, maxFeePerGas, maxPriorityFeePerGas } = args;
+    const ceiling = baseFeePerGas + maxPriorityFeePerGas;
+    return ceiling < maxFeePerGas ? ceiling : maxFeePerGas;
+}
+//# sourceMappingURL=Fee.js.map

package/dist/core/Fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fee.js","sourceRoot":"","sources":["../../src/core/Fee.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AA0D/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClE,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;QACxC,GAAG,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC;gBACE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACjC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAClC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAmB;IAC9C,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1E,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC;gBACE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACjC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAC1C;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAKpC;IACC,MAAM,EACJ,aAAa,EACb,oBAAoB,EACpB,mBAAmB,GAAG,EAAE,EACxB,qBAAqB,GAAG,EAAE,GAC3B,GAAG,IAAI,CAAA;IACR,OAAO,CACL,CAAC,aAAa,GAAG,mBAAmB,CAAC,GAAG,qBAAqB;QAC7D,oBAAoB,CACrB,CAAA;AACH,CAAC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAA;IAClE,MAAM,OAAO,GAAG,aAAa,GAAG,oBAAoB,CAAA;IACpD,OAAO,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAA;AACxD,CAAC"}