viem 0.2.11 → 0.2.13

package/dist/esm/utils/abi/decodeAbiParameters.js

@@ -0,0 +1,225 @@
+import { AbiDecodingDataSizeInvalidError, AbiDecodingDataSizeTooSmallError, AbiDecodingZeroDataError, InvalidAbiDecodingTypeError, } from '../../errors/index.js';
+import { checksumAddress } from '../address/index.js';
+import { size, slice, trim } from '../data/index.js';
+import { hexToBigInt, hexToBool, hexToNumber, hexToString, } from '../encoding/index.js';
+import { getArrayComponents } from './encodeAbiParameters.js';
+export function decodeAbiParameters(params, data) {
+    if (data === '0x' && params.length > 0)
+        throw new AbiDecodingZeroDataError();
+    if (size(data) % 32 !== 0)
+        throw new AbiDecodingDataSizeInvalidError({ data, size: size(data) });
+    return decodeParams({
+        data,
+        params: params,
+    });
+}
+function decodeParams({ data, params, }) {
+    const decodedValues = [];
+    let position = 0;
+    for (let i = 0; i < params.length; i++) {
+        if (position >= size(data))
+            throw new AbiDecodingDataSizeTooSmallError({
+                data,
+                params,
+                size: size(data),
+            });
+        const param = params[i];
+        const { consumed, value } = decodeParam({ data, param, position });
+        decodedValues.push(value);
+        // Step across the data by the amount of data consumed by this parameter.
+        position += consumed;
+    }
+    return decodedValues;
+}
+function decodeParam({ data, param, position, }) {
+    const arrayComponents = getArrayComponents(param.type);
+    if (arrayComponents) {
+        const [length, type] = arrayComponents;
+        return decodeArray(data, {
+            length,
+            param: { ...param, type: type },
+            position,
+        });
+    }
+    if (param.type === 'tuple') {
+        return decodeTuple(data, { param: param, position });
+    }
+    if (param.type === 'string') {
+        return decodeString(data, { position });
+    }
+    if (param.type.startsWith('bytes')) {
+        return decodeBytes(data, { param, position });
+    }
+    const value = slice(data, position, position + 32);
+    if (param.type.startsWith('uint') || param.type.startsWith('int')) {
+        return decodeNumber(value, { param });
+    }
+    if (param.type === 'address') {
+        return decodeAddress(value);
+    }
+    if (param.type === 'bool') {
+        return decodeBool(value);
+    }
+    throw new InvalidAbiDecodingTypeError(param.type, {
+        docsPath: '/docs/contract/decodeAbiParameters',
+    });
+}
+////////////////////////////////////////////////////////////////////
+function decodeAddress(value) {
+    return { consumed: 32, value: checksumAddress(slice(value, -20)) };
+}
+function decodeArray(data, { param, length, position, }) {
+    // If the length of the array is not known in advance (dynamic array),
+    // we will need to decode the offset of the array data.
+    if (!length) {
+        // Get the offset of the array data.
+        const offset = hexToNumber(slice(data, position, position + 32));
+        // Get the length of the array from the offset.
+        const length = hexToNumber(slice(data, offset, offset + 32));
+        let consumed = 0;
+        const value = [];
+        for (let i = 0; i < length; ++i) {
+            const decodedChild = decodeParam({
+                data: slice(data, offset + 32),
+                param,
+                position: consumed,
+            });
+            consumed += decodedChild.consumed;
+            value.push(decodedChild.value);
+        }
+        return { value, consumed: 32 };
+    }
+    // If the length of the array is known in advance,
+    // and the length of an element deeply nested in the array is not known,
+    // we need to decode the offset of the array data.
+    if (hasDynamicChild(param)) {
+        // Get the child type of the array.
+        const arrayComponents = getArrayComponents(param.type);
+        // If the child type is not known, the array is dynamic.
+        const dynamicChild = !arrayComponents?.[0];
+        let consumed = 0;
+        const value = [];
+        for (let i = 0; i < length; ++i) {
+            const offset = hexToNumber(slice(data, position, position + 32));
+            const decodedChild = decodeParam({
+                data: slice(data, offset),
+                param,
+                position: dynamicChild ? consumed : i * 32,
+            });
+            consumed += decodedChild.consumed;
+            value.push(decodedChild.value);
+        }
+        return { value, consumed: 32 };
+    }
+    // If the length of the array is known in advance,
+    // and the length of each element in the array is known,
+    // the array data is encoded contiguously after the array.
+    let consumed = 0;
+    const value = [];
+    for (let i = 0; i < length; ++i) {
+        const decodedChild = decodeParam({
+            data,
+            param,
+            position: position + consumed,
+        });
+        consumed += decodedChild.consumed;
+        value.push(decodedChild.value);
+    }
+    return { value, consumed };
+}
+function decodeBool(value) {
+    return { consumed: 32, value: hexToBool(value) };
+}
+function decodeBytes(data, { param, position }) {
+    const [_, size] = param.type.split('bytes');
+    if (!size) {
+        // If we don't have a size, we're dealing with a dynamic-size array
+        // so we need to read the offset of the data part first.
+        const offset = hexToNumber(slice(data, position, position + 32));
+        const length = hexToNumber(slice(data, offset, offset + 32));
+        // If there is no length, we have zero data.
+        if (length === 0)
+            return { consumed: 32, value: '0x' };
+        const value = slice(data, offset + 32, offset + 32 + length);
+        return { consumed: 32, value };
+    }
+    const value = slice(data, position, position + parseInt(size));
+    return { consumed: 32, value };
+}
+function decodeNumber(value, { param }) {
+    const signed = param.type.startsWith('int');
+    const size = parseInt(param.type.split('int')[1] || '256');
+    return {
+        consumed: 32,
+        value: size > 48
+            ? hexToBigInt(value, { signed })
+            : hexToNumber(value, { signed }),
+    };
+}
+function decodeString(data, { position }) {
+    const offset = hexToNumber(slice(data, position, position + 32));
+    const length = hexToNumber(slice(data, offset, offset + 32));
+    // If there is no length, we have zero data (empty string).
+    if (length === 0)
+        return { consumed: 32, value: '' };
+    const value = hexToString(trim(slice(data, offset + 32, offset + 32 + length)));
+    return { consumed: 32, value };
+}
+function decodeTuple(data, { param, position }) {
+    // Tuples can have unnamed components (i.e. they are arrays), so we must
+    // determine whether the tuple is named or unnamed. In the case of a named
+    // tuple, the value will be an object where each property is the name of the
+    // component. In the case of an unnamed tuple, the value will be an array.
+    const hasUnnamedChild = param.components.length === 0 || param.components.some(({ name }) => !name);
+    // Initialize the value to an object or an array, depending on whether the
+    // tuple is named or unnamed.
+    const value = hasUnnamedChild ? [] : {};
+    let consumed = 0;
+    // If the tuple has a dynamic child, we must first decode the offset to the
+    // tuple data.
+    if (hasDynamicChild(param)) {
+        const offset = hexToNumber(slice(data, position, position + 32));
+        // Decode each component of the tuple, starting at the offset.
+        for (let i = 0; i < param.components.length; ++i) {
+            const component = param.components[i];
+            const decodedChild = decodeParam({
+                data: slice(data, offset),
+                param: component,
+                position: consumed,
+            });
+            consumed += decodedChild.consumed;
+            value[hasUnnamedChild ? i : component?.name] = decodedChild.value;
+        }
+        return { consumed: 32, value };
+    }
+    // If the tuple has static children, we can just decode each component
+    // in sequence.
+    for (let i = 0; i < param.components.length; ++i) {
+        const component = param.components[i];
+        const decodedChild = decodeParam({
+            data,
+            param: component,
+            position: position + consumed,
+        });
+        consumed += decodedChild.consumed;
+        value[hasUnnamedChild ? i : component?.name] = decodedChild.value;
+    }
+    return { consumed, value };
+}
+function hasDynamicChild(param) {
+    const { type } = param;
+    if (type === 'string')
+        return true;
+    if (type === 'bytes')
+        return true;
+    if (type.endsWith('[]'))
+        return true;
+    if (type === 'tuple')
+        return param.components?.some(hasDynamicChild);
+    const arrayComponents = getArrayComponents(param.type);
+    if (arrayComponents &&
+        hasDynamicChild({ ...param, type: arrayComponents[1] }))
+        return true;
+    return false;
+}
+//# sourceMappingURL=decodeAbiParameters.js.map

package/dist/esm/utils/abi/decodeAbiParameters.js.map

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

package/dist/esm/utils/abi/decodeDeployData.js

@@ -0,0 +1,17 @@
+import { AbiConstructorNotFoundError, AbiConstructorParamsNotFoundError, } from '../../errors/index.js';
+import { decodeAbiParameters } from './decodeAbiParameters.js';
+const docsPath = '/docs/contract/decodeDeployData';
+export function decodeDeployData({ abi, bytecode, data, }) {
+    if (data === bytecode)
+        return { bytecode };
+    const description = abi.find((x) => 'type' in x && x.type === 'constructor');
+    if (!description)
+        throw new AbiConstructorNotFoundError({ docsPath });
+    if (!('inputs' in description))
+        throw new AbiConstructorParamsNotFoundError({ docsPath });
+    if (!description.inputs || description.inputs.length === 0)
+        throw new AbiConstructorParamsNotFoundError({ docsPath });
+    const args = decodeAbiParameters(description.inputs, `0x${data.replace(bytecode, '')}`);
+    return { args, bytecode };
+}
+//# sourceMappingURL=decodeDeployData.js.map

package/dist/esm/utils/abi/decodeDeployData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeDeployData.js","sourceRoot":"","sources":["../../../../src/utils/abi/decodeDeployData.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,MAAM,QAAQ,GAAG,iCAAiC,CAAA;AAclD,MAAM,UAAU,gBAAgB,CAAwC,EACtE,GAAG,EACH,QAAQ,EACR,IAAI,GAC6B;IACjC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;IAE1C,MAAM,WAAW,GAAI,GAAW,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAC/C,CAAA;IACD,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,2BAA2B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IACrE,IAAI,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC;QAC5B,MAAM,IAAI,iCAAiC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC3D,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QACxD,MAAM,IAAI,iCAAiC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IAE3D,MAAM,IAAI,GAAG,mBAAmB,CAC9B,WAAW,CAAC,MAAM,EAClB,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAClC,CAAA;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC3B,CAAC"}

package/dist/esm/utils/abi/decodeErrorResult.js

@@ -0,0 +1,25 @@
+import { solidityError, solidityPanic } from '../../constants/index.js';
+import { AbiDecodingZeroDataError, AbiErrorSignatureNotFoundError, } from '../../errors/index.js';
+import { slice } from '../data/index.js';
+import { getFunctionSelector } from '../hash/index.js';
+import { decodeAbiParameters } from './decodeAbiParameters.js';
+import { formatAbiItem } from './formatAbiItem.js';
+export function decodeErrorResult({ abi, data, }) {
+    const signature = slice(data, 0, 4);
+    if (signature === '0x')
+        throw new AbiDecodingZeroDataError();
+    const abi_ = [...(abi || []), solidityError, solidityPanic];
+    const abiItem = abi_.find((x) => x.type === 'error' && signature === getFunctionSelector(formatAbiItem(x)));
+    if (!abiItem)
+        throw new AbiErrorSignatureNotFoundError(signature, {
+            docsPath: '/docs/contract/decodeErrorResult',
+        });
+    return {
+        abiItem,
+        args: ('inputs' in abiItem && abiItem.inputs && abiItem.inputs.length > 0
+            ? decodeAbiParameters(abiItem.inputs, slice(data, 4))
+            : undefined),
+        errorName: abiItem.name,
+    };
+}
+//# sourceMappingURL=decodeErrorResult.js.map

package/dist/esm/utils/abi/decodeErrorResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeErrorResult.js","sourceRoot":"","sources":["../../../../src/utils/abi/decodeErrorResult.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAUlD,MAAM,UAAU,iBAAiB,CAAC,EAChC,GAAG,EACH,IAAI,GACwB;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACnC,IAAI,SAAS,KAAK,IAAI;QAAE,MAAM,IAAI,wBAAwB,EAAE,CAAA;IAE5D,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,SAAS,KAAK,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC5E,CAAA;IACD,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,8BAA8B,CAAC,SAAS,EAAE;YAClD,QAAQ,EAAE,kCAAkC;SAC7C,CAAC,CAAA;IACJ,OAAO;QACL,OAAO;QACP,IAAI,EAAE,CAAC,QAAQ,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACvE,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC,CAAC,SAAS,CAAmC;QAChD,SAAS,EAAG,OAA4B,CAAC,IAAI;KAC9C,CAAA;AACH,CAAC"}

package/dist/esm/utils/abi/decodeEventLog.js

@@ -0,0 +1,75 @@
+import { AbiDecodingDataSizeTooSmallError, AbiEventSignatureEmptyTopicsError, AbiEventSignatureNotFoundError, DecodeLogTopicsMismatch, } from '../../errors/index.js';
+import { getEventSelector } from '../hash/index.js';
+import { decodeAbiParameters } from './decodeAbiParameters.js';
+import { formatAbiItem } from './formatAbiItem.js';
+import { DecodeLogDataMismatch } from '../../errors/abi.js';
+const docsPath = '/docs/contract/decodeEventLog';
+export function decodeEventLog({ abi, data, topics, }) {
+    const [signature, ...argTopics] = topics;
+    if (!signature)
+        throw new AbiEventSignatureEmptyTopicsError({
+            docsPath,
+        });
+    const abiItem = abi.find((x) => x.type === 'event' &&
+        signature === getEventSelector(formatAbiItem(x)));
+    if (!(abiItem && 'name' in abiItem))
+        throw new AbiEventSignatureNotFoundError(signature, {
+            docsPath,
+        });
+    const { name, inputs } = abiItem;
+    const isUnnamed = inputs?.some((x) => !('name' in x && x.name));
+    let args = isUnnamed ? [] : {};
+    // Decode topics (indexed args).
+    if (argTopics.length > 0) {
+        const indexedInputs = inputs.filter((x) => 'indexed' in x && x.indexed);
+        for (let i = 0; i < indexedInputs.length; i++) {
+            const param = indexedInputs[i];
+            const topic = argTopics[i];
+            if (!topic)
+                throw new DecodeLogTopicsMismatch({
+                    abiItem,
+                    param: param,
+                });
+            args[param.name || i] = decodeTopic({ param, value: topic });
+        }
+    }
+    // Decode data (non-indexed args).
+    if (data && data !== '0x') {
+        const params = inputs.filter((x) => !('indexed' in x && x.indexed));
+        try {
+            const decodedData = decodeAbiParameters(params, data);
+            if (decodedData) {
+                if (isUnnamed)
+                    args = [...args, ...decodedData];
+                else {
+                    for (let i = 0; i < params.length; i++) {
+                        args[params[i].name] = decodedData[i];
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof AbiDecodingDataSizeTooSmallError)
+                throw new DecodeLogDataMismatch({
+                    data: err.data,
+                    params: err.params,
+                    size: err.size,
+                });
+            throw err;
+        }
+    }
+    return {
+        eventName: name,
+        args: Object.values(args).length > 0 ? args : undefined,
+    };
+}
+function decodeTopic({ param, value }) {
+    if (param.type === 'string' ||
+        param.type === 'bytes' ||
+        param.type === 'tuple' ||
+        param.type.match(/^(.*)\[(\d+)?\]$/))
+        return value;
+    const decodedArg = decodeAbiParameters([param], value) || [];
+    return decodedArg[0];
+}
+//# sourceMappingURL=decodeEventLog.js.map

package/dist/esm/utils/abi/decodeEventLog.js.map

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

package/dist/esm/utils/abi/decodeFunctionData.js

@@ -0,0 +1,23 @@
+import { AbiFunctionSignatureNotFoundError } from '../../errors/index.js';
+import { slice } from '../data/index.js';
+import { getFunctionSelector } from '../hash/index.js';
+import { decodeAbiParameters } from './decodeAbiParameters.js';
+import { formatAbiItem } from './formatAbiItem.js';
+export function decodeFunctionData({ abi, data, }) {
+    const signature = slice(data, 0, 4);
+    const description = abi.find((x) => x.type === 'function' &&
+        signature === getFunctionSelector(formatAbiItem(x)));
+    if (!description)
+        throw new AbiFunctionSignatureNotFoundError(signature, {
+            docsPath: '/docs/contract/decodeFunctionData',
+        });
+    return {
+        functionName: description.name,
+        args: ('inputs' in description &&
+            description.inputs &&
+            description.inputs.length > 0
+            ? decodeAbiParameters(description.inputs, slice(data, 4))
+            : undefined),
+    };
+}
+//# sourceMappingURL=decodeFunctionData.js.map

package/dist/esm/utils/abi/decodeFunctionData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeFunctionData.js","sourceRoot":"","sources":["../../../../src/utils/abi/decodeFunctionData.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAA;AAEzE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAuBlD,MAAM,UAAU,kBAAkB,CAAwC,EACxE,GAAG,EACH,IAAI,GAC+B;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACnC,MAAM,WAAW,GAAI,GAAW,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,UAAU;QACrB,SAAS,KAAK,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CACtD,CAAA;IACD,IAAI,CAAC,WAAW;QACd,MAAM,IAAI,iCAAiC,CAAC,SAAS,EAAE;YACrD,QAAQ,EAAE,mCAAmC;SAC9C,CAAC,CAAA;IACJ,OAAO;QACL,YAAY,EAAG,WAAgC,CAAC,IAAI;QACpD,IAAI,EAAE,CAAC,QAAQ,IAAI,WAAW;YAC9B,WAAW,CAAC,MAAM;YAClB,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAC3B,CAAC,CAAC,mBAAmB,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACzD,CAAC,CAAC,SAAS,CAAmC;KACX,CAAA;AACzC,CAAC"}

package/dist/esm/utils/abi/decodeFunctionResult.js

@@ -0,0 +1,22 @@
+import { AbiFunctionNotFoundError, AbiFunctionOutputsNotFoundError, } from '../../errors/index.js';
+import { decodeAbiParameters } from './decodeAbiParameters.js';
+import { getAbiItem } from './getAbiItem.js';
+const docsPath = '/docs/contract/decodeFunctionResult';
+export function decodeFunctionResult({ abi, args, functionName, data, }) {
+    const description = getAbiItem({
+        abi,
+        args,
+        name: functionName,
+    });
+    if (!description)
+        throw new AbiFunctionNotFoundError(functionName, { docsPath });
+    if (!('outputs' in description))
+        throw new AbiFunctionOutputsNotFoundError(functionName, { docsPath });
+    const values = decodeAbiParameters(description.outputs, data);
+    if (values && values.length > 1)
+        return values;
+    if (values && values.length === 1)
+        return values[0];
+    return undefined;
+}
+//# sourceMappingURL=decodeFunctionResult.js.map

package/dist/esm/utils/abi/decodeFunctionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeFunctionResult.js","sourceRoot":"","sources":["../../../../src/utils/abi/decodeFunctionResult.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,uBAAuB,CAAA;AAO9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5C,MAAM,QAAQ,GAAG,qCAAqC,CAAA;AAgBtD,MAAM,UAAU,oBAAoB,CAGlC,EACA,GAAG,EACH,IAAI,EACJ,YAAY,EACZ,IAAI,GAIL;IACC,MAAM,WAAW,GAAG,UAAU,CAAC;QAC7B,GAAG;QACH,IAAI;QACJ,IAAI,EAAE,YAAY;KACK,CAAC,CAAA;IAC1B,IAAI,CAAC,WAAW;QACd,MAAM,IAAI,wBAAwB,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAChE,IAAI,CAAC,CAAC,SAAS,IAAI,WAAW,CAAC;QAC7B,MAAM,IAAI,+BAA+B,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEvE,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAC7D,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAa,CAAA;IACrD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAQ,CAAA;IAC1D,OAAO,SAAgB,CAAA;AACzB,CAAC"}

package/dist/esm/utils/abi/encodeAbiParameters.js

@@ -0,0 +1,214 @@
+import { AbiEncodingArrayLengthMismatchError, AbiEncodingBytesSizeMismatchError, AbiEncodingLengthMismatchError, InvalidAbiEncodingTypeError, InvalidAddressError, InvalidArrayError, } from '../../errors/index.js';
+import { isAddress } from '../address/index.js';
+import { concat, padHex, size, slice } from '../data/index.js';
+import { boolToHex, numberToHex, stringToHex } from '../encoding/index.js';
+/**
+ * @description Encodes a list of primitive values into an ABI-encoded hex value.
+ */
+export function encodeAbiParameters(params, values) {
+    if (params.length !== values.length)
+        throw new AbiEncodingLengthMismatchError({
+            expectedLength: params.length,
+            givenLength: values.length,
+        });
+    // Prepare the parameters to determine dynamic types to encode.
+    const preparedParams = prepareParams({
+        params: params,
+        values,
+    });
+    const data = encodeParams(preparedParams);
+    if (data.length === 0)
+        return '0x';
+    return data;
+}
+function prepareParams({ params, values, }) {
+    const preparedParams = [];
+    for (let i = 0; i < params.length; i++) {
+        preparedParams.push(prepareParam({ param: params[i], value: values[i] }));
+    }
+    return preparedParams;
+}
+function prepareParam({ param, value, }) {
+    const arrayComponents = getArrayComponents(param.type);
+    if (arrayComponents) {
+        const [length, type] = arrayComponents;
+        return encodeArray(value, { length, param: { ...param, type } });
+    }
+    if (param.type === 'tuple') {
+        return encodeTuple(value, {
+            param: param,
+        });
+    }
+    if (param.type === 'address') {
+        return encodeAddress(value);
+    }
+    if (param.type === 'bool') {
+        return encodeBool(value);
+    }
+    if (param.type.startsWith('uint') || param.type.startsWith('int')) {
+        const signed = param.type.startsWith('int');
+        return encodeNumber(value, { signed });
+    }
+    if (param.type.startsWith('bytes')) {
+        return encodeBytes(value, { param });
+    }
+    if (param.type === 'string') {
+        return encodeString(value);
+    }
+    throw new InvalidAbiEncodingTypeError(param.type, {
+        docsPath: '/docs/contract/encodeAbiParameters',
+    });
+}
+/////////////////////////////////////////////////////////////////
+function encodeParams(preparedParams) {
+    // 1. Compute the size of the static part of the parameters.
+    let staticSize = 0;
+    for (let i = 0; i < preparedParams.length; i++) {
+        const { dynamic, encoded } = preparedParams[i];
+        if (dynamic)
+            staticSize += 32;
+        else
+            staticSize += size(encoded);
+    }
+    // 2. Split the parameters into static and dynamic parts.
+    const staticParams = [];
+    const dynamicParams = [];
+    let dynamicSize = 0;
+    for (let i = 0; i < preparedParams.length; i++) {
+        const { dynamic, encoded } = preparedParams[i];
+        if (dynamic) {
+            staticParams.push(numberToHex(staticSize + dynamicSize, { size: 32 }));
+            dynamicParams.push(encoded);
+            dynamicSize += size(encoded);
+        }
+        else {
+            staticParams.push(encoded);
+        }
+    }
+    // 3. Concatenate static and dynamic parts.
+    return concat([...staticParams, ...dynamicParams]);
+}
+/////////////////////////////////////////////////////////////////
+function encodeAddress(value) {
+    if (!isAddress(value))
+        throw new InvalidAddressError({ address: value });
+    return { dynamic: false, encoded: padHex(value.toLowerCase()) };
+}
+function encodeArray(value, { length, param, }) {
+    const dynamic = length === null;
+    if (!Array.isArray(value))
+        throw new InvalidArrayError(value);
+    if (!dynamic && value.length !== length)
+        throw new AbiEncodingArrayLengthMismatchError({
+            expectedLength: length,
+            givenLength: value.length,
+            type: `${param.type}[${length}]`,
+        });
+    let dynamicChild = false;
+    const preparedParams = [];
+    for (let i = 0; i < value.length; i++) {
+        const preparedParam = prepareParam({ param, value: value[i] });
+        if (preparedParam.dynamic)
+            dynamicChild = true;
+        preparedParams.push(preparedParam);
+    }
+    if (dynamic || dynamicChild) {
+        const data = encodeParams(preparedParams);
+        if (dynamic) {
+            const length = numberToHex(preparedParams.length, { size: 32 });
+            return {
+                dynamic: true,
+                encoded: preparedParams.length > 0 ? concat([length, data]) : length,
+            };
+        }
+        if (dynamicChild)
+            return { dynamic: true, encoded: data };
+    }
+    return {
+        dynamic: false,
+        encoded: concat(preparedParams.map(({ encoded }) => encoded)),
+    };
+}
+function encodeBytes(value, { param }) {
+    const [_, size_] = param.type.split('bytes');
+    if (!size_) {
+        const partsLength = Math.ceil(size(value) / 32);
+        const parts = [];
+        for (let i = 0; i < partsLength; i++) {
+            parts.push(padHex(slice(value, i * 32, (i + 1) * 32), {
+                dir: 'right',
+            }));
+        }
+        return {
+            dynamic: true,
+            encoded: concat([
+                padHex(numberToHex(size(value), { size: 32 })),
+                ...parts,
+            ]),
+        };
+    }
+    if (size(value) !== parseInt(size_))
+        throw new AbiEncodingBytesSizeMismatchError({
+            expectedSize: parseInt(size_),
+            value,
+        });
+    return { dynamic: false, encoded: padHex(value, { dir: 'right' }) };
+}
+function encodeBool(value) {
+    return { dynamic: false, encoded: padHex(boolToHex(value)) };
+}
+function encodeNumber(value, { signed }) {
+    return {
+        dynamic: false,
+        encoded: numberToHex(value, {
+            size: 32,
+            signed,
+        }),
+    };
+}
+function encodeString(value) {
+    const hexValue = stringToHex(value);
+    const partsLength = Math.ceil(size(hexValue) / 32);
+    const parts = [];
+    for (let i = 0; i < partsLength; i++) {
+        parts.push(padHex(slice(hexValue, i * 32, (i + 1) * 32), {
+            dir: 'right',
+        }));
+    }
+    return {
+        dynamic: true,
+        encoded: concat([
+            padHex(numberToHex(size(hexValue), { size: 32 })),
+            ...parts,
+        ]),
+    };
+}
+function encodeTuple(value, { param }) {
+    let dynamic = false;
+    const preparedParams = [];
+    for (let i = 0; i < param.components.length; i++) {
+        const param_ = param.components[i];
+        const index = Array.isArray(value) ? i : param_.name;
+        const preparedParam = prepareParam({
+            param: param_,
+            value: value[index],
+        });
+        preparedParams.push(preparedParam);
+        if (preparedParam.dynamic)
+            dynamic = true;
+    }
+    return {
+        dynamic,
+        encoded: dynamic
+            ? encodeParams(preparedParams)
+            : concat(preparedParams.map(({ encoded }) => encoded)),
+    };
+}
+export function getArrayComponents(type) {
+    const matches = type.match(/^(.*)\[(\d+)?\]$/);
+    return matches
+        ? // Return `null` if the array is dynamic.
+            [matches[2] ? Number(matches[2]) : null, matches[1]]
+        : undefined;
+}
+//# sourceMappingURL=encodeAbiParameters.js.map