ox 0.0.1 → 0.1.0

package/_esm/internal/promise.js

@@ -0,0 +1,52 @@
+import * as Errors from '../Errors.js';
+/** @internal */
+export function withTimeout(fn, options) {
+    const { errorInstance = new TimeoutError(), timeout, signal } = options;
+    return new Promise((resolve, reject) => {
+        ;
+        (async () => {
+            let timeoutId;
+            try {
+                const controller = new AbortController();
+                if (timeout > 0)
+                    timeoutId = setTimeout(() => {
+                        if (signal) {
+                            controller.abort();
+                        }
+                        else {
+                            reject(errorInstance);
+                        }
+                    }, timeout);
+                resolve(await fn({ signal: controller.signal }));
+            }
+            catch (err) {
+                if (err?.name === 'AbortError')
+                    reject(errorInstance);
+                reject(err);
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        })();
+    });
+}
+/** @internal */
+withTimeout.parseError = (error) => 
+/* v8 ignore next */
+error;
+/**
+ * Thrown when an operation times out.
+ * @internal
+ */
+export class TimeoutError extends Errors.BaseError {
+    constructor() {
+        super('Operation timed out.');
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'Promise.TimeoutError'
+        });
+    }
+}
+//# sourceMappingURL=promise.js.map

package/_esm/internal/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../internal/promise.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AAEtC,gBAAgB;AAChB,MAAM,UAAU,WAAW,CACzB,EAAwB,EACxB,OAA4B;IAE5B,MAAM,EAAE,aAAa,GAAG,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACvE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,CAAC;QAAA,CAAC,KAAK,IAAI,EAAE;YACX,IAAI,SAAc,CAAA;YAClB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;gBACxC,IAAI,OAAO,GAAG,CAAC;oBACb,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC1B,IAAI,MAAM,EAAE,CAAC;4BACX,UAAU,CAAC,KAAK,EAAE,CAAA;wBACpB,CAAC;6BAAM,CAAC;4BACN,MAAM,CAAC,aAAa,CAAC,CAAA;wBACvB,CAAC;oBACH,CAAC,EAAE,OAAO,CAAQ,CAAA;gBACpB,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;YAClD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAK,GAAa,EAAE,IAAI,KAAK,YAAY;oBAAE,MAAM,CAAC,aAAa,CAAC,CAAA;gBAChE,MAAM,CAAC,GAAG,CAAC,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,SAAS,CAAC,CAAA;YACzB,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;IACN,CAAC,CAAC,CAAA;AACJ,CAAC;AAoBD,gBAAgB;AAChB,WAAW,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;AAC1C,oBAAoB;AACpB,KAA8B,CAAA;AAEhC;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,MAAM,CAAC,SAAS;IAGhD;QACE,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAHb;;;;mBAAO,sBAAsB;WAAA;IAI/C,CAAC;CACF"}

package/_esm/internal/register.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.js.map

package/_esm/internal/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../internal/register.ts"],"names":[],"mappings":""}

package/_esm/internal/rpcSchema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rpcSchema.js.map

package/_esm/internal/rpcSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcSchema.js","sourceRoot":"","sources":["../../internal/rpcSchema.ts"],"names":[],"mappings":""}

package/_esm/internal/rpcSchemas/eth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=eth.js.map

package/_esm/internal/rpcSchemas/eth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eth.js","sourceRoot":"","sources":["../../../internal/rpcSchemas/eth.ts"],"names":[],"mappings":""}

package/_esm/internal/rpcSchemas/wallet.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wallet.js.map

package/_esm/internal/rpcSchemas/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../internal/rpcSchemas/wallet.ts"],"names":[],"mappings":""}

package/_esm/internal/rpcTransport.js

@@ -0,0 +1,20 @@
+import * as RpcRequest from '../RpcRequest.js';
+import * as RpcResponse from '../RpcResponse.js';
+/** @internal */
+export function create(transport, options_root) {
+    const requestStore = RpcRequest.createStore();
+    return {
+        request: async ({ method, params }, options = {}) => {
+            const body = requestStore.prepare({ method, params });
+            const data = await transport.request(body, options);
+            return RpcResponse.parse(data, {
+                raw: options.raw ?? options_root?.raw,
+            });
+        },
+    };
+}
+/** @internal */
+create.parseError = (error) => 
+/* v8 ignore next */
+error;
+//# sourceMappingURL=rpcTransport.js.map

package/_esm/internal/rpcTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcTransport.js","sourceRoot":"","sources":["../../internal/rpcTransport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAA;AA6BhD,gBAAgB;AAChB,MAAM,UAAU,MAAM,CAKpB,SAAoC,EACpC,YAA4C;IAE5C,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;IAE7C,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,UAAe,EAAE,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAW,CAAC,CAAA;YAE9D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAa,EAAE,OAAgB,CAAC,CAAA;YAErE,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE;gBAC7B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,YAAY,EAAE,GAAG;aACtC,CAAU,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC;AAiBD,gBAAgB;AAChB,MAAM,CAAC,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE;AACrC,oBAAoB;AACpB,KAAyB,CAAA"}

package/_esm/internal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/_esm/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../internal/types.ts"],"names":[],"mappings":""}

package/_esm/internal/uid.js

@@ -0,0 +1,15 @@
+const size = 256;
+let index = size;
+let buffer;
+/** @internal */
+export function uid(length = 11) {
+    if (!buffer || index + length > size * 2) {
+        buffer = '';
+        index = 0;
+        for (let i = 0; i < size; i++) {
+            buffer += ((256 + Math.random() * 256) | 0).toString(16).substring(1);
+        }
+    }
+    return buffer.substring(index, index++ + length);
+}
+//# sourceMappingURL=uid.js.map

package/_esm/internal/uid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.js","sourceRoot":"","sources":["../../internal/uid.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,GAAG,CAAA;AAChB,IAAI,KAAK,GAAG,IAAI,CAAA;AAChB,IAAI,MAAc,CAAA;AAElB,gBAAgB;AAChB,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE;IAC7B,IAAI,CAAC,MAAM,IAAI,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,EAAE,CAAA;QACX,KAAK,GAAG,CAAC,CAAA;QACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAA;AAClD,CAAC"}

package/_esm/internal/webauthn.js

@@ -0,0 +1,35 @@
+import { p256 } from '@noble/curves/p256';
+import * as Hex from '../Hex.js';
+import * as PublicKey from '../PublicKey.js';
+/**
+ * Parses an ASN.1 signature into a r and s value.
+ *
+ * @internal
+ */
+export function parseAsn1Signature(bytes) {
+    const r_start = bytes[4] === 0 ? 5 : 4;
+    const r_end = r_start + 32;
+    const s_start = bytes[r_end + 2] === 0 ? r_end + 3 : r_end + 2;
+    const r = BigInt(Hex.fromBytes(bytes.slice(r_start, r_end)));
+    const s = BigInt(Hex.fromBytes(bytes.slice(s_start)));
+    return {
+        r,
+        s: s > p256.CURVE.n / 2n ? p256.CURVE.n - s : s,
+    };
+}
+/**
+ * Parses a public key into x and y coordinates from the public key
+ * defined on the credential.
+ *
+ * @internal
+ */
+export async function parseCredentialPublicKey(cPublicKey) {
+    const cryptoKey = await crypto.subtle.importKey('spki', new Uint8Array(cPublicKey), {
+        name: 'ECDSA',
+        namedCurve: 'P-256',
+        hash: 'SHA-256',
+    }, true, ['verify']);
+    const publicKey = new Uint8Array(await crypto.subtle.exportKey('raw', cryptoKey));
+    return PublicKey.from(publicKey);
+}
+//# sourceMappingURL=webauthn.js.map

package/_esm/internal/webauthn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webauthn.js","sourceRoot":"","sources":["../../internal/webauthn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAEzC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAuJ5C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,OAAO,GAAG,EAAE,CAAA;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;IAE9D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAErD,OAAO;QACL,CAAC;QACD,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KAChD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAC7C,MAAM,EACN,IAAI,UAAU,CAAC,UAAU,CAAC,EAC1B;QACE,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,SAAS;KAChB,EACD,IAAI,EACJ,CAAC,QAAQ,CAAC,CACX,CAAA;IACD,MAAM,SAAS,GAAG,IAAI,UAAU,CAC9B,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAChD,CAAA;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAClC,CAAC"}

package/_esm/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

package/_esm/trusted-setups/Paths.js

@@ -0,0 +1,3 @@
+import { path } from './internal/paths.js';
+export const mainnet = path('mainnet');
+//# sourceMappingURL=Paths.js.map

package/_esm/trusted-setups/Paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../../trusted-setups/Paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE1C,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA"}

package/_esm/trusted-setups/index.js

@@ -0,0 +1,2 @@
+export * as Paths from './Paths.js';
+//# sourceMappingURL=index.js.map

package/_esm/trusted-setups/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../trusted-setups/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA"}

package/_esm/trusted-setups/internal/paths.js

@@ -0,0 +1,12 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** @internal */
+export function path(name) {
+    const __filename = fileURLToPath(
+    // import.meta' meta-property is only allowed when the '--module' option is 'es2020', 'es2022', 'esnext', 'system', 'node16', or 'nodenext'
+    // @ts-ignore
+    import.meta.url);
+    const __dirname = dirname(__filename);
+    return resolve(__dirname, `./setups/${name}.json`);
+}
+//# sourceMappingURL=paths.js.map

package/_esm/trusted-setups/internal/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../trusted-setups/internal/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,gBAAgB;AAChB,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,MAAM,UAAU,GAAG,aAAa;IAC9B,2IAA2I;IAC3I,aAAa;IACb,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAA;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrC,OAAO,OAAO,CAAC,SAAS,EAAE,YAAY,IAAI,OAAO,CAAC,CAAA;AACpD,CAAC"}

package/_esm/version.js

@@ -0,0 +1,3 @@
+/** @internal */
+export const version = '0.1.0';
+//# sourceMappingURL=version.js.map

package/_esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../version.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}

package/_esm/window/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/_esm/window/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../window/index.ts"],"names":[],"mappings":""}

package/_test/Abi.test-d/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../_types/_test/Abi.test-d.d.ts",
+  "main": "../_cjs/_test/Abi.test-d.js",
+  "module": "../_esm/_test/Abi.test-d.js"
+}

package/_test/AbiConstructor.test-d/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../_types/_test/AbiConstructor.test-d.d.ts",
+  "main": "../_cjs/_test/AbiConstructor.test-d.js",
+  "module": "../_esm/_test/AbiConstructor.test-d.js"
+}

package/_test/AbiError.test-d/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../_types/_test/AbiError.test-d.d.ts",
+  "main": "../_cjs/_test/AbiError.test-d.js",
+  "module": "../_esm/_test/AbiError.test-d.js"
+}

package/_test/AbiEvent.snap-d/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../_types/_test/AbiEvent.snap-d.d.ts",
+  "main": "../_cjs/_test/AbiEvent.snap-d.js",
+  "module": "../_esm/_test/AbiEvent.snap-d.js"
+}

package/_test/AbiEvent.snap-d.ts

@@ -0,0 +1,329 @@
+import { attest } from '@ark/attest'
+import { Abi, AbiEvent } from 'ox'
+import { describe, test } from 'vitest'
+import {
+  seaportContractConfig,
+  wagmiContractConfig,
+} from '../../test/constants/abis.js'
+
+describe('decode', () => {
+  test('behavior: named', () => {
+    const transfer = AbiEvent.from(
+      'event Transfer(address indexed from, address indexed to, uint256 value)',
+    )
+    const decoded = AbiEvent.decode(transfer, {
+      data: '0x0000000000000000000000000000000000000000000000000000000000000001',
+      topics: [
+        '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+      ],
+    })
+    attest(decoded).type.toString.snap(`{
+    from: \`0x\${string}\`
+    to: \`0x\${string}\`
+    value: bigint
+  }`)
+  })
+
+  test('behavior: unnamed', () => {
+    const transfer = AbiEvent.from(
+      'event Transfer(address indexed, address indexed, uint256)',
+    )
+    const decoded = AbiEvent.decode(transfer, {
+      data: '0x0000000000000000000000000000000000000000000000000000000000000001',
+      topics: [
+        '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+      ],
+    })
+    attest(decoded).type.toString.snap(
+      'readonly [`0x${string}`, `0x${string}`, bigint]',
+    )
+  })
+
+  test('behavior: named + unnamed', () => {
+    const transfer = AbiEvent.from(
+      'event Transfer(address indexed from, address indexed to, uint256)',
+    )
+    const decoded = AbiEvent.decode(transfer, {
+      data: '0x0000000000000000000000000000000000000000000000000000000000000001',
+      topics: [
+        '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+      ],
+    })
+    attest(decoded).type.toString.snap(`{
+    from: \`0x\${string}\`
+    to: \`0x\${string}\`
+    2: bigint
+  }`)
+  })
+
+  test('behavior: named + unnamed', () => {
+    const transfer = AbiEvent.from(
+      'event Transfer(address indexed from, address indexed, uint256 value)',
+    )
+    const decoded = AbiEvent.decode(transfer, {
+      data: '0x0000000000000000000000000000000000000000000000000000000000000001',
+      topics: [
+        '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+      ],
+    })
+    attest(decoded).type.toString.snap(`{
+    from: \`0x\${string}\`
+    1: \`0x\${string}\`
+    value: bigint
+  }`)
+  })
+
+  test('behavior: named + unnamed', () => {
+    const transfer = AbiEvent.from(
+      'event Transfer(address indexed from, address indexed, uint256 value, uint256)',
+    )
+    const decoded = AbiEvent.decode(transfer, {
+      data: '0x00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001',
+      topics: [
+        '0x9ed053bb818ff08b8353cd46f78db1f0799f31c9e4458fdb425c10eccd2efc44',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+        '0x000000000000000000000000a5cc3c03994db5b0d9a5eedd10cabab0813678ac',
+      ],
+    })
+    attest(decoded).type.toString.snap(`{
+    from: \`0x\${string}\`
+    1: \`0x\${string}\`
+    value: bigint
+    3: bigint
+  }`)
+  })
+
+  test('behavior: string inputs', () => {
+    const transfer = AbiEvent.from('event Transfer(string indexed a)')
+
+    const decoded = AbiEvent.decode(transfer, {
+      topics: [
+        '0x7cebee4ee226a36ff8751d9d69bb8265f5138c825f8c25d7ebdd60d972ffe5be',
+        '0x1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8',
+      ],
+    })
+
+    attest(decoded).type.toString.snap('{ a: string }')
+  })
+
+  test('behavior: widened event', () => {
+    const transfer = AbiEvent.from('event Transfer(string indexed a)')
+
+    const decoded = AbiEvent.decode(transfer as AbiEvent.AbiEvent, {
+      topics: [
+        '0x7cebee4ee226a36ff8751d9d69bb8265f5138c825f8c25d7ebdd60d972ffe5be',
+        '0x1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8',
+      ],
+    })
+
+    attest(decoded).type.toString.snap('unknown')
+  })
+
+  test('behavior: union event', () => {
+    const transfer = AbiEvent.fromAbi(
+      seaportContractConfig.abi,
+      'CounterIncremented' as AbiEvent.Name<typeof seaportContractConfig.abi>,
+    )
+
+    const decoded = AbiEvent.decode(transfer, {
+      data: '0x0000000000000000000000000000000000000000000000000000000000000000',
+      topics: [
+        '0x721c20121297512b72821b97f5326877ea8ecf4bb9948fea5bfcb6453074d37f',
+        '0x1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8',
+      ],
+    })
+
+    attest(decoded).type.toString.snap(`  | { newCounter: bigint; offerer: \`0x\${string}\` }
+    | {
+        orderHash: \`0x\${string}\`
+        offerer: \`0x\${string}\`
+        zone: \`0x\${string}\`
+      }
+    | {
+        orderHash: \`0x\${string}\`
+        offerer: \`0x\${string}\`
+        zone: \`0x\${string}\`
+        recipient: \`0x\${string}\`
+        offer: readonly {
+          itemType: number
+          token: \`0x\${string}\`
+          identifier: bigint
+          amount: bigint
+        }[]
+        consideration: readonly {
+          itemType: number
+          token: \`0x\${string}\`
+          identifier: bigint
+          amount: bigint
+          recipient: \`0x\${string}\`
+        }[]
+      }
+    | {
+        orderHash: \`0x\${string}\`
+        offerer: \`0x\${string}\`
+        zone: \`0x\${string}\`
+      }`)
+  })
+})
+
+describe('fromAbi', () => {
+  test('default', () => {
+    const item = AbiEvent.fromAbi(wagmiContractConfig.abi, 'Approval')
+    attest(item).type.toString.snap(`{
+  readonly anonymous: false
+  readonly inputs: readonly [
+    {
+      readonly indexed: true
+      readonly name: "owner"
+      readonly type: "address"
+    },
+    {
+      readonly indexed: true
+      readonly name: "approved"
+      readonly type: "address"
+    },
+    {
+      readonly indexed: true
+      readonly name: "tokenId"
+      readonly type: "uint256"
+    }
+  ]
+  readonly name: "Approval"
+  readonly type: "event"
+}`)
+  })
+
+  test('behavior: unknown abi', () => {
+    const item = AbiEvent.fromAbi(
+      wagmiContractConfig.abi as readonly unknown[],
+      'Approval',
+    )
+    attest(item).type.toString.snap('AbiEvent')
+  })
+
+  test('behavior: name', () => {
+    const item = AbiEvent.fromAbi(wagmiContractConfig.abi, 'Approval')
+    const item_2 = AbiEvent.fromAbi(
+      wagmiContractConfig.abi,
+      AbiEvent.getSelector(item),
+    )
+    attest(item_2).type.toString.snap(`  | {
+      readonly anonymous: false
+      readonly inputs: readonly [
+        {
+          readonly indexed: true
+          readonly name: "owner"
+          readonly type: "address"
+        },
+        {
+          readonly indexed: true
+          readonly name: "approved"
+          readonly type: "address"
+        },
+        {
+          readonly indexed: true
+          readonly name: "tokenId"
+          readonly type: "uint256"
+        }
+      ]
+      readonly name: "Approval"
+      readonly type: "event"
+    }
+  | {
+      readonly anonymous: false
+      readonly inputs: readonly [
+        {
+          readonly indexed: true
+          readonly name: "owner"
+          readonly type: "address"
+        },
+        {
+          readonly indexed: true
+          readonly name: "operator"
+          readonly type: "address"
+        },
+        {
+          readonly indexed: false
+          readonly name: "approved"
+          readonly type: "bool"
+        }
+      ]
+      readonly name: "ApprovalForAll"
+      readonly type: "event"
+    }
+  | {
+      readonly anonymous: false
+      readonly inputs: readonly [
+        {
+          readonly indexed: true
+          readonly name: "from"
+          readonly type: "address"
+        },
+        {
+          readonly indexed: true
+          readonly name: "to"
+          readonly type: "address"
+        },
+        {
+          readonly indexed: true
+          readonly name: "tokenId"
+          readonly type: "uint256"
+        }
+      ]
+      readonly name: "Transfer"
+      readonly type: "event"
+    }`)
+  })
+
+  test('behavior: overloads', () => {
+    const abi = Abi.from(['event Bar()', 'event Foo()', 'event Foo(uint256)'])
+    const item = AbiEvent.fromAbi(abi, 'Foo')
+    attest(item).type.toString.snap(`{
+  readonly name: "Foo"
+  readonly type: "event"
+  readonly inputs: readonly []
+}`)
+  })
+
+  test('behavior: overloads: no inputs or args', () => {
+    const abi = Abi.from([
+      'event Bar()',
+      'event Foo(bytes)',
+      'event Foo(uint256)',
+    ])
+    const item = AbiEvent.fromAbi(abi, 'Foo')
+    attest(item).type.toString.snap(`{
+  readonly name: "Foo"
+  readonly type: "event"
+  readonly inputs: readonly [{ readonly type: "bytes" }]
+  readonly overloads: [
+    {
+      readonly name: "Foo"
+      readonly type: "event"
+      readonly inputs: readonly [
+        { readonly type: "uint256" }
+      ]
+    }
+  ]
+}`)
+  })
+
+  test('behavior: widened name', () => {
+    const abi = Abi.from(wagmiContractConfig.abi)
+    const abiItem = AbiEvent.fromAbi(
+      abi,
+      'Approval' as AbiEvent.Name<typeof abi>,
+    )
+    attest(abiItem.name).type.toString.snap(
+      '"Transfer" | "Approval" | "ApprovalForAll"',
+    )
+  })
+})

package/_test/AbiFunction.snap-d/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../_types/_test/AbiFunction.snap-d.d.ts",
+  "main": "../_cjs/_test/AbiFunction.snap-d.js",
+  "module": "../_esm/_test/AbiFunction.snap-d.js"
+}