viem 2.53.1 → 2.54.1

package/_esm/actions/token/getTotalSupply.js

@@ -0,0 +1,60 @@
+import { erc20Abi } from '../../constants/abis.js';
+import { readContract } from '../public/readContract.js';
+import { defineCall, resolveToken, resolveTokenWithDecimals, toAmount, } from './internal.js';
+/**
+ * Gets the total supply of an ERC-20 token.
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { token } from 'viem/actions'
+ *
+ * const client = createClient({ chain: mainnet, transport: http() })
+ *
+ * const totalSupply = await token.getTotalSupply(client, {
+ *   token: '0x...',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The token total supply, in base units and human-readable form.
+ */
+export async function getTotalSupply(client, parameters) {
+    const { decimals, token, ...rest } = parameters;
+    const [amount, { decimals: resolved }] = await Promise.all([
+        readContract(client, {
+            ...rest,
+            ...getTotalSupply.call(client, { token }),
+        }),
+        resolveTokenWithDecimals(client, {
+            decimals,
+            token,
+        }),
+    ]);
+    return toAmount(amount, resolved);
+}
+(function (getTotalSupply) {
+    /**
+     * Defines a call to the `totalSupply` function.
+     *
+     * Can be passed as a parameter to `multicall`, `simulateContract`, or any
+     * other action that accepts a contract call. The token is selected by `token`
+     * symbol (resolved from the client's `tokens` array) or contract address.
+     *
+     * @param client - Client.
+     * @param args - Arguments.
+     * @returns The call.
+     */
+    function call(client, args) {
+        return defineCall({
+            address: resolveToken(client, args).address,
+            abi: erc20Abi,
+            args: [],
+            functionName: 'totalSupply',
+        });
+    }
+    getTotalSupply.call = call;
+})(getTotalSupply || (getTotalSupply = {}));
+//# sourceMappingURL=getTotalSupply.js.map

package/_esm/actions/token/getTotalSupply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTotalSupply.js","sourceRoot":"","sources":["../../../actions/token/getTotalSupply.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAEL,UAAU,EAEV,YAAY,EACZ,wBAAwB,EAExB,QAAQ,GACT,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAKlC,MAAuE,EACvE,UAAoD;IAEpD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,CAAA;IAC/C,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzD,YAAY,CAAC,MAAM,EAAE;YACnB,GAAG,IAAI;YACP,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAW,CAAC;SACnD,CAAC;QACF,wBAAwB,CAAC,MAAM,EAAE;YAC/B,QAAQ;YACR,KAAK;SACN,CAAC;KACH,CAAC,CAAA;IACF,OAAO,QAAQ,CAAC,MAAgB,EAAE,QAAQ,CAAC,CAAA;AAC7C,CAAC;AAED,WAAiB,cAAc;IAW7B;;;;;;;;;;OAUG;IACH,SAAgB,IAAI,CAKlB,MAAuE,EACvE,IAAyB;QAEzB,OAAO,UAAU,CAAC;YAChB,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,OAAO;YAC3C,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,EAAE;YACR,YAAY,EAAE,aAAa;SAC5B,CAAC,CAAA;IACJ,CAAC;IAde,mBAAI,OAcnB,CAAA;AACH,CAAC,EArCgB,cAAc,KAAd,cAAc,QAqC9B"}

package/_esm/actions/token/index.js

@@ -0,0 +1,10 @@
+// biome-ignore lint/performance/noBarrelFile: entrypoint module
+export { approve } from './approve.js';
+export { approveSync } from './approveSync.js';
+export { getAllowance } from './getAllowance.js';
+export { getBalance } from './getBalance.js';
+export { getMetadata } from './getMetadata.js';
+export { getTotalSupply } from './getTotalSupply.js';
+export { transfer } from './transfer.js';
+export { transferSync } from './transferSync.js';
+//# sourceMappingURL=index.js.map

package/_esm/actions/token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../actions/token/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/_esm/actions/token/internal.js

@@ -0,0 +1,188 @@
+import { erc20Abi } from '../../constants/abis.js';
+import { isAddress } from '../../utils/address/isAddress.js';
+import { isAddressEqual } from '../../utils/address/isAddressEqual.js';
+import { encodeFunctionData } from '../../utils/index.js';
+import { formatUnits } from '../../utils/unit/formatUnits.js';
+import { parseUnits } from '../../utils/unit/parseUnits.js';
+import { readContract } from '../public/readContract.js';
+/**
+ * Shapes a base-unit value into an {@link Amount} (base units, `decimals`, and
+ * human-readable `formatted` string).
+ *
+ * @param amount - Amount in base units.
+ * @param decimals - Token decimals used to format the amount.
+ * @returns The {@link Amount}.
+ */
+export function toAmount(amount, decimals) {
+    return { amount, decimals, formatted: formatUnits(amount, decimals) };
+}
+/**
+ * Resolves a write amount to base units.
+ *
+ * @param amount - Base-unit amount, or formatted helper.
+ * @param decimals - Token decimals used to parse formatted amounts.
+ * @returns Amount in base units.
+ */
+export function toBaseUnits(amount, decimals) {
+    if (typeof amount === 'bigint')
+        return amount;
+    const resolved = amount.decimals ?? decimals;
+    return parseUnits(amount.formatted, requireTokenDecimals(resolved));
+}
+/**
+ * Requires resolved token decimals for parsing or formatting amounts.
+ *
+ * @param decimals - Token decimals.
+ * @returns Token decimals.
+ * @internal
+ */
+export function requireTokenDecimals(decimals) {
+    if (decimals === undefined)
+        throw new Error('Token decimals are required. Pass `amount.decimals` or select a declared token.');
+    return decimals;
+}
+/**
+ * Resolves the decimals used for formatting a write amount.
+ *
+ * @param amount - Base-unit amount, or formatted helper.
+ * @param decimals - Token decimals.
+ * @returns Token decimals, overridden by the formatted helper when present.
+ */
+export function resolveAmountDecimals(amount, decimals) {
+    if (typeof amount === 'bigint')
+        return decimals;
+    return amount.decimals ?? decimals;
+}
+/**
+ * Resolves the token contract `address` and `decimals` from a `token`, which is
+ * either the symbol of a token declared on the client's `tokens` array or a
+ * contract `address`.
+ *
+ * When `token` is a declared symbol, the `address` and `decimals` are resolved
+ * from the Client's `tokens` array for the Client's `chain.id` (`decimals` can
+ * be overridden via the explicit `decimals`). When `token` is an address, its
+ * `decimals` is inferred from the Client's `tokens` array when the address
+ * matches a declared token, otherwise taken from the explicit `decimals`.
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The resolved `address` and `decimals`.
+ */
+export function resolveToken(client, parameters) {
+    const { decimals, token } = parameters;
+    const declared = findDeclaredToken(client, token);
+    if (declared)
+        return {
+            address: declared.address,
+            decimals: decimals ?? declared.decimals,
+        };
+    if (isAddress(token, { strict: false }))
+        return {
+            address: token,
+            decimals: decimals ?? inferDecimals(client, token),
+        };
+    throw new Error(`Token "${token}" is not a declared ERC-20 token on the client's \`tokens\` array (with an address for the client's chain), and is not a valid address.`);
+}
+/**
+ * Finds the declared token on the Client's `tokens` array matching `token`
+ * (either a token symbol or contract `address`), resolved to a {@link ResolvedToken}
+ * for the Client's `chain.id`. Returns `undefined` when no declared token
+ * matches, or the matching token has no address for the Client's chain.
+ *
+ * @param client - Client.
+ * @param token - Token symbol (declared on the client's `tokens` array) or contract address.
+ * @returns The matching resolved token config, or `undefined`.
+ */
+export function findDeclaredToken(client, token) {
+    const tokens = client.tokens;
+    const chainId = client.chain?.id;
+    if (!tokens || chainId === undefined)
+        return undefined;
+    const bySymbol = findTokenBySymbol(tokens, token);
+    if (bySymbol)
+        return resolveTokenForChain(bySymbol, chainId);
+    if (isAddress(token, { strict: false }))
+        for (const token_ of tokens) {
+            const resolved = resolveTokenForChain(token_, chainId);
+            if (resolved && isAddressEqual(resolved.address, token))
+                return resolved;
+        }
+    return undefined;
+}
+/**
+ * Resolves a {@link Token} to a {@link ResolvedToken} for `chainId`, or
+ * `undefined` when the token has no address for `chainId`. @internal
+ */
+function resolveTokenForChain(token, chainId) {
+    const address = token.addresses[chainId];
+    if (!address)
+        return undefined;
+    return {
+        address,
+        currency: token.currency,
+        decimals: token.decimals,
+        name: token.name,
+        popular: token.popular,
+        symbol: token.symbol,
+    };
+}
+/** Finds a {@link Token} by symbol (case-insensitively) on a `tokens` array. @internal */
+function findTokenBySymbol(tokens, symbol) {
+    const lowerSymbol = symbol.toLowerCase();
+    for (const token of tokens) {
+        if (token.symbol?.toLowerCase() === lowerSymbol)
+            return token;
+    }
+    return undefined;
+}
+/**
+ * Infers a token's `decimals` from the Client's `tokens` array by matching
+ * `address` against each token's address for the Client's `chain.id`.
+ * @internal
+ */
+function inferDecimals(client, address) {
+    const tokens = client.tokens;
+    const chainId = client.chain?.id;
+    if (tokens && chainId !== undefined)
+        for (const token of tokens) {
+            const resolved = resolveTokenForChain(token, chainId);
+            if (resolved && isAddressEqual(resolved.address, address))
+                return resolved.decimals;
+        }
+    return undefined;
+}
+/**
+ * Resolves token decimals, fetching from the token contract when they are not
+ * provided explicitly or declared on the client.
+ * @internal
+ */
+export async function resolveTokenWithDecimals(client, parameters) {
+    const { address, decimals } = resolveToken(client, parameters);
+    if (decimals !== undefined)
+        return { address, decimals };
+    return {
+        address,
+        decimals: await readContract(client, {
+            abi: erc20Abi,
+            address,
+            functionName: 'decimals',
+        }),
+    };
+}
+/**
+ * Picks the transaction-override fields shared by write actions, so the
+ * action-specific args (`token`, `amount`, `to`, etc.) don't leak into
+ * `estimateContractGas` / `simulateContract` requests. @internal
+ */
+export function pickWriteParameters(parameters) {
+    const { account, chain, gas, maxFeePerGas, maxPriorityFeePerGas, nonce } = parameters;
+    return { account, chain, gas, maxFeePerGas, maxPriorityFeePerGas, nonce };
+}
+export function defineCall(call) {
+    return {
+        ...call,
+        data: encodeFunctionData(call),
+        to: call.address,
+    };
+}
+//# sourceMappingURL=internal.js.map

package/_esm/actions/token/internal.js.map

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

package/_esm/actions/token/transfer.js

@@ -0,0 +1,147 @@
+import { erc20Abi } from '../../constants/abis.js';
+import { parseEventLogs } from '../../utils/abi/parseEventLogs.js';
+import { estimateContractGas } from '../public/estimateContractGas.js';
+import { simulateContract, } from '../public/simulateContract.js';
+import { writeContract } from '../wallet/writeContract.js';
+import { defineCall, pickWriteParameters, resolveToken, toBaseUnits, } from './internal.js';
+/**
+ * Transfers ERC-20 tokens to another address.
+ *
+ * Pass `from` to transfer on behalf of another address using an allowance
+ * (calls `transferFrom`); otherwise transfers from the caller (calls
+ * `transfer`).
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { token } from 'viem/actions'
+ *
+ * const client = createClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const hash = await token.transfer(client, {
+ *   amount: 100000000n,
+ *   to: '0x...',
+ *   token: '0x...',
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Transfer on behalf of another address (via an allowance).
+ * const hash = await token.transfer(client, {
+ *   amount: 100000000n,
+ *   from: '0x...',
+ *   to: '0x...',
+ *   token: '0x...',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The transaction hash.
+ */
+export async function transfer(client, parameters) {
+    return transfer.inner(writeContract, client, parameters);
+}
+(function (transfer) {
+    /** @internal */
+    async function inner(action, client, parameters) {
+        return (await action(client, {
+            ...parameters,
+            ...transfer.call(client, parameters),
+        }));
+    }
+    transfer.inner = inner;
+    /**
+     * Defines a call to the `transfer` (or `transferFrom`, when `from` is given)
+     * function.
+     *
+     * Can be passed as a parameter to `estimateContractGas`, `simulateContract`,
+     * `sendCalls`, `sendTransaction` (`calls`), or `multicall`. The token is
+     * selected by `token`, which is either a token symbol (resolved from the
+     * client's `tokens` array) or a contract `address`; `amount.decimals`
+     * is inferred from declared client tokens when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The call.
+     */
+    function call(client, parameters) {
+        return defineCall(getCall(client, parameters));
+    }
+    transfer.call = call;
+    /**
+     * Estimates the gas required to transfer ERC-20 tokens. `amount.decimals` is
+     * inferred from declared client tokens when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The gas estimate.
+     */
+    async function estimateGas(client, parameters) {
+        return estimateContractGas(client, {
+            ...pickWriteParameters(parameters),
+            ...transfer.call(client, parameters),
+        });
+    }
+    transfer.estimateGas = estimateGas;
+    /**
+     * Simulates a transfer of ERC-20 tokens. `amount.decimals` is inferred from
+     * declared client tokens when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The simulation result and write request.
+     */
+    async function simulate(client, parameters) {
+        return simulateContract(client, {
+            ...pickWriteParameters(parameters),
+            ...transfer.call(client, parameters),
+        });
+    }
+    transfer.simulate = simulate;
+    /**
+     * Extracts the `Transfer` event from logs.
+     *
+     * @param logs - The logs.
+     * @returns The `Transfer` event.
+     */
+    function extractEvent(logs) {
+        const [log] = parseEventLogs({
+            abi: erc20Abi,
+            logs,
+            eventName: 'Transfer',
+            strict: true,
+        });
+        if (!log)
+            throw new Error('`Transfer` event not found.');
+        return log;
+    }
+    transfer.extractEvent = extractEvent;
+})(transfer || (transfer = {}));
+/** Builds the underlying `transfer`/`transferFrom` contract call. @internal */
+function getCall(client, parameters) {
+    const { amount, from, to, token } = parameters;
+    const { address, decimals } = resolveToken(client, { token });
+    const value = toBaseUnits(amount, decimals);
+    if (from)
+        return {
+            abi: erc20Abi,
+            address,
+            args: [from, to, value],
+            functionName: 'transferFrom',
+        };
+    return {
+        abi: erc20Abi,
+        address,
+        args: [to, value],
+        functionName: 'transfer',
+    };
+}
+//# sourceMappingURL=transfer.js.map

package/_esm/actions/token/transfer.js.map

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

package/_esm/actions/token/transferSync.js

@@ -0,0 +1,54 @@
+import { formatUnits } from '../../utils/unit/formatUnits.js';
+import { writeContractSync } from '../wallet/writeContractSync.js';
+import { resolveAmountDecimals, resolveToken } from './internal.js';
+import { transfer } from './transfer.js';
+/**
+ * Transfers ERC-20 tokens to another address, and waits for the transaction to
+ * be confirmed.
+ *
+ * Pass `from` to transfer on behalf of another address using an allowance
+ * (calls `transferFrom`); otherwise transfers from the caller (calls
+ * `transfer`).
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { token } from 'viem/actions'
+ *
+ * const client = createClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ *
+ * const { receipt, ...event } = await token.transferSync(client, {
+ *   amount: 100000000n,
+ *   to: '0x...',
+ *   token: '0x...',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The transaction receipt and event data.
+ */
+export async function transferSync(client, parameters) {
+    const { amount, token, throwOnReceiptRevert = true } = parameters;
+    const { decimals } = resolveToken(client, { token });
+    const resolved = resolveAmountDecimals(amount, decimals);
+    const receipt = await transfer.inner(writeContractSync, client, {
+        ...parameters,
+        throwOnReceiptRevert,
+    });
+    const { args } = transfer.extractEvent(receipt.logs);
+    return {
+        ...args,
+        ...(resolved === undefined
+            ? {}
+            : { decimals: resolved, formatted: formatUnits(args.value, resolved) }),
+        receipt,
+    };
+}
+//# sourceMappingURL=transferSync.js.map

package/_esm/actions/token/transferSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transferSync.js","sourceRoot":"","sources":["../../../actions/token/transferSync.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAKhC,MAAuE,EACvE,UAA2D;IAE3D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAAE,GAAG,UAAU,CAAA;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACpD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACxD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,EAAE;QAC9D,GAAG,UAAU;QACb,oBAAoB;KACZ,CAAC,CAAA;IACX,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,OAAO;QACL,GAAG,IAAI;QACP,GAAG,CAAC,QAAQ,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QACzE,OAAO;KACC,CAAA;AACZ,CAAC"}

package/_esm/chains/definitions/battlechain.js

@@ -0,0 +1,28 @@
+import { defineChain } from '../../utils/chain/defineChain.js';
+import { chainConfig } from '../../zksync/chainConfig.js';
+export const battlechain = /*#__PURE__*/ defineChain({
+    ...chainConfig,
+    id: 626,
+    name: 'BattleChain Mainnet',
+    network: 'battlechain',
+    nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ['https://mainnet.battlechain.com'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'BattleChain Explorer',
+            url: 'https://explorer.battlechain.com',
+            apiUrl: 'https://block-explorer-api.battlechain.com/api',
+        },
+    },
+    contracts: {
+        multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 40,
+        },
+    },
+});
+//# sourceMappingURL=battlechain.js.map

package/_esm/chains/definitions/battlechain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"battlechain.js","sourceRoot":"","sources":["../../../chains/definitions/battlechain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;IACnD,GAAG,WAAW;IACd,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,aAAa;IACtB,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9D,OAAO,EAAE;QACP,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,iCAAiC,CAAC;SAC1C;KACF;IACD,cAAc,EAAE;QACd,OAAO,EAAE;YACP,IAAI,EAAE,sBAAsB;YAC5B,GAAG,EAAE,kCAAkC;YACvC,MAAM,EAAE,gDAAgD;SACzD;KACF;IACD,SAAS,EAAE;QACT,UAAU,EAAE;YACV,OAAO,EAAE,4CAA4C;YACrD,YAAY,EAAE,EAAE;SACjB;KACF;CACF,CAAC,CAAA"}

package/_esm/chains/definitions/marooTestnet.js

@@ -0,0 +1,27 @@
+import { defineChain } from '../../utils/chain/defineChain.js';
+export const marooTestnet = /*#__PURE__*/ defineChain({
+    id: 450_815,
+    name: 'Maroo Testnet',
+    nativeCurrency: { name: 'Testnet OKRW', symbol: 'tOKRW', decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ['https://rpc-testnet.maroo.io'],
+            webSocket: ['wss://ws-testnet.maroo.io'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'Blockscout',
+            url: 'https://explorer-testnet.maroo.io',
+            apiUrl: 'https://explorer-testnet.maroo.io/blockscout/api',
+        },
+    },
+    contracts: {
+        multicall3: {
+            address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+            blockCreated: 0,
+        },
+    },
+    testnet: true,
+});
+//# sourceMappingURL=marooTestnet.js.map

package/_esm/chains/definitions/marooTestnet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marooTestnet.js","sourceRoot":"","sources":["../../../chains/definitions/marooTestnet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAE9D,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC;IACpD,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IACvE,OAAO,EAAE;QACP,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,8BAA8B,CAAC;YACtC,SAAS,EAAE,CAAC,2BAA2B,CAAC;SACzC;KACF;IACD,cAAc,EAAE;QACd,OAAO,EAAE;YACP,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE,mCAAmC;YACxC,MAAM,EAAE,kDAAkD;SAC3D;KACF;IACD,SAAS,EAAE;QACT,UAAU,EAAE;YACV,OAAO,EAAE,4CAA4C;YACrD,YAAY,EAAE,CAAC;SAChB;KACF;IACD,OAAO,EAAE,IAAI;CACd,CAAC,CAAA"}

package/_esm/chains/index.js

@@ -61,6 +61,7 @@ export { base, basePreconf } from './definitions/base.js';
 export { basecampTestnet } from './definitions/basecampTestnet.js';
 export { baseGoerli } from './definitions/baseGoerli.js';
 export { baseSepolia, baseSepoliaPreconf } from './definitions/baseSepolia.js';
+export { battlechain } from './definitions/battlechain.js';
 export { battlechainTestnet } from './definitions/battlechainTestnet.js';
 export { beam } from './definitions/beam.js';
 export { beamTestnet } from './definitions/beamTestnet.js';
@@ -388,6 +389,7 @@ export { mantleTestnet } from './definitions/mantleTestnet.js';
 export { mantraDuKongEVMTestnet } from './definitions/mantraDuKongEVMTestnet.js';
 export { mantraEVM } from './definitions/mantraEVM.js';
 export { mapProtocol } from './definitions/mapProtocol.js';
+export { marooTestnet } from './definitions/marooTestnet.js';
 export { matchain } from './definitions/matchain.js';
 export { matchainTestnet } from './definitions/matchainTestnet.js';
 export { mchVerse } from './definitions/mchVerse.js';