ox 0.14.28 → 1.0.0-beta.0

package/dist/erc8021/Attribution.d.ts

@@ -0,0 +1,227 @@
+import type * as Address from '../core/Address.js';
+import * as Cbor from '../core/Cbor.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 | AttributionSchemaId2>;
+/**
+ * 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[];
+    codeRegistry: AttributionSchemaId1Registry;
+    /** Schema identifier (1 for custom registry). */
+    id?: 1 | undefined;
+};
+export type AttributionSchemaId1Registry = {
+    /** Address of the custom code registry contract. */
+    address: Address.Address;
+    /** Chain Id of the chain the custom code registry contract is deployed on. */
+    chainId: number;
+};
+/**
+ * Schema 2: CBOR-Encoded Attribution.
+ *
+ * Uses CBOR encoding for extensible transaction annotation with optional fields,
+ * support for arbitrary metadata, and coexistence with other suffix-based systems.
+ */
+export type AttributionSchemaId2 = {
+    /** Application attribution code. */
+    appCode?: string | undefined;
+    /** Wallet attribution code. */
+    walletCode?: string | undefined;
+    /** Service codes identifying additional service providers (e.g., block builders, relayers, solvers). */
+    serviceCodes?: readonly string[] | undefined;
+    /** Custom code registries keyed by entity type. */
+    registries?: AttributionSchemaId2Registries | undefined;
+    /** Arbitrary metadata key-value pairs. */
+    metadata?: Record<string, unknown> | undefined;
+    /** Schema identifier (2 for CBOR-encoded). */
+    id?: 2 | undefined;
+};
+export type AttributionSchemaId2Registries = {
+    /** Custom registry for the application entity. */
+    app?: AttributionSchemaId2Registry | undefined;
+    /** Custom registry for the wallet entity. */
+    wallet?: AttributionSchemaId2Registry | undefined;
+};
+export type AttributionSchemaId2Registry = {
+    /** Address of the custom code registry contract. */
+    address: Address.Address;
+    /** Chain ID of the chain the custom code registry contract is deployed on. */
+    chainId: number;
+};
+/**
+ * Attribution schema identifier.
+ *
+ * - `0`: Canonical registry
+ * - `1`: Custom registry
+ * - `2`: CBOR-encoded
+ */
+export type SchemaId = NonNullable<AttributionSchemaId0['id'] | AttributionSchemaId1['id'] | AttributionSchemaId2['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'],
+ *   codeRegistry: {
+ *     address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+ *     chainId: 8453
+ *   }
+ * })
+ * // @log: 1
+ *
+ * const schemaId3 = Attribution.getSchemaId({
+ *   appCode: 'baseapp'
+ * })
+ * // @log: 2
+ * ```
+ *
+ * @param attribution - The attribution object.
+ * @returns The schema ID (0 for canonical registry, 1 for custom registry, 2 for CBOR-encoded).
+ */
+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'],
+ *   codeRegistry: {
+ *     address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+ *     chainId: 8453
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * ### Schema 2 (CBOR-Encoded)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   appCode: 'baseapp',
+ *   walletCode: 'privy',
+ *   metadata: { source: 'webapp' }
+ * })
+ * ```
+ *
+ * @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 | Cbor.encode.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(
+ *   '0xddddddddcccccccccccccccccccccccccccccccccccccccc210502626173656170702C6D6F7270686F0E0180218021802180218021802180218021'
+ * )
+ * // @log: {
+ * // @log:   codes: ['baseapp', 'morpho'],
+ * // @log:   codeRegistry: {
+ * // @log:       address: '0xcccccccccccccccccccccccccccccccccccccccc',
+ * // @log:       chainId: 8453,
+ * // @log:   },
+ * // @log:   id: 1
+ * // @log: }
+ * ```
+ *
+ * @example
+ * ### Schema 2 (CBOR-Encoded)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddda161616762617365617070000b0280218021802180218021802180218021'
+ * )
+ * // @log: { appCode: 'baseapp', id: 2 }
+ * ```
+ *
+ * @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 | Cbor.decode.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=Attribution.d.ts.map

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

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

package/dist/erc8021/Attribution.js

@@ -0,0 +1,330 @@
+import * as Cbor from '../core/Cbor.js';
+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'],
+ *   codeRegistry: {
+ *     address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+ *     chainId: 8453
+ *   }
+ * })
+ * // @log: 1
+ *
+ * const schemaId3 = Attribution.getSchemaId({
+ *   appCode: 'baseapp'
+ * })
+ * // @log: 2
+ * ```
+ *
+ * @param attribution - The attribution object.
+ * @returns The schema ID (0 for canonical registry, 1 for custom registry, 2 for CBOR-encoded).
+ */
+export function getSchemaId(attribution) {
+    if ('appCode' in attribution ||
+        'walletCode' in attribution ||
+        'serviceCodes' in attribution)
+        return 2;
+    if ('codeRegistry' 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'],
+ *   codeRegistry: {
+ *     address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+ *     chainId: 8453
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * ### Schema 2 (CBOR-Encoded)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const suffix = Attribution.toDataSuffix({
+ *   appCode: 'baseapp',
+ *   walletCode: 'privy',
+ *   metadata: { source: 'webapp' }
+ * })
+ * ```
+ *
+ * @param attribution - The attribution to convert.
+ * @returns The data suffix as a {@link ox#Hex.Hex} value.
+ */
+export function toDataSuffix(attribution) {
+    // Determine schema ID
+    const schemaId = getSchemaId(attribution);
+    // Schema 2: CBOR-encoded
+    if (schemaId === 2) {
+        const schema2 = attribution;
+        return schema2ToDataSuffix(schema2);
+    }
+    // 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 });
+    const schemaIdHex = Hex.fromNumber(schemaId, { size: 1 });
+    // Schema 1: codeRegistryAddress (20 bytes) ∥ chainId ∥ chainIdLength (1 byte) ∥ codes ∥ codesLength (1 byte) ∥ schemaId (1 byte) ∥ ercSuffix
+    if (schemaId === 1) {
+        const schema1 = attribution;
+        return Hex.concat(registryToData(schema1.codeRegistry), 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(
+ *   '0xddddddddcccccccccccccccccccccccccccccccccccccccc210502626173656170702C6D6F7270686F0E0180218021802180218021802180218021'
+ * )
+ * // @log: {
+ * // @log:   codes: ['baseapp', 'morpho'],
+ * // @log:   codeRegistry: {
+ * // @log:       address: '0xcccccccccccccccccccccccccccccccccccccccc',
+ * // @log:       chainId: 8453,
+ * // @log:   },
+ * // @log:   id: 1
+ * // @log: }
+ * ```
+ *
+ * @example
+ * ### Schema 2 (CBOR-Encoded)
+ *
+ * ```ts twoslash
+ * import { Attribution } from 'ox/erc8021'
+ *
+ * const attribution = Attribution.fromData(
+ *   '0xdddddddda161616762617365617070000b0280218021802180218021802180218021'
+ * )
+ * // @log: { appCode: 'baseapp', id: 2 }
+ * ```
+ *
+ * @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 schemaIdEnd = -ercSuffixSize;
+    const schemaIdStart = schemaIdEnd - 1;
+    const schemaId = Hex.toNumber(Hex.slice(data, schemaIdStart, schemaIdEnd));
+    // Schema 0: Canonical registry
+    // Schema 1: Custom registry
+    // Format: [codeRegistryAddress (20) ∥ chainId ∥ chainIdLength (1)]? ∥ codes ∥ codesLength (1) ∥ schemaId (1) ∥ ercSuffix
+    if (schemaId === 0 || schemaId === 1) {
+        const codes = decodeCodesTail(data, schemaIdStart);
+        if (!codes)
+            return undefined;
+        if (schemaId === 0)
+            return { codes: codes.codes, id: 0 };
+        // Extract registry by reading backwards from just before codes
+        const codeRegistry = registryFromData(Hex.slice(data, 0, codes.codesStart));
+        if (codeRegistry === undefined)
+            return undefined;
+        return {
+            codes: codes.codes,
+            codeRegistry,
+            id: 1,
+        };
+    }
+    // Schema 2: CBOR-encoded
+    if (schemaId === 2) {
+        return schema2FromData(data);
+    }
+    // Unknown schema ID
+    return undefined;
+}
+/**
+ * Reads the trailing `codes ∥ codesLength (1)` segment from a schema-0/1
+ * payload, given the absolute end-offset of the codes-length byte (which is
+ * the start of the schema ID).
+ *
+ * @internal
+ */
+function decodeCodesTail(data, schemaIdStart) {
+    const codesLengthEnd = schemaIdStart;
+    const codesLengthStart = codesLengthEnd - 1;
+    const codesLength = Hex.toNumber(Hex.slice(data, codesLengthStart, codesLengthEnd));
+    const codesEnd = codesLengthStart;
+    const codesStart = codesEnd - codesLength;
+    const codesHex = Hex.slice(data, codesStart, codesEnd);
+    const codesString = Hex.toString(codesHex);
+    const codes = codesString.length > 0 ? codesString.split(',') : [];
+    return { codes, codesStart };
+}
+function registryFromData(data) {
+    // Expect at least: address (20 bytes) + chainIdLen (1 byte)
+    const minRegistrySize = 20 + 1;
+    if (Hex.size(data) < minRegistrySize)
+        return undefined;
+    // Read chainId length from the last byte of the registry segment
+    const chainIdLenHex = Hex.slice(data, -1);
+    const chainIdLen = Hex.toNumber(chainIdLenHex);
+    if (chainIdLen === 0)
+        return undefined;
+    // Validate we have enough bytes to cover address + chainId + chainIdLen
+    const totalRegistrySize = 20 + chainIdLen + 1;
+    if (Hex.size(data) < totalRegistrySize)
+        return undefined;
+    // Address is located immediately before chainId and chainIdLen (read from back)
+    const addressStart = -(chainIdLen + 1 + 20);
+    const addressEnd = -(chainIdLen + 1);
+    const addressHex = Hex.slice(data, addressStart, addressEnd);
+    // Chain ID occupies the bytes preceding the final length byte (read from back)
+    const chainIdHex = Hex.slice(data, -(chainIdLen + 1), -1);
+    const codeRegistry = {
+        address: addressHex,
+        chainId: Hex.toNumber(chainIdHex),
+    };
+    return codeRegistry;
+}
+function registryToData(registry) {
+    const chainIdAsHex = Hex.fromNumber(registry.chainId);
+    const chainIdLen = Hex.size(chainIdAsHex);
+    // Need to padleft because the output of size may not be a full byte (1 -> 0x1 vs 0x01)
+    const paddedChainId = Hex.padLeft(chainIdAsHex, chainIdLen);
+    return Hex.concat(registry.address, paddedChainId, Hex.fromNumber(chainIdLen, { size: 1 }));
+}
+function schema2ToDataSuffix(attribution) {
+    // Build the CBOR map using single-letter keys per the spec
+    const cborMap = {};
+    if (attribution.appCode)
+        cborMap.a = attribution.appCode;
+    if (attribution.walletCode)
+        cborMap.w = attribution.walletCode;
+    if (attribution.serviceCodes && attribution.serviceCodes.length > 0)
+        cborMap.s = [...attribution.serviceCodes];
+    if (attribution.registries) {
+        const r = {};
+        if (attribution.registries.app) {
+            r.a = {
+                c: Hex.fromNumber(attribution.registries.app.chainId),
+                a: attribution.registries.app.address,
+            };
+        }
+        if (attribution.registries.wallet) {
+            r.w = {
+                c: Hex.fromNumber(attribution.registries.wallet.chainId),
+                a: attribution.registries.wallet.address,
+            };
+        }
+        if (r.a || r.w)
+            cborMap.r = r;
+    }
+    if (attribution.metadata && Object.keys(attribution.metadata).length > 0)
+        cborMap.m = attribution.metadata;
+    // Encode to CBOR
+    const cborHex = Cbor.encode(cborMap);
+    const cborBytes = Hex.size(cborHex);
+    // cborData ∥ cborLength (2 bytes) ∥ schemaId (1 byte) ∥ ercSuffix
+    return Hex.concat(cborHex, Hex.fromNumber(cborBytes, { size: 2 }), Hex.fromNumber(2, { size: 1 }), ercSuffix);
+}
+function schema2FromData(data) {
+    // cborLength is 2 bytes before schema ID
+    const cborLengthHex = Hex.slice(data, -ercSuffixSize - 1 - 2, -ercSuffixSize - 1);
+    const cborLength = Hex.toNumber(cborLengthHex);
+    // Extract CBOR data
+    const cborStart = -ercSuffixSize - 1 - 2 - cborLength;
+    const cborEnd = -ercSuffixSize - 1 - 2;
+    const cborHex = Hex.slice(data, cborStart, cborEnd);
+    // Decode CBOR
+    const decoded = Cbor.decode(cborHex);
+    const result = { id: 2 };
+    if (typeof decoded.a === 'string')
+        result.appCode = decoded.a;
+    if (typeof decoded.w === 'string')
+        result.walletCode = decoded.w;
+    if (Array.isArray(decoded.s))
+        result.serviceCodes = decoded.s;
+    if (decoded.r) {
+        const registries = {};
+        if (decoded.r.a?.c && decoded.r.a?.a) {
+            registries.app = {
+                address: decoded.r.a.a,
+                chainId: Hex.toNumber(decoded.r.a.c),
+            };
+        }
+        if (decoded.r.w?.c && decoded.r.w?.a) {
+            registries.wallet = {
+                address: decoded.r.w.a,
+                chainId: Hex.toNumber(decoded.r.w.c),
+            };
+        }
+        if (registries.app || registries.wallet)
+            result.registries = registries;
+    }
+    if (decoded.m && typeof decoded.m === 'object')
+        result.metadata = decoded.m;
+    return result;
+}
+//# sourceMappingURL=Attribution.js.map

package/dist/erc8021/Attribution.js.map

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

package/dist/erc8021/index.d.ts

@@ -0,0 +1,44 @@
+/** @entrypointCategory ERCs */
+/**
+ * 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'],
+ *   codeRegistry: {
+ *     address: '0x0000000000000000000000000000000000000000',
+ *     chainId: 1
+ *   }
+ * })
+ *
+ * const dataSuffix3 = Attribution.toDataSuffix({
+ *   appCode: 'baseapp',
+ *   walletCode: 'privy'
+ * })
+ * ```
+ *
+ * @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'], codeRegistry: { address: '0x...', chainId: 1 } }
+ * ```
+ *
+ * @category ERC-8021
+ */
+export * as Attribution from './Attribution.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/erc8021/index.js

@@ -0,0 +1,45 @@
+/** @entrypointCategory ERCs */
+// biome-ignore lint/complexity/noUselessEmptyExport: tsdoc
+/**
+ * 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'],
+ *   codeRegistry: {
+ *     address: '0x0000000000000000000000000000000000000000',
+ *     chainId: 1
+ *   }
+ * })
+ *
+ * const dataSuffix3 = Attribution.toDataSuffix({
+ *   appCode: 'baseapp',
+ *   walletCode: 'privy'
+ * })
+ * ```
+ *
+ * @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'], codeRegistry: { address: '0x...', chainId: 1 } }
+ * ```
+ *
+ * @category ERC-8021
+ */
+export * as Attribution from './Attribution.js';
+//# sourceMappingURL=index.js.map

package/dist/erc8021/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/erc8021/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,2DAA2D;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA"}