ox 0.9.9 → 0.9.11

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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
+
+- [`f61d713`](https://github.com/wevm/ox/commit/f61d713d6dd5387b5f4d1c71643b28e77e1aaff8) Thanks [@jxom](https://github.com/jxom)! - Added `version` and `docsOrigin` to `Errors.BaseError`.
+
 ## 0.9.9
 
 ### Patch Changes

package/_cjs/core/Errors.js

@@ -24,7 +24,7 @@ class BaseError extends Error {
                 return options.cause.docsPath || options.docsPath;
             return options.docsPath;
         })();
-        const docsBaseUrl = 'https://oxlib.sh';
+        const docsBaseUrl = options.docsOrigin ?? 'https://oxlib.sh';
         const docs = `${docsBaseUrl}${docsPath ?? ''}`;
         const message = [
             shortMessage || 'An error occurred.',
@@ -36,6 +36,7 @@ class BaseError extends Error {
                     docsPath ? `See: ${docs}` : undefined,
                 ]
                 : []),
+            ...(options.version ? [`Version: ${options.version}`] : []),
         ]
             .filter((x) => typeof x === 'string')
             .join('\n');
@@ -64,29 +65,30 @@ class BaseError extends Error {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "cause", {
+        Object.defineProperty(this, "version", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "name", {
+        Object.defineProperty(this, "cause", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: 'BaseError'
+            value: void 0
         });
-        Object.defineProperty(this, "version", {
+        Object.defineProperty(this, "name", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: `ox@${(0, errors_js_1.getVersion)()}`
+            value: 'BaseError'
         });
         this.cause = options.cause;
         this.details = details;
         this.docs = docs;
         this.docsPath = docsPath;
         this.shortMessage = shortMessage;
+        this.version = options.version ?? `ox@${(0, errors_js_1.getVersion)()}`;
     }
     walk(fn) {
         return walk(this, fn);

package/_cjs/core/Errors.js.map

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

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.9';
+exports.version = '0.9.11';
 //# sourceMappingURL=version.js.map

package/_cjs/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../version.ts"],"names":[],"mappings":";;;AACa,QAAA,OAAO,GAAG,OAAO,CAAA"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../version.ts"],"names":[],"mappings":";;;AACa,QAAA,OAAO,GAAG,QAAQ,CAAA"}

package/_esm/core/Address.js

@@ -76,14 +76,14 @@ export function checksum(address) {
     return result;
 }
 /**
- * Converts a stringified address to a typed (checksummed) {@link ox#Address.Address}.
+ * Converts a stringified address to a typed (optionally checksummed) {@link ox#Address.Address}.
  *
  * @example
  * ```ts twoslash
  * import { Address } from 'ox'
  *
  * Address.from('0xa0cf798816d4b9b9866b5330eea46a18382f251e')
- * // @log: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'
+ * // @log: '0xa0cf798816d4b9b9866b5330eea46a18382f251e'
  * ```
  *
  * @example
@@ -91,9 +91,9 @@ export function checksum(address) {
  * import { Address } from 'ox'
  *
  * Address.from('0xa0cf798816d4b9b9866b5330eea46a18382f251e', {
- *   checksum: false
+ *   checksum: true
  * })
- * // @log: '0xa0cf798816d4b9b9866b5330eea46a18382f251e'
+ * // @log: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'
  * ```
  *
  * @example

package/_esm/core/Errors.js

@@ -30,7 +30,7 @@ export class BaseError extends Error {
                 return options.cause.docsPath || options.docsPath;
             return options.docsPath;
         })();
-        const docsBaseUrl = 'https://oxlib.sh';
+        const docsBaseUrl = options.docsOrigin ?? 'https://oxlib.sh';
         const docs = `${docsBaseUrl}${docsPath ?? ''}`;
         const message = [
             shortMessage || 'An error occurred.',
@@ -42,6 +42,7 @@ export class BaseError extends Error {
                     docsPath ? `See: ${docs}` : undefined,
                 ]
                 : []),
+            ...(options.version ? [`Version: ${options.version}`] : []),
         ]
             .filter((x) => typeof x === 'string')
             .join('\n');
@@ -70,29 +71,30 @@ export class BaseError extends Error {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "cause", {
+        Object.defineProperty(this, "version", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "name", {
+        Object.defineProperty(this, "cause", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: 'BaseError'
+            value: void 0
         });
-        Object.defineProperty(this, "version", {
+        Object.defineProperty(this, "name", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: `ox@${getVersion()}`
+            value: 'BaseError'
         });
         this.cause = options.cause;
         this.details = details;
         this.docs = docs;
         this.docsPath = docsPath;
         this.shortMessage = shortMessage;
+        this.version = options.version ?? `ox@${getVersion()}`;
     }
     walk(fn) {
         return walk(this, fn);

package/_esm/core/Errors.js.map

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

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.9';
+export const version = '0.9.11';
 //# sourceMappingURL=version.js.map

package/_esm/version.js.map

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

package/_types/core/Address.d.ts

@@ -57,14 +57,14 @@ export declare namespace checksum {
     type ErrorType = assert.ErrorType | Hash.keccak256.ErrorType | Bytes.fromString.ErrorType | Errors.GlobalErrorType;
 }
 /**
- * Converts a stringified address to a typed (checksummed) {@link ox#Address.Address}.
+ * Converts a stringified address to a typed (optionally checksummed) {@link ox#Address.Address}.
  *
  * @example
  * ```ts twoslash
  * import { Address } from 'ox'
  *
  * Address.from('0xa0cf798816d4b9b9866b5330eea46a18382f251e')
- * // @log: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'
+ * // @log: '0xa0cf798816d4b9b9866b5330eea46a18382f251e'
  * ```
  *
  * @example
@@ -72,9 +72,9 @@ export declare namespace checksum {
  * import { Address } from 'ox'
  *
  * Address.from('0xa0cf798816d4b9b9866b5330eea46a18382f251e', {
- *   checksum: false
+ *   checksum: true
  * })
- * // @log: '0xa0cf798816d4b9b9866b5330eea46a18382f251e'
+ * // @log: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'
  * ```
  *
  * @example

package/_types/core/Errors.d.ts

@@ -15,9 +15,9 @@ export declare class BaseError<cause extends Error | undefined = undefined> exte
     docs?: string | undefined;
     docsPath?: string | undefined;
     shortMessage: string;
+    version?: string | undefined;
     cause: cause;
     name: string;
-    version: string;
     constructor(shortMessage: string, options?: BaseError.Options<cause>);
     walk(): Error;
     walk(fn: (err: unknown) => boolean): Error | null;
@@ -26,8 +26,10 @@ export declare namespace BaseError {
     type Options<cause extends Error | undefined = Error | undefined> = {
         cause?: cause | undefined;
         details?: string | undefined;
+        docsOrigin?: string | undefined;
         docsPath?: string | undefined;
         metaMessages?: (string | undefined)[] | undefined;
+        version?: string | undefined;
     };
 }
 //# sourceMappingURL=Errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../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,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;IA+CxE,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"}
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../../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,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAEnB,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,SAAc;gBAEf,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAM;IAiDxE,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,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,SAAS,CAAA;QACjD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF"}

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.9";
+export declare const version = "0.9.11";
 //# sourceMappingURL=version.d.ts.map

package/_types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../version.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,eAAO,MAAM,OAAO,UAAU,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../version.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,eAAO,MAAM,OAAO,WAAW,CAAA"}

package/core/Address.ts

@@ -112,14 +112,14 @@ export declare namespace checksum {
 }
 
 /**
- * Converts a stringified address to a typed (checksummed) {@link ox#Address.Address}.
+ * Converts a stringified address to a typed (optionally checksummed) {@link ox#Address.Address}.
  *
  * @example
  * ```ts twoslash
  * import { Address } from 'ox'
  *
  * Address.from('0xa0cf798816d4b9b9866b5330eea46a18382f251e')
- * // @log: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'
+ * // @log: '0xa0cf798816d4b9b9866b5330eea46a18382f251e'
  * ```
  *
  * @example
@@ -127,9 +127,9 @@ export declare namespace checksum {
  * import { Address } from 'ox'
  *
  * Address.from('0xa0cf798816d4b9b9866b5330eea46a18382f251e', {
- *   checksum: false
+ *   checksum: true
  * })
- * // @log: '0xa0cf798816d4b9b9866b5330eea46a18382f251e'
+ * // @log: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e'
  * ```
  *
  * @example

package/core/Errors.ts

@@ -20,12 +20,11 @@ export class BaseError<
   docs?: string | undefined
   docsPath?: string | undefined
   shortMessage: string
+  version?: string | undefined
 
   override cause: cause
   override name = 'BaseError'
 
-  version = `ox@${getVersion()}`
-
   constructor(shortMessage: string, options: BaseError.Options<cause> = {}) {
     const details = (() => {
       if (options.cause instanceof BaseError) {
@@ -47,7 +46,7 @@ export class BaseError<
       return options.docsPath
     })()
 
-    const docsBaseUrl = 'https://oxlib.sh'
+    const docsBaseUrl = options.docsOrigin ?? 'https://oxlib.sh'
     const docs = `${docsBaseUrl}${docsPath ?? ''}`
 
     const message = [
@@ -60,6 +59,7 @@ export class BaseError<
             docsPath ? `See: ${docs}` : undefined,
           ]
         : []),
+      ...(options.version ? [`Version: ${options.version}`] : []),
     ]
       .filter((x) => typeof x === 'string')
       .join('\n')
@@ -71,6 +71,7 @@ export class BaseError<
     this.docs = docs
     this.docsPath = docsPath
     this.shortMessage = shortMessage
+    this.version = options.version ?? `ox@${getVersion()}`
   }
 
   walk(): Error
@@ -84,8 +85,10 @@ export declare namespace BaseError {
   type Options<cause extends Error | undefined = Error | undefined> = {
     cause?: cause | undefined
     details?: string | undefined
+    docsOrigin?: string | undefined
     docsPath?: string | undefined
     metaMessages?: (string | undefined)[] | undefined
+    version?: string | undefined
   }
 }
 

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.9",
+  "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.9'
+export const version = '0.9.11'