ox 0.9.10 → 0.9.11

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ox
 
+## 0.9.11
+
+### Patch Changes
+
+- [#126](https://github.com/wevm/ox/pull/126) [`b4572ed`](https://github.com/wevm/ox/commit/b4572ed6feaed7ee1063f8b710d98e928d848016) Thanks [@jxom](https://github.com/jxom)! - Added `ox/erc8021` entrypoint.
+
 ## 0.9.10
 
 ### Patch Changes

package/_cjs/erc8021/Attribution.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ercSuffixSize = exports.ercSuffix = void 0;
+exports.getSchemaId = getSchemaId;
+exports.toDataSuffix = toDataSuffix;
+exports.fromData = fromData;
+const Hex = require("../core/Hex.js");
+exports.ercSuffix = '0x80218021802180218021802180218021';
+exports.ercSuffixSize = Hex.size(exports.ercSuffix);
+function getSchemaId(attribution) {
+    if ('codeRegistryAddress' in attribution)
+        return 1;
+    return 0;
+}
+function toDataSuffix(attribution) {
+    const codesHex = Hex.fromString(attribution.codes.join(','));
+    const codesLength = Hex.size(codesHex);
+    const codesLengthHex = Hex.fromNumber(codesLength, { size: 1 });
+    const schemaId = getSchemaId(attribution);
+    const schemaIdHex = Hex.fromNumber(schemaId, { size: 1 });
+    if (schemaId === 1)
+        return Hex.concat(attribution.codeRegistryAddress.toLowerCase(), codesHex, codesLengthHex, schemaIdHex, exports.ercSuffix);
+    return Hex.concat(codesHex, codesLengthHex, schemaIdHex, exports.ercSuffix);
+}
+function fromData(data) {
+    const minSize = exports.ercSuffixSize + 1 + 1;
+    if (Hex.size(data) < minSize)
+        return undefined;
+    const suffix = Hex.slice(data, -exports.ercSuffixSize);
+    if (suffix !== exports.ercSuffix)
+        return undefined;
+    const schemaIdHex = Hex.slice(data, -exports.ercSuffixSize - 1, -exports.ercSuffixSize);
+    const schemaId = Hex.toNumber(schemaIdHex);
+    if (schemaId === 0) {
+        const codesLengthHex = Hex.slice(data, -exports.ercSuffixSize - 2, -exports.ercSuffixSize - 1);
+        const codesLength = Hex.toNumber(codesLengthHex);
+        const codesStart = -exports.ercSuffixSize - 2 - codesLength;
+        const codesEnd = -exports.ercSuffixSize - 2;
+        const codesHex = Hex.slice(data, codesStart, codesEnd);
+        const codesString = Hex.toString(codesHex);
+        const codes = codesString.length > 0 ? codesString.split(',') : [];
+        return { codes, id: 0 };
+    }
+    if (schemaId === 1) {
+        const codesLengthHex = Hex.slice(data, -exports.ercSuffixSize - 2, -exports.ercSuffixSize - 1);
+        const codesLength = Hex.toNumber(codesLengthHex);
+        const codesStart = -exports.ercSuffixSize - 2 - codesLength;
+        const codesEnd = -exports.ercSuffixSize - 2;
+        const codesHex = Hex.slice(data, codesStart, codesEnd);
+        const codesString = Hex.toString(codesHex);
+        const codes = codesString.length > 0 ? codesString.split(',') : [];
+        const registryStart = codesStart - 20;
+        const codeRegistryAddress = Hex.slice(data, registryStart, codesStart);
+        return {
+            codes,
+            codeRegistryAddress,
+            id: 1,
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=Attribution.js.map

package/_cjs/erc8021/Attribution.js.map

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

package/_cjs/erc8021/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Attribution = void 0;
+exports.Attribution = require("./Attribution.js");
+//# sourceMappingURL=index.js.map

package/_cjs/erc8021/index.js.map

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

package/_cjs/index.docs.js

@@ -6,4 +6,5 @@ tslib_1.__exportStar(require("./erc4337/index.js"), exports);
 tslib_1.__exportStar(require("./erc6492/index.js"), exports);
 tslib_1.__exportStar(require("./erc7821/index.js"), exports);
 tslib_1.__exportStar(require("./erc8010/index.js"), exports);
+tslib_1.__exportStar(require("./erc8021/index.js"), exports);
 //# sourceMappingURL=index.docs.js.map

package/_cjs/index.docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.docs.js","sourceRoot":"","sources":["../index.docs.ts"],"names":[],"mappings":";;;AAGA,qDAA0B;AAC1B,6DAAkC;AAClC,6DAAkC;AAClC,6DAAkC;AAClC,6DAAkC"}
+{"version":3,"file":"index.docs.js","sourceRoot":"","sources":["../index.docs.ts"],"names":[],"mappings":";;;AAGA,qDAA0B;AAC1B,6DAAkC;AAClC,6DAAkC;AAClC,6DAAkC;AAClC,6DAAkC;AAClC,6DAAkC"}

package/_cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
-exports.version = '0.9.10';
+exports.version = '0.9.11';
 //# sourceMappingURL=version.js.map

package/_esm/erc8021/Attribution.js

@@ -0,0 +1,167 @@
+import * as Hex from '../core/Hex.js';
+/**
+ * ERC-8021 suffix identifier.
+ */
+export const ercSuffix = '0x80218021802180218021802180218021';
+/**
+ * Size of the ERC-8021 suffix (16 bytes).
+ */
+export const ercSuffixSize = /*#__PURE__*/ Hex.size(ercSuffix);
+/**
+ * Determines the schema ID for an {@link ox#Attribution.Attribution}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const schemaId = Attribution.getSchemaId({
+ *   codes: ['baseapp']
+ * })
+ * // @log: 0
+ *
+ * const schemaId2 = Attribution.getSchemaId({
+ *   codes: ['baseapp'],
+ *   codeRegistryAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+ * })
+ * // @log: 1
+ * ```
+ *
+ * @param attribution - The attribution object.
+ * @returns The schema ID (0 for canonical registry, 1 for custom registry).
+ */
+export function getSchemaId(attribution) {
+    if ('codeRegistryAddress' in attribution)
+        return 1;
+    return 0;
+}
+/**
+ * Converts an {@link ox#Attribution.Attribution} to a data suffix that can be appended to transaction calldata.
+ *
+ * @example
+ * ### Schema 0 (Canonical Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   codes: ['baseapp', 'morpho']
+ * })
+ * // @log: '0x626173656170702c6d6f7270686f0e0080218021802180218021802180218021'
+ * ```
+ *
+ * @example
+ * ### Schema 1 (Custom Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   codes: ['baseapp'],
+ *   codeRegistryAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+ * })
+ * ```
+ *
+ * @param attribution - The attribution to convert.
+ * @returns The data suffix as a {@link ox#Hex.Hex} value.
+ */
+export function toDataSuffix(attribution) {
+    // Encode the codes as ASCII strings separated by commas
+    const codesHex = Hex.fromString(attribution.codes.join(','));
+    // Get the byte length of the encoded codes
+    const codesLength = Hex.size(codesHex);
+    // Encode the codes length as 1 byte
+    const codesLengthHex = Hex.fromNumber(codesLength, { size: 1 });
+    // Determine schema ID
+    const schemaId = getSchemaId(attribution);
+    const schemaIdHex = Hex.fromNumber(schemaId, { size: 1 });
+    // Build the suffix based on schema
+    if (schemaId === 1)
+        // Schema 1: codeRegistryAddress ∥ codes ∥ codesLength ∥ schemaId ∥ ercSuffix
+        return Hex.concat(attribution.codeRegistryAddress.toLowerCase(), codesHex, codesLengthHex, schemaIdHex, ercSuffix);
+    // Schema 0: codes ∥ codesLength ∥ schemaId ∥ ercSuffix
+    return Hex.concat(codesHex, codesLengthHex, schemaIdHex, ercSuffix);
+}
+/**
+ * Extracts an {@link ox#Attribution.Attribution} from transaction calldata.
+ *
+ * @example
+ * ### Schema 0 (Canonical Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddd62617365617070070080218021802180218021802180218021'
+ * )
+ * // @log: { codes: ['baseapp'], id: 0 }
+ * ```
+ *
+ * @example
+ * ### Schema 1 (Custom Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddd626173656170702c6d6f7270686f0ecccccccccccccccccccccccccccccccccccccccc0180218021802180218021802180218021'
+ * )
+ * // @log: {
+ * //   codes: ['baseapp', 'morpho'],
+ * //   codeRegistryAddress: '0xcccccccccccccccccccccccccccccccccccccccc',
+ * //   id: 1
+ * // }
+ * ```
+ *
+ * @param data - The transaction calldata containing the attribution suffix.
+ * @returns The extracted attribution, or undefined if no valid attribution is found.
+ */
+export function fromData(data) {
+    // Check minimum length: ERC suffix (16 bytes) + schema ID (1 byte) + length (1 byte) = 18 bytes
+    const minSize = ercSuffixSize + 1 + 1;
+    if (Hex.size(data) < minSize)
+        return undefined;
+    // Verify ERC suffix is present at the end
+    const suffix = Hex.slice(data, -ercSuffixSize);
+    if (suffix !== ercSuffix)
+        return undefined;
+    // Extract schema ID (1 byte before the ERC suffix)
+    const schemaIdHex = Hex.slice(data, -ercSuffixSize - 1, -ercSuffixSize);
+    const schemaId = Hex.toNumber(schemaIdHex);
+    // Schema 0: Canonical registry
+    if (schemaId === 0) {
+        // Extract codes length (1 byte before schema ID)
+        const codesLengthHex = Hex.slice(data, -ercSuffixSize - 2, -ercSuffixSize - 1);
+        const codesLength = Hex.toNumber(codesLengthHex);
+        // Extract codes
+        const codesStart = -ercSuffixSize - 2 - codesLength;
+        const codesEnd = -ercSuffixSize - 2;
+        const codesHex = Hex.slice(data, codesStart, codesEnd);
+        const codesString = Hex.toString(codesHex);
+        const codes = codesString.length > 0 ? codesString.split(',') : [];
+        return { codes, id: 0 };
+    }
+    // Schema 1: Custom registry
+    // Format: codeRegistryAddress (20 bytes) ∥ codes ∥ codesLength (1 byte) ∥ schemaId (1 byte) ∥ ercSuffix
+    if (schemaId === 1) {
+        // Extract codes length (1 byte before schema ID)
+        const codesLengthHex = Hex.slice(data, -ercSuffixSize - 2, -ercSuffixSize - 1);
+        const codesLength = Hex.toNumber(codesLengthHex);
+        // Extract codes
+        const codesStart = -ercSuffixSize - 2 - codesLength;
+        const codesEnd = -ercSuffixSize - 2;
+        const codesHex = Hex.slice(data, codesStart, codesEnd);
+        const codesString = Hex.toString(codesHex);
+        const codes = codesString.length > 0 ? codesString.split(',') : [];
+        // Extract registry address (20 bytes before codes)
+        const registryStart = codesStart - 20;
+        const codeRegistryAddress = Hex.slice(data, registryStart, codesStart);
+        return {
+            codes,
+            codeRegistryAddress,
+            id: 1,
+        };
+    }
+    // Unknown schema ID
+    return undefined;
+}
+//# sourceMappingURL=Attribution.js.map

package/_esm/erc8021/Attribution.js.map

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

package/_esm/erc8021/index.js

@@ -0,0 +1,35 @@
+/**
+ * Utility functions for working with [ERC-8021 Transaction Attribution](https://eip.tools/eip/8021).
+ *
+ * @example
+ * ### Converting an Attribution to Data Suffix
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const dataSuffix1 = Attribution.toDataSuffix({
+ *   codes: ['baseapp']
+ * })
+ *
+ * const dataSuffix2 = Attribution.toDataSuffix({
+ *   codes: ['baseapp', 'morpho'],
+ *   codeRegistryAddress: '0x...'
+ * })
+ * ```
+ *
+ * @example
+ * ### Extracting an Attribution from Calldata
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData('0x...')
+ *
+ * console.log(attribution)
+ * // @log: { codes: ['baseapp', 'morpho'], codeRegistryAddress: '0x...' }
+ * ```
+ *
+ * @category ERC-8021
+ */
+export * as Attribution from './Attribution.js';
+//# sourceMappingURL=index.js.map

package/_esm/erc8021/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../erc8021/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}

package/_esm/index.docs.js

@@ -6,4 +6,5 @@ export * from './erc4337/index.js';
 export * from './erc6492/index.js';
 export * from './erc7821/index.js';
 export * from './erc8010/index.js';
+export * from './erc8021/index.js';
 //# sourceMappingURL=index.docs.js.map

package/_esm/index.docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.docs.js","sourceRoot":"","sources":["../index.docs.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,2FAA2F;AAC3F,gDAAgD;AAChD,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.docs.js","sourceRoot":"","sources":["../index.docs.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,2FAA2F;AAC3F,gDAAgD;AAChD,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/_esm/version.js

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

package/_types/erc8021/Attribution.d.ts

@@ -0,0 +1,149 @@
+import type * as Address from '../core/Address.js';
+import type * as Errors from '../core/Errors.js';
+import * as Hex from '../core/Hex.js';
+import type { OneOf } from '../core/internal/types.js';
+/**
+ * ERC-8021 Transaction Attribution.
+ *
+ * Represents attribution metadata that can be appended to transaction calldata
+ * to track entities involved in facilitating a transaction.
+ */
+export type Attribution = OneOf<AttributionSchemaId0 | AttributionSchemaId1>;
+/**
+ * Schema 0: Canonical Registry Attribution.
+ *
+ * Uses the canonical attribution code registry for resolving entity identities.
+ */
+export type AttributionSchemaId0 = {
+    /** Attribution codes identifying entities involved in the transaction. */
+    codes: readonly string[];
+    /** Schema identifier (0 for canonical registry). */
+    id?: 0 | undefined;
+};
+/**
+ * Schema 1: Custom Registry Attribution.
+ *
+ * Uses a custom registry contract for resolving attribution codes.
+ */
+export type AttributionSchemaId1 = {
+    /** Attribution codes identifying entities involved in the transaction. */
+    codes: readonly string[];
+    /** Address of the custom code registry contract. */
+    codeRegistryAddress: Address.Address;
+    /** Schema identifier (1 for custom registry). */
+    id?: 1 | undefined;
+};
+/**
+ * Attribution schema identifier.
+ *
+ * - `0`: Canonical registry
+ * - `1`: Custom registry
+ */
+export type SchemaId = NonNullable<AttributionSchemaId0['id'] | AttributionSchemaId1['id']>;
+/**
+ * ERC-8021 suffix identifier.
+ */
+export declare const ercSuffix: "0x80218021802180218021802180218021";
+/**
+ * Size of the ERC-8021 suffix (16 bytes).
+ */
+export declare const ercSuffixSize: number;
+/**
+ * Determines the schema ID for an {@link ox#Attribution.Attribution}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const schemaId = Attribution.getSchemaId({
+ *   codes: ['baseapp']
+ * })
+ * // @log: 0
+ *
+ * const schemaId2 = Attribution.getSchemaId({
+ *   codes: ['baseapp'],
+ *   codeRegistryAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+ * })
+ * // @log: 1
+ * ```
+ *
+ * @param attribution - The attribution object.
+ * @returns The schema ID (0 for canonical registry, 1 for custom registry).
+ */
+export declare function getSchemaId(attribution: Attribution): SchemaId;
+export declare namespace getSchemaId {
+    type ErrorType = Errors.GlobalErrorType;
+}
+/**
+ * Converts an {@link ox#Attribution.Attribution} to a data suffix that can be appended to transaction calldata.
+ *
+ * @example
+ * ### Schema 0 (Canonical Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   codes: ['baseapp', 'morpho']
+ * })
+ * // @log: '0x626173656170702c6d6f7270686f0e0080218021802180218021802180218021'
+ * ```
+ *
+ * @example
+ * ### Schema 1 (Custom Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   codes: ['baseapp'],
+ *   codeRegistryAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+ * })
+ * ```
+ *
+ * @param attribution - The attribution to convert.
+ * @returns The data suffix as a {@link ox#Hex.Hex} value.
+ */
+export declare function toDataSuffix(attribution: Attribution): Hex.Hex;
+export declare namespace toDataSuffix {
+    type ErrorType = getSchemaId.ErrorType | Hex.concat.ErrorType | Hex.fromString.ErrorType | Hex.fromNumber.ErrorType | Hex.size.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Extracts an {@link ox#Attribution.Attribution} from transaction calldata.
+ *
+ * @example
+ * ### Schema 0 (Canonical Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddd62617365617070070080218021802180218021802180218021'
+ * )
+ * // @log: { codes: ['baseapp'], id: 0 }
+ * ```
+ *
+ * @example
+ * ### Schema 1 (Custom Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddd626173656170702c6d6f7270686f0ecccccccccccccccccccccccccccccccccccccccc0180218021802180218021802180218021'
+ * )
+ * // @log: {
+ * //   codes: ['baseapp', 'morpho'],
+ * //   codeRegistryAddress: '0xcccccccccccccccccccccccccccccccccccccccc',
+ * //   id: 1
+ * // }
+ * ```
+ *
+ * @param data - The transaction calldata containing the attribution suffix.
+ * @returns The extracted attribution, or undefined if no valid attribution is found.
+ */
+export declare function fromData(data: Hex.Hex): Attribution | undefined;
+export declare namespace fromData {
+    type ErrorType = Hex.slice.ErrorType | Hex.toNumber.ErrorType | Hex.toString.ErrorType | Hex.size.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=Attribution.d.ts.map

package/_types/erc8021/Attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Attribution.d.ts","sourceRoot":"","sources":["../../erc8021/Attribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,oBAAoB,GAAG,oBAAoB,CAAC,CAAA;AAE5E;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,0EAA0E;IAC1E,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,oDAAoD;IACpD,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,0EAA0E;IAC1E,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,oDAAoD;IACpD,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAA;IACpC,iDAAiD;IACjD,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,CAAA;CACnB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,CAChC,oBAAoB,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CACxD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,sCAAgD,CAAA;AAEtE;;GAEG;AACH,eAAO,MAAM,aAAa,QAAoC,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,QAAQ,CAG9D;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,KAAK,SAAS,GAAG,MAAM,CAAC,eAAe,CAAA;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,GAAG,CAAC,GAAG,CA2B9D;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,KAAK,SAAS,GACV,WAAW,CAAC,SAAS,GACrB,GAAG,CAAC,MAAM,CAAC,SAAS,GACpB,GAAG,CAAC,UAAU,CAAC,SAAS,GACxB,GAAG,CAAC,UAAU,CAAC,SAAS,GACxB,GAAG,CAAC,IAAI,CAAC,SAAS,GAClB,MAAM,CAAC,eAAe,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,WAAW,GAAG,SAAS,CAgE/D;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAK,SAAS,GACV,GAAG,CAAC,KAAK,CAAC,SAAS,GACnB,GAAG,CAAC,QAAQ,CAAC,SAAS,GACtB,GAAG,CAAC,QAAQ,CAAC,SAAS,GACtB,GAAG,CAAC,IAAI,CAAC,SAAS,GAClB,MAAM,CAAC,eAAe,CAAA;CAC3B"}

package/_types/erc8021/index.d.ts

@@ -0,0 +1,37 @@
+/** @entrypointCategory ERCs */
+export type {};
+/**
+ * Utility functions for working with [ERC-8021 Transaction Attribution](https://eip.tools/eip/8021).
+ *
+ * @example
+ * ### Converting an Attribution to Data Suffix
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const dataSuffix1 = Attribution.toDataSuffix({
+ *   codes: ['baseapp']
+ * })
+ *
+ * const dataSuffix2 = Attribution.toDataSuffix({
+ *   codes: ['baseapp', 'morpho'],
+ *   codeRegistryAddress: '0x...'
+ * })
+ * ```
+ *
+ * @example
+ * ### Extracting an Attribution from Calldata
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData('0x...')
+ *
+ * console.log(attribution)
+ * // @log: { codes: ['baseapp', 'morpho'], codeRegistryAddress: '0x...' }
+ * ```
+ *
+ * @category ERC-8021
+ */
+export * as Attribution from './Attribution.js';
+//# sourceMappingURL=index.d.ts.map

package/_types/erc8021/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../erc8021/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,YAAY,EAAE,CAAA;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}

package/_types/index.docs.d.ts

@@ -4,4 +4,5 @@ export * from './erc4337/index.js';
 export * from './erc6492/index.js';
 export * from './erc7821/index.js';
 export * from './erc8010/index.js';
+export * from './erc8021/index.js';
 //# sourceMappingURL=index.docs.d.ts.map

package/_types/index.docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.docs.d.ts","sourceRoot":"","sources":["../index.docs.ts"],"names":[],"mappings":"AACA,2FAA2F;AAE3F,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.docs.d.ts","sourceRoot":"","sources":["../index.docs.ts"],"names":[],"mappings":"AACA,2FAA2F;AAE3F,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/_types/version.d.ts

@@ -1,3 +1,3 @@
 /** @internal */
-export declare const version = "0.9.10";
+export declare const version = "0.9.11";
 //# sourceMappingURL=version.d.ts.map

package/erc8021/Attribution/package.json

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

package/erc8021/Attribution.ts

@@ -0,0 +1,267 @@
+import type * as Address from '../core/Address.js'
+import type * as Errors from '../core/Errors.js'
+import * as Hex from '../core/Hex.js'
+import type { OneOf } from '../core/internal/types.js'
+
+/**
+ * ERC-8021 Transaction Attribution.
+ *
+ * Represents attribution metadata that can be appended to transaction calldata
+ * to track entities involved in facilitating a transaction.
+ */
+export type Attribution = OneOf<AttributionSchemaId0 | AttributionSchemaId1>
+
+/**
+ * Schema 0: Canonical Registry Attribution.
+ *
+ * Uses the canonical attribution code registry for resolving entity identities.
+ */
+export type AttributionSchemaId0 = {
+  /** Attribution codes identifying entities involved in the transaction. */
+  codes: readonly string[]
+  /** Schema identifier (0 for canonical registry). */
+  id?: 0 | undefined
+}
+
+/**
+ * Schema 1: Custom Registry Attribution.
+ *
+ * Uses a custom registry contract for resolving attribution codes.
+ */
+export type AttributionSchemaId1 = {
+  /** Attribution codes identifying entities involved in the transaction. */
+  codes: readonly string[]
+  /** Address of the custom code registry contract. */
+  codeRegistryAddress: Address.Address
+  /** Schema identifier (1 for custom registry). */
+  id?: 1 | undefined
+}
+
+/**
+ * Attribution schema identifier.
+ *
+ * - `0`: Canonical registry
+ * - `1`: Custom registry
+ */
+export type SchemaId = NonNullable<
+  AttributionSchemaId0['id'] | AttributionSchemaId1['id']
+>
+
+/**
+ * ERC-8021 suffix identifier.
+ */
+export const ercSuffix = '0x80218021802180218021802180218021' as const
+
+/**
+ * Size of the ERC-8021 suffix (16 bytes).
+ */
+export const ercSuffixSize = /*#__PURE__*/ Hex.size(ercSuffix)
+
+/**
+ * Determines the schema ID for an {@link ox#Attribution.Attribution}.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const schemaId = Attribution.getSchemaId({
+ *   codes: ['baseapp']
+ * })
+ * // @log: 0
+ *
+ * const schemaId2 = Attribution.getSchemaId({
+ *   codes: ['baseapp'],
+ *   codeRegistryAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+ * })
+ * // @log: 1
+ * ```
+ *
+ * @param attribution - The attribution object.
+ * @returns The schema ID (0 for canonical registry, 1 for custom registry).
+ */
+export function getSchemaId(attribution: Attribution): SchemaId {
+  if ('codeRegistryAddress' in attribution) return 1
+  return 0
+}
+
+export declare namespace getSchemaId {
+  type ErrorType = Errors.GlobalErrorType
+}
+
+/**
+ * Converts an {@link ox#Attribution.Attribution} to a data suffix that can be appended to transaction calldata.
+ *
+ * @example
+ * ### Schema 0 (Canonical Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   codes: ['baseapp', 'morpho']
+ * })
+ * // @log: '0x626173656170702c6d6f7270686f0e0080218021802180218021802180218021'
+ * ```
+ *
+ * @example
+ * ### Schema 1 (Custom Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   codes: ['baseapp'],
+ *   codeRegistryAddress: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+ * })
+ * ```
+ *
+ * @param attribution - The attribution to convert.
+ * @returns The data suffix as a {@link ox#Hex.Hex} value.
+ */
+export function toDataSuffix(attribution: Attribution): Hex.Hex {
+  // Encode the codes as ASCII strings separated by commas
+  const codesHex = Hex.fromString(attribution.codes.join(','))
+
+  // Get the byte length of the encoded codes
+  const codesLength = Hex.size(codesHex)
+
+  // Encode the codes length as 1 byte
+  const codesLengthHex = Hex.fromNumber(codesLength, { size: 1 })
+
+  // Determine schema ID
+  const schemaId = getSchemaId(attribution)
+  const schemaIdHex = Hex.fromNumber(schemaId, { size: 1 })
+
+  // Build the suffix based on schema
+  if (schemaId === 1)
+    // Schema 1: codeRegistryAddress ∥ codes ∥ codesLength ∥ schemaId ∥ ercSuffix
+    return Hex.concat(
+      attribution.codeRegistryAddress!.toLowerCase() as Address.Address,
+      codesHex,
+      codesLengthHex,
+      schemaIdHex,
+      ercSuffix,
+    )
+
+  // Schema 0: codes ∥ codesLength ∥ schemaId ∥ ercSuffix
+  return Hex.concat(codesHex, codesLengthHex, schemaIdHex, ercSuffix)
+}
+
+export declare namespace toDataSuffix {
+  type ErrorType =
+    | getSchemaId.ErrorType
+    | Hex.concat.ErrorType
+    | Hex.fromString.ErrorType
+    | Hex.fromNumber.ErrorType
+    | Hex.size.ErrorType
+    | Errors.GlobalErrorType
+}
+
+/**
+ * Extracts an {@link ox#Attribution.Attribution} from transaction calldata.
+ *
+ * @example
+ * ### Schema 0 (Canonical Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddd62617365617070070080218021802180218021802180218021'
+ * )
+ * // @log: { codes: ['baseapp'], id: 0 }
+ * ```
+ *
+ * @example
+ * ### Schema 1 (Custom Registry)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddd626173656170702c6d6f7270686f0ecccccccccccccccccccccccccccccccccccccccc0180218021802180218021802180218021'
+ * )
+ * // @log: {
+ * //   codes: ['baseapp', 'morpho'],
+ * //   codeRegistryAddress: '0xcccccccccccccccccccccccccccccccccccccccc',
+ * //   id: 1
+ * // }
+ * ```
+ *
+ * @param data - The transaction calldata containing the attribution suffix.
+ * @returns The extracted attribution, or undefined if no valid attribution is found.
+ */
+export function fromData(data: Hex.Hex): Attribution | undefined {
+  // Check minimum length: ERC suffix (16 bytes) + schema ID (1 byte) + length (1 byte) = 18 bytes
+  const minSize = ercSuffixSize + 1 + 1
+  if (Hex.size(data) < minSize) return undefined
+
+  // Verify ERC suffix is present at the end
+  const suffix = Hex.slice(data, -ercSuffixSize)
+  if (suffix !== ercSuffix) return undefined
+
+  // Extract schema ID (1 byte before the ERC suffix)
+  const schemaIdHex = Hex.slice(data, -ercSuffixSize - 1, -ercSuffixSize)
+  const schemaId = Hex.toNumber(schemaIdHex)
+
+  // Schema 0: Canonical registry
+  if (schemaId === 0) {
+    // Extract codes length (1 byte before schema ID)
+    const codesLengthHex = Hex.slice(
+      data,
+      -ercSuffixSize - 2,
+      -ercSuffixSize - 1,
+    )
+    const codesLength = Hex.toNumber(codesLengthHex)
+
+    // Extract codes
+    const codesStart = -ercSuffixSize - 2 - codesLength
+    const codesEnd = -ercSuffixSize - 2
+    const codesHex = Hex.slice(data, codesStart, codesEnd)
+    const codesString = Hex.toString(codesHex)
+    const codes = codesString.length > 0 ? codesString.split(',') : []
+
+    return { codes, id: 0 }
+  }
+
+  // Schema 1: Custom registry
+  // Format: codeRegistryAddress (20 bytes) ∥ codes ∥ codesLength (1 byte) ∥ schemaId (1 byte) ∥ ercSuffix
+  if (schemaId === 1) {
+    // Extract codes length (1 byte before schema ID)
+    const codesLengthHex = Hex.slice(
+      data,
+      -ercSuffixSize - 2,
+      -ercSuffixSize - 1,
+    )
+    const codesLength = Hex.toNumber(codesLengthHex)
+
+    // Extract codes
+    const codesStart = -ercSuffixSize - 2 - codesLength
+    const codesEnd = -ercSuffixSize - 2
+    const codesHex = Hex.slice(data, codesStart, codesEnd)
+    const codesString = Hex.toString(codesHex)
+    const codes = codesString.length > 0 ? codesString.split(',') : []
+
+    // Extract registry address (20 bytes before codes)
+    const registryStart = codesStart - 20
+    const codeRegistryAddress = Hex.slice(data, registryStart, codesStart)
+
+    return {
+      codes,
+      codeRegistryAddress,
+      id: 1,
+    }
+  }
+
+  // Unknown schema ID
+  return undefined
+}
+
+export declare namespace fromData {
+  type ErrorType =
+    | Hex.slice.ErrorType
+    | Hex.toNumber.ErrorType
+    | Hex.toString.ErrorType
+    | Hex.size.ErrorType
+    | Errors.GlobalErrorType
+}

package/erc8021/index.ts

@@ -0,0 +1,38 @@
+/** @entrypointCategory ERCs */
+// biome-ignore lint/complexity/noUselessEmptyExport: tsdoc
+export type {}
+
+/**
+ * Utility functions for working with [ERC-8021 Transaction Attribution](https://eip.tools/eip/8021).
+ *
+ * @example
+ * ### Converting an Attribution to Data Suffix
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const dataSuffix1 = Attribution.toDataSuffix({
+ *   codes: ['baseapp']
+ * })
+ *
+ * const dataSuffix2 = Attribution.toDataSuffix({
+ *   codes: ['baseapp', 'morpho'],
+ *   codeRegistryAddress: '0x...'
+ * })
+ * ```
+ *
+ * @example
+ * ### Extracting an Attribution from Calldata
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData('0x...')
+ *
+ * console.log(attribution)
+ * // @log: { codes: ['baseapp', 'morpho'], codeRegistryAddress: '0x...' }
+ * ```
+ *
+ * @category ERC-8021
+ */
+export * as Attribution from './Attribution.js'

package/erc8021/package.json

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

package/index.docs.ts

@@ -6,3 +6,4 @@ export * from './erc4337/index.js'
 export * from './erc6492/index.js'
 export * from './erc7821/index.js'
 export * from './erc8010/index.js'
+export * from './erc8021/index.js'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ox",
   "description": "Ethereum Standard Library",
-  "version": "0.9.10",
+  "version": "0.9.11",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -453,6 +453,16 @@
       "import": "./_esm/erc8010/index.js",
       "default": "./_cjs/erc8010/index.js"
     },
+    "./erc8021/Attribution": {
+      "types": "./_types/erc8021/Attribution.d.ts",
+      "import": "./_esm/erc8021/Attribution.js",
+      "default": "./_cjs/erc8021/Attribution.js"
+    },
+    "./erc8021": {
+      "types": "./_types/erc8021/index.d.ts",
+      "import": "./_esm/erc8021/index.js",
+      "default": "./_cjs/erc8021/index.js"
+    },
     "./index.docs": {
       "types": "./_types/index.docs.d.ts",
       "import": "./_esm/index.docs.js",

package/version.ts

@@ -1,2 +1,2 @@
 /** @internal */
-export const version = '0.9.10'
+export const version = '0.9.11'