ox 0.0.1 → 0.1.0

package/_types/ContractAddress.d.ts

@@ -0,0 +1,115 @@
+import * as Address from './Address.js';
+import * as Bytes from './Bytes.js';
+import type * as Errors from './Errors.js';
+import * as Hash from './Hash.js';
+import * as Hex from './Hex.js';
+import * as Rlp from './Rlp.js';
+import type { OneOf } from './internal/types.js';
+/**
+ * Computes Contract Address generated by the [CREATE](https://ethereum.stackexchange.com/questions/68943/create-opcode-what-does-it-really-do/68945#68945) or [CREATE2](https://eips.ethereum.org/EIPS/eip-1014) opcode.
+ *
+ * @example
+ * ### CREATE
+ *
+ * Computes via the [CREATE](https://ethereum.stackexchange.com/questions/68943/create-opcode-what-does-it-really-do/68945#68945) opcode. Shorthand for {@link ox#ContractAddress.(fromCreate:function)}.
+ *
+ * ```ts twoslash
+ * import { ContractAddress } from 'ox'
+ * ContractAddress.from({
+ *   from: '0x1a1e021a302c237453d3d45c7b82b19ceeb7e2e6',
+ *   nonce: 0n,
+ * })
+ * // @log: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2'
+ * ```
+ *
+ * @example
+ * ### CREATE2
+ *
+ * Computes via the [CREATE2](https://eips.ethereum.org/EIPS/eip-1014) opcode. Shorthand for {@link ox#ContractAddress.(fromCreate2:function)}.
+ *
+ * ```ts twoslash
+ * import { ContractAddress, Hex } from 'ox'
+ * ContractAddress.from({
+ *   from: '0x1a1e021a302c237453d3d45c7b82b19ceeb7e2e6',
+ *   bytecode: '0x6394198df16000526103ff60206004601c335afa6040516060f3',
+ *   salt: Hex.fromString('hello world'),
+ * })
+ * // @log: '0x59fbB593ABe27Cb193b6ee5C5DC7bbde312290aB'
+ * ```
+ *
+ * @param options - Options.
+ * @returns Contract Address.
+ */
+export declare function from(options: from.Options): Address.Address;
+export declare namespace from {
+    var parseError: (error: unknown) => from.ErrorType;
+}
+export declare namespace from {
+    type Options = OneOf<fromCreate.Options | fromCreate2.Options>;
+    type ErrorType = fromCreate.ErrorType | fromCreate2.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Computes contract address via [CREATE](https://ethereum.stackexchange.com/questions/68943/create-opcode-what-does-it-really-do/68945#68945) opcode.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ContractAddress } from 'ox'
+ *
+ * ContractAddress.fromCreate({
+ *   from: '0x1a1e021a302c237453d3d45c7b82b19ceeb7e2e6',
+ *   nonce: 0n,
+ * })
+ * // @log: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2'
+ * ```
+ *
+ * @param options - Options for retrieving address.
+ * @returns Contract Address.
+ */
+export declare function fromCreate(options: fromCreate.Options): Address.Address;
+export declare namespace fromCreate {
+    var parseError: (error: unknown) => fromCreate.ErrorType;
+}
+export declare namespace fromCreate {
+    type Options = {
+        /** The address the contract was deployed from. */
+        from: Address.Address;
+        /** The nonce of the transaction which deployed the contract. */
+        nonce: bigint;
+    };
+    type ErrorType = Hash.keccak256.ErrorType | Address.from.ErrorType | Bytes.fromHex.ErrorType | Bytes.fromNumber.ErrorType | Rlp.fromBytes.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Computes contract address via [CREATE2](https://eips.ethereum.org/EIPS/eip-1014) opcode.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ContractAddress, Hex } from 'ox'
+ *
+ * ContractAddress.fromCreate2({
+ *   from: '0x1a1e021a302c237453d3d45c7b82b19ceeb7e2e6',
+ *   bytecode: '0x6394198df16000526103ff60206004601c335afa6040516060f3',
+ *   salt: Hex.fromString('hello world'),
+ * })
+ * // @log: '0x59fbB593ABe27Cb193b6ee5C5DC7bbde312290aB'
+ * ```
+ *
+ * @param options - Options for retrieving address.
+ * @returns Contract Address.
+ */
+export declare function fromCreate2(options: fromCreate2.Options): Address.Address;
+export declare namespace fromCreate2 {
+    var parseError: (error: unknown) => fromCreate2.ErrorType;
+}
+export declare namespace fromCreate2 {
+    type Options = {
+        bytecode: Bytes.Bytes | Hex.Hex;
+        from: Address.Address;
+        salt: Bytes.Bytes | Hex.Hex;
+    } | {
+        bytecodeHash: Bytes.Bytes | Hex.Hex;
+        from: Address.Address;
+        salt: Bytes.Bytes | Hex.Hex;
+    };
+    type ErrorType = Address.from.ErrorType | Bytes.concat.ErrorType | Bytes.validate.ErrorType | Bytes.padLeft.ErrorType | Hash.keccak256.ErrorType | Hex.slice.ErrorType | Bytes.fromHex.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=ContractAddress.d.ts.map

package/_types/ContractAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractAddress.d.ts","sourceRoot":"","sources":["../ContractAddress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAG3D;yBAHe,IAAI;4BAcM,OAAO,KAEtB,IAAI,CAAC,SAAS;;AAXzB,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAY,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IAErE,KAAK,SAAS,GACV,UAAU,CAAC,SAAS,GACpB,WAAW,CAAC,SAAS,GACrB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CASvE;yBATe,UAAU;4BA4BM,OAAO,KAE5B,UAAU,CAAC,SAAS;;AAnB/B,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAK,OAAO,GAAG;QACb,kDAAkD;QAClD,IAAI,EAAE,OAAO,CAAC,OAAO,CAAA;QACrB,gEAAgE;QAChE,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IAED,KAAK,SAAS,GACV,IAAI,CAAC,SAAS,CAAC,SAAS,GACxB,OAAO,CAAC,IAAI,CAAC,SAAS,GACtB,KAAK,CAAC,OAAO,CAAC,SAAS,GACvB,KAAK,CAAC,UAAU,CAAC,SAAS,GAC1B,GAAG,CAAC,SAAS,CAAC,SAAS,GACvB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAwBzE;yBAxBe,WAAW;4BAkDM,OAAO,KAE7B,WAAW,CAAC,SAAS;;AA1BhC,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,KAAK,OAAO,GACR;QACE,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAA;QAC/B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAA;QACrB,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAA;KAC5B,GACD;QACE,YAAY,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAA;QACnC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAA;QACrB,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAA;KAC5B,CAAA;IAEL,KAAK,SAAS,GACV,OAAO,CAAC,IAAI,CAAC,SAAS,GACtB,KAAK,CAAC,MAAM,CAAC,SAAS,GACtB,KAAK,CAAC,QAAQ,CAAC,SAAS,GACxB,KAAK,CAAC,OAAO,CAAC,SAAS,GACvB,IAAI,CAAC,SAAS,CAAC,SAAS,GACxB,GAAG,CAAC,KAAK,CAAC,SAAS,GACnB,KAAK,CAAC,OAAO,CAAC,SAAS,GACvB,MAAM,CAAC,eAAe,CAAA;CAC3B"}

package/_types/Ens.d.ts

@@ -0,0 +1,72 @@
+import * as Bytes from './Bytes.js';
+import type * 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 {
+    var parseError: (error: unknown) => labelhash.ErrorType;
+}
+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 {
+    var parseError: (error: unknown) => namehash.ErrorType;
+}
+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 {
+    var parseError: (error: unknown) => normalize.ErrorType;
+}
+export declare namespace normalize {
+    type ErrorType = Errors.GlobalErrorType;
+}
+//# sourceMappingURL=Ens.d.ts.map

package/_types/Ens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ens.d.ts","sourceRoot":"","sources":["../Ens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAE7C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,iBAMtC;yBANe,SAAS;4BAiBM,OAAO,KAE3B,SAAS,CAAC,SAAS;;AAX9B,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;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,iBAepC;yBAfe,QAAQ;4BA4BM,OAAO,KAE1B,QAAQ,CAAC,SAAS;;AAb7B,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;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;yBAFe,SAAS;4BAQM,OAAO,KAE3B,SAAS,CAAC,SAAS;;AAN9B,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACxC"}

package/_types/Errors.d.ts

@@ -0,0 +1,33 @@
+export type GlobalErrorType<name extends string = 'Error'> = Error & {
+    name: name;
+};
+/**
+ * Base error class inherited by all errors thrown by ox.
+ *
+ * @example
+ * ```ts
+ * import { Errors } from 'ox'
+ * throw new Errors.BaseError('An error occurred')
+ * ```
+ */
+export declare class BaseError<cause extends Error | undefined = undefined> extends Error {
+    details: string;
+    docs?: string | undefined;
+    docsPath?: string | undefined;
+    shortMessage: string;
+    cause: cause;
+    name: string;
+    version: string;
+    constructor(shortMessage: string, options?: BaseError.Options<cause>);
+    walk(): Error;
+    walk(fn: (err: unknown) => boolean): Error | null;
+}
+export declare namespace BaseError {
+    type Options<cause extends Error | undefined = Error | undefined> = {
+        cause?: cause | undefined;
+        details?: string | undefined;
+        docsPath?: string | undefined;
+        metaMessages?: (string | undefined)[] | undefined;
+    };
+}
+//# sourceMappingURL=Errors.d.ts.map

package/_types/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../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,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;IAEX,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,SAAc;IAE3B,OAAO,SAAuB;gBAElB,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAM;IAyCxE,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,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;QACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,SAAS,CAAA;KAClD,CAAA;CACF"}

package/_types/Fee.d.ts

@@ -0,0 +1,41 @@
+import type * 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';
+//# sourceMappingURL=Fee.d.ts.map

package/_types/Fee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fee.d.ts","sourceRoot":"","sources":["../Fee.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEzD,MAAM,MAAM,UAAU,CAAC,UAAU,GAAG,MAAM,IAAI,OAAO,CAAC;IACpD;;;sDAGkD;IAClD,aAAa,EAAE,UAAU,EAAE,CAAA;IAC3B,oGAAoG;IACpG,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,iDAAiD;IACjD,WAAW,EAAE,UAAU,CAAA;IACvB,2IAA2I;IAC3I,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,GAAG,SAAS,CAAA;CACpC,CAAC,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE/C,MAAM,MAAM,eAAe,CAAC,UAAU,GAAG,MAAM,IAAI;IACjD,wBAAwB;IACxB,QAAQ,EAAE,UAAU,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEzD,MAAM,MAAM,gBAAgB,CAAC,UAAU,GAAG,MAAM,IAAI;IAClD,gFAAgF;IAChF,YAAY,EAAE,UAAU,CAAA;IACxB,yCAAyC;IACzC,oBAAoB,EAAE,UAAU,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE3D,MAAM,MAAM,gBAAgB,CAAC,UAAU,GAAG,MAAM,IAAI;IAClD,gFAAgF;IAChF,gBAAgB,EAAE,UAAU,CAAA;IAC5B,gFAAgF;IAChF,YAAY,EAAE,UAAU,CAAA;IACxB,yCAAyC;IACzC,oBAAoB,EAAE,UAAU,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE3D,MAAM,MAAM,SAAS,CAAC,UAAU,GAAG,MAAM,IAAI,KAAK,CAC9C,eAAe,CAAC,UAAU,CAAC,GAC3B,gBAAgB,CAAC,UAAU,CAAC,GAC5B,gBAAgB,CAAC,UAAU,CAAC,CAC/B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,CAC9B,kBAAkB,GAAG,mBAAmB,GAAG,mBAAmB,CAC/D,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA"}

package/_types/Filter.d.ts

@@ -0,0 +1,100 @@
+import type * as Address from './Address.js';
+import type * as Block from './Block.js';
+import type * as Errors from './Errors.js';
+import * as Hex from './Hex.js';
+import type { Compute } from './internal/types.js';
+/** A Filter as defined in the [Execution API specification](https://github.com/ethereum/execution-apis/blob/main/src/schemas/filter.yaml). */
+export type Filter<bigintType = bigint> = Compute<{
+    /** Address to filter for logs. */
+    address?: Address.Address | readonly Address.Address[] | null | undefined;
+    /** Block number or tag to filter logs from. */
+    fromBlock?: Block.Number<bigintType> | Block.Tag | undefined;
+    /** Block number or tag to filter logs to. */
+    toBlock?: Block.Number<bigintType> | Block.Tag | undefined;
+    /** Topics to filter for logs. */
+    topics?: Topics | undefined;
+}>;
+/** RPC representation of a {@link ox#Filter.Filter}. */
+export type Rpc = Filter<Hex.Hex>;
+/** Set of Filter topics. */
+export type Topics = readonly Topic[];
+/**
+ * A filter topic.
+ *
+ * - `null`: Matches any topic.
+ * - `Hex`: Matches if the topic is equal.
+ * - `Hex[]`: Matches if the topic is in the array.
+ */
+export type Topic = Hex.Hex | readonly Hex.Hex[] | null;
+/**
+ * Converts a {@link ox#Filter.Rpc} to an {@link ox#Filter.Filter}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Filter } from 'ox'
+ *
+ * const filter = Filter.fromRpc({
+ *   address: '0xd3cda913deb6f67967b99d671a681250403edf27',
+ *   fromBlock: 'latest',
+ *   toBlock: '0x010f2c',
+ *   topics: [
+ *     '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+ *     null,
+ *     '0x0000000000000000000000000c04d9e9278ec5e4d424476d3ebec70cb5d648d1',
+ *   ],
+ * })
+ * // @log: {
+ * // @log:   address: '0xd3cda913deb6f67967b99d671a681250403edf27',
+ * // @log:   fromBlock: 'latest',
+ * // @log:   toBlock: 69420n,
+ * // @log:   topics: [
+ * // @log:     '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+ * // @log:     null,
+ * // @log:     '0x0000000000000000000000000c04d9e9278ec5e4d424476d3ebec70cb5d648d1',
+ * // @log:   ],
+ * // @log: }
+ * ```
+ *
+ * @param filter - The RPC filter to convert.
+ * @returns An instantiated {@link ox#Filter.Filter}.
+ */
+export declare function fromRpc(filter: Rpc): Filter;
+export declare namespace fromRpc {
+    var parseError: (error: unknown) => fromRpc.ErrorType;
+}
+export declare namespace fromRpc {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Converts a {@link ox#Filter.Filter} to a {@link ox#Filter.Rpc}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { AbiEvent, Filter } from 'ox'
+ *
+ * const transfer = AbiEvent.from('event Transfer(address indexed, address indexed, uint256)')
+ * const { topics } = AbiEvent.encode(transfer)
+ *
+ * const filter = Filter.toRpc({
+ *   address: '0xfba3912ca04dd458c843e2ee08967fc04f3579c2',
+ *   topics,
+ * })
+ * // @log: {
+ * // @log:   address: '0xfba3912ca04dd458c843e2ee08967fc04f3579c2',
+ * // @log:   topics: [
+ * // @log:     '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+ * // @log:   ],
+ * // @log: }
+ * ```
+ *
+ * @param filter - The filter to convert.
+ * @returns An RPC filter.
+ */
+export declare function toRpc(filter: Filter): Rpc;
+export declare namespace toRpc {
+    var parseError: (error: unknown) => toRpc.ErrorType;
+}
+export declare namespace toRpc {
+    type ErrorType = Errors.GlobalErrorType;
+}
+//# sourceMappingURL=Filter.d.ts.map

package/_types/Filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filter.d.ts","sourceRoot":"","sources":["../Filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,8IAA8I;AAC9I,MAAM,MAAM,MAAM,CAAC,UAAU,GAAG,MAAM,IAAI,OAAO,CAAC;IAChD,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAA;IACzE,+CAA+C;IAC/C,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,SAAS,CAAA;IAC5D,6CAA6C;IAC7C,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,SAAS,CAAA;IAC1D,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B,CAAC,CAAA;AAEF,wDAAwD;AACxD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEjC,4BAA4B;AAC5B,MAAM,MAAM,MAAM,GAAG,SAAS,KAAK,EAAE,CAAA;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAe3C;yBAfe,OAAO;4BAqBM,OAAO,KAEzB,OAAO,CAAC,SAAS;;AAN5B,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACxC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAoBzC;yBApBe,KAAK;4BA0BM,OAAO,KAEvB,KAAK,CAAC,SAAS;;AAN1B,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,KAAK,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACxC"}

package/_types/Hash.d.ts

@@ -0,0 +1,135 @@
+import * as Bytes from './Bytes.js';
+import type * as Errors from './Errors.js';
+import * as Hex from './Hex.js';
+/**
+ * Calculates the [Keccak256](https://en.wikipedia.org/wiki/SHA-3) hash of a {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value.
+ *
+ * This function is a re-export of `keccak_256` from [`@noble/hashes`](https://github.com/paulmillr/noble-hashes), an audited & minimal JS hashing library.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hash } from 'ox'
+ *
+ * Hash.keccak256('0xdeadbeef')
+ * // @log: '0xd4fd4e189132273036449fc9e11198c739161b4c0116a9a2dccdfa1c492006f1'
+ * ```
+ *
+ * @example
+ * ### Calculate Hash of a String
+ *
+ * ```ts twoslash
+ * import { Hash, Hex } from 'ox'
+ *
+ * Hash.keccak256(Hex.fromString('hello world'))
+ * // @log: '0x3ea2f1d0abf3fc66cf29eebb70cbd4e7fe762ef8a09bcc06c8edf641230afec0'
+ * ```
+ *
+ * @example
+ * ### Configure Return Type
+ *
+ * ```ts twoslash
+ * import { Hash } from 'ox'
+ *
+ * Hash.keccak256('0xdeadbeef', { as: 'Bytes' })
+ * // @log: Uint8Array [...]
+ * ```
+ *
+ * @param value - {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value.
+ * @param options - Options.
+ * @returns Keccak256 hash.
+ */
+export declare function keccak256<value extends Hex.Hex | Bytes.Bytes, as extends 'Hex' | 'Bytes' = (value extends Hex.Hex ? 'Hex' : never) | (value extends Bytes.Bytes ? 'Bytes' : never)>(value: value | Hex.Hex | Bytes.Bytes, options?: keccak256.Options<as>): keccak256.ReturnType<as>;
+export declare namespace keccak256 {
+    var parseError: (error: unknown) => keccak256.ErrorType;
+}
+export declare namespace keccak256 {
+    type Options<as extends 'Hex' | 'Bytes' = 'Hex' | 'Bytes'> = {
+        /** The return type. @default 'Hex' */
+        as?: as | 'Hex' | 'Bytes' | undefined;
+    };
+    type ReturnType<as extends 'Hex' | 'Bytes' = 'Hex' | 'Bytes'> = (as extends 'Bytes' ? Bytes.Bytes : never) | (as extends 'Hex' ? Hex.Hex : never);
+    type ErrorType = Bytes.from.ErrorType | Hex.fromBytes.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Calculates the [Ripemd160](https://en.wikipedia.org/wiki/RIPEMD) hash of a {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value.
+ *
+ * This function is a re-export of `ripemd160` from [`@noble/hashes`](https://github.com/paulmillr/noble-hashes), an audited & minimal JS hashing library.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hash } from 'ox'
+ *
+ * Hash.ripemd160('0xdeadbeef')
+ * // '0x226821c2f5423e11fe9af68bd285c249db2e4b5a'
+ * ```
+ *
+ * @param value - {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value.
+ * @param options - Options.
+ * @returns Ripemd160 hash.
+ */
+export declare function ripemd160<value extends Hex.Hex | Bytes.Bytes, as extends 'Hex' | 'Bytes' = (value extends Hex.Hex ? 'Hex' : never) | (value extends Bytes.Bytes ? 'Bytes' : never)>(value: value | Hex.Hex | Bytes.Bytes, options?: ripemd160.Options<as>): ripemd160.ReturnType<as>;
+export declare namespace ripemd160 {
+    var parseError: (error: unknown) => ripemd160.ErrorType;
+}
+export declare namespace ripemd160 {
+    type Options<as extends 'Hex' | 'Bytes' = 'Hex' | 'Bytes'> = {
+        /** The return type. @default 'Hex' */
+        as?: as | 'Hex' | 'Bytes' | undefined;
+    };
+    type ReturnType<as extends 'Hex' | 'Bytes' = 'Hex' | 'Bytes'> = (as extends 'Bytes' ? Bytes.Bytes : never) | (as extends 'Hex' ? Hex.Hex : never);
+    type ErrorType = Bytes.from.ErrorType | Hex.fromBytes.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Calculates the [Sha256](https://en.wikipedia.org/wiki/SHA-256) hash of a {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value.
+ *
+ * This function is a re-export of `sha256` from [`@noble/hashes`](https://github.com/paulmillr/noble-hashes), an audited & minimal JS hashing library.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hash } from 'ox'
+ *
+ * Hash.sha256('0xdeadbeef')
+ * // '0x5f78c33274e43fa9de5659265c1d917e25c03722dcb0b8d27db8d5feaa813953'
+ * ```
+ *
+ * @param value - {@link ox#Bytes.Bytes} or {@link ox#Hex.Hex} value.
+ * @param options - Options.
+ * @returns Sha256 hash.
+ */
+export declare function sha256<value extends Hex.Hex | Bytes.Bytes, as extends 'Hex' | 'Bytes' = (value extends Hex.Hex ? 'Hex' : never) | (value extends Bytes.Bytes ? 'Bytes' : never)>(value: value | Hex.Hex | Bytes.Bytes, options?: sha256.Options<as>): sha256.ReturnType<as>;
+export declare namespace sha256 {
+    var parseError: (error: unknown) => sha256.ErrorType;
+}
+export declare namespace sha256 {
+    type Options<as extends 'Hex' | 'Bytes' = 'Hex'> = {
+        /** The return type. @default 'Hex' */
+        as?: as | 'Hex' | 'Bytes' | undefined;
+    };
+    type ReturnType<as extends 'Hex' | 'Bytes' = 'Hex'> = (as extends 'Bytes' ? Bytes.Bytes : never) | (as extends 'Hex' ? Hex.Hex : never);
+    type ErrorType = Bytes.from.ErrorType | Hex.fromBytes.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Checks if a string is a valid hash value.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Hash } from 'ox'
+ *
+ * Hash.validate('0x')
+ * // @log: false
+ *
+ * Hash.validate('0x3ea2f1d0abf3fc66cf29eebb70cbd4e7fe762ef8a09bcc06c8edf641230afec0')
+ * // @log: true
+ * ```
+ *
+ * @param value - Value to check.
+ * @returns Whether the value is a valid hash.
+ */
+export declare function validate(value: string): value is Hex.Hex;
+export declare namespace validate {
+    var parseError: (error: unknown) => validate.ErrorType;
+}
+export declare namespace validate {
+    type ErrorType = Hex.validate.ErrorType | Hex.size.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=Hash.d.ts.map

package/_types/Hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hash.d.ts","sourceRoot":"","sources":["../Hash.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,SAAS,CACvB,KAAK,SAAS,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACnC,EAAE,SAAS,KAAK,GAAG,OAAO,GACtB,CAAC,KAAK,SAAS,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,GACvC,CAAC,KAAK,SAAS,KAAK,CAAC,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC,EAEjD,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACpC,OAAO,GAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAM,GAClC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAK1B;yBAbe,SAAS;4BAgCM,OAAO,KAAc,SAAS,CAAC,SAAS;;AAjBvE,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,OAAO,CAAC,EAAE,SAAS,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,IAAI;QAC3D,sCAAsC;QACtC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;KACtC,CAAA;IAED,KAAK,UAAU,CAAC,EAAE,SAAS,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,IACxD,CAAC,EAAE,SAAS,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAC1C,CAAC,EAAE,SAAS,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,CAAA;IAExC,KAAK,SAAS,GACV,KAAK,CAAC,IAAI,CAAC,SAAS,GACpB,GAAG,CAAC,SAAS,CAAC,SAAS,GACvB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,KAAK,SAAS,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACnC,EAAE,SAAS,KAAK,GAAG,OAAO,GACtB,CAAC,KAAK,SAAS,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,GACvC,CAAC,KAAK,SAAS,KAAK,CAAC,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC,EAEjD,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACpC,OAAO,GAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAM,GAClC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAK1B;yBAbe,SAAS;4BAgCM,OAAO,KAAc,SAAS,CAAC,SAAS;;AAjBvE,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,OAAO,CAAC,EAAE,SAAS,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,IAAI;QAC3D,sCAAsC;QACtC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;KACtC,CAAA;IAED,KAAK,UAAU,CAAC,EAAE,SAAS,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,IACxD,CAAC,EAAE,SAAS,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAC1C,CAAC,EAAE,SAAS,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,CAAA;IAExC,KAAK,SAAS,GACV,KAAK,CAAC,IAAI,CAAC,SAAS,GACpB,GAAG,CAAC,SAAS,CAAC,SAAS,GACvB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CACpB,KAAK,SAAS,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACnC,EAAE,SAAS,KAAK,GAAG,OAAO,GACtB,CAAC,KAAK,SAAS,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,GACvC,CAAC,KAAK,SAAS,KAAK,CAAC,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC,EAEjD,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACpC,OAAO,GAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAM,GAC/B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAKvB;yBAbe,MAAM;4BAgCM,OAAO,KAAc,MAAM,CAAC,SAAS;;AAjBjE,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,OAAO,CAAC,EAAE,SAAS,KAAK,GAAG,OAAO,GAAG,KAAK,IAAI;QACjD,sCAAsC;QACtC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAA;KACtC,CAAA;IAED,KAAK,UAAU,CAAC,EAAE,SAAS,KAAK,GAAG,OAAO,GAAG,KAAK,IAC9C,CAAC,EAAE,SAAS,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAC1C,CAAC,EAAE,SAAS,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,CAAA;IAExC,KAAK,SAAS,GACV,KAAK,CAAC,IAAI,CAAC,SAAS,GACpB,GAAG,CAAC,SAAS,CAAC,SAAS,GACvB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG,CAAC,GAAG,CAExD;yBAFe,QAAQ;4BAYM,OAAO,KAAc,QAAQ,CAAC,SAAS;;AARrE,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAK,SAAS,GACV,GAAG,CAAC,QAAQ,CAAC,SAAS,GACtB,GAAG,CAAC,IAAI,CAAC,SAAS,GAClB,MAAM,CAAC,eAAe,CAAA;CAC3B"}