viem 2.53.1 → 2.54.0

package/_types/tempo/actions/token.d.ts

@@ -3,7 +3,9 @@ import * as Hex from 'ox/Hex';
 import { TokenId, TokenRole } from 'ox/tempo';
 import type { Account } from '../../accounts/types.js';
 import type { ReadContractReturnType } from '../../actions/public/readContract.js';
+import { type SimulateContractReturnType } from '../../actions/public/simulateContract.js';
 import type { WatchContractEventParameters, WatchContractEventReturnType } from '../../actions/public/watchContractEvent.js';
+import * as internal_Token from '../../actions/token/internal.js';
 import { sendTransaction } from '../../actions/wallet/sendTransaction.js';
 import { type SendTransactionSyncParameters, sendTransactionSync } from '../../actions/wallet/sendTransactionSync.js';
 import type { WriteContractReturnType } from '../../actions/wallet/writeContract.js';
@@ -17,7 +19,7 @@ import type { ExtractAbiItem, GetEventArgs } from '../../types/contract.js';
 import type { Log, Log as viem_Log } from '../../types/log.js';
 import type { Compute, OneOf, UnionOmit } from '../../types/utils.js';
 import * as Abis from '../Abis.js';
-import type { GetAccountParameter, ReadParameters, WriteParameters } from '../internal/types.js';
+import type { GetAccountParameter, ReadParameters, TokenParameter, TokenParameters, WriteParameters } from '../internal/types.js';
 import type { TransactionReceipt } from '../Transaction.js';
 /**
  * Approves a spender to transfer TIP20 tokens on behalf of the caller.
@@ -47,53 +49,31 @@ import type { TransactionReceipt } from '../Transaction.js';
  */
 export declare function approve<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: approve.Parameters<chain, account>): Promise<approve.ReturnValue>;
 export declare namespace approve {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type Args = {
-        /** Amount of tokens to approve. */
-        amount: bigint;
+        /** Amount of tokens to approve, in base units or formatted decimal form. */
+        amount: internal_Token.AmountInput;
         /** Address of the spender. */
         spender: Address;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
+    } & TokenParameter;
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type ReturnValue = WriteContractReturnType;
     type ErrorType = BaseErrorType;
     /** @internal */
-    function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: approve.Parameters<chain, account>, args: Args): Promise<ReturnType<action>>;
+    function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: approve.Parameters<chain, account>): Promise<ReturnType<action>>;
     /**
      * Defines a call to the `approve` function.
      *
-     * Can be passed as a parameter to:
-     * - [`estimateContractGas`](https://viem.sh/docs/contract/estimateContractGas): estimate the gas cost of the call
-     * - [`simulateContract`](https://viem.sh/docs/contract/simulateContract): simulate the call
-     * - [`sendCalls`](https://viem.sh/docs/actions/wallet/sendCalls): send multiple calls
-     *
-     * @example
-     * ```ts
-     * import { createClient, http, walletActions } from 'viem'
-     * import { tempo } from 'viem/chains'
-     * import { Actions } from 'viem/tempo'
-     *
-     * const client = createClient({
-     *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
-     *   transport: http(),
-     * }).extend(walletActions)
-     *
-     * const { result } = await client.sendCalls({
-     *   calls: [
-     *     actions.token.approve.call({
-     *       spender: '0x20c0...beef',
-     *       amount: 100n,
-     *       token: '0x20c0...babe',
-     *     }),
-     *   ]
-     * })
-     * ```
+     * Can be passed as a parameter to `estimateContractGas`, `simulateContract`,
+     * `sendCalls`, `sendTransaction` (`calls`), or `multicall`. The token is
+     * selected by `token`, which is either a TIP20 token id or a contract
+     * `address`; `amount.decimals` is inferred from the client's declared
+     * `tokens` when omitted.
      *
-     * @param args - Arguments.
+     * @param client - Client.
+     * @param parameters - Parameters.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: Args): {
         abi: [{
             readonly name: "approve";
             readonly type: "function";
@@ -118,6 +98,30 @@ export declare namespace approve {
         data: import("../../index.js").Hex;
         to: Address;
     };
+    /**
+     * Estimates the gas required to approve a spender. `amount.decimals` is
+     * inferred from the client's declared `tokens` when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The gas estimate.
+     */
+    function estimateGas<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: approve.Parameters<chain, account>): Promise<bigint>;
+    /**
+     * Simulates an approval of a spender. `amount.decimals` is inferred from
+     * the client's declared `tokens` when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The simulation result and write request.
+     */
+    function simulate<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: approve.Parameters<chain, account>): Promise<SimulateContractReturnType<typeof Abis.tip20, 'approve'>>;
+    /**
+     * Extracts the `Approval` event from logs.
+     *
+     * @param logs - The logs.
+     * @returns The `Approval` event.
+     */
     function extractEvent(logs: Log[]): Log<bigint, number, false, undefined, true, readonly [{
         readonly name: "name";
         readonly type: "function";
@@ -984,12 +988,16 @@ export declare namespace approve {
  */
 export declare function approveSync<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: approveSync.Parameters<chain, account>): Promise<approveSync.ReturnValue>;
 export declare namespace approveSync {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = approve.Parameters<chain, account>;
     type Args = approve.Args;
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = approve.Parameters<chain, account>;
     type ReturnValue = Compute<GetEventArgs<typeof Abis.tip20, 'Approval', {
         IndexedOnly: false;
         Required: true;
     }> & {
+        /** Token decimals used to derive `formatted`, if known. */
+        decimals?: number | undefined;
+        /** Approved amount formatted with the token's `decimals`, if known. */
+        formatted?: string | undefined;
         /** Transaction receipt. */
         receipt: TransactionReceipt;
     }>;
@@ -1024,15 +1032,13 @@ export declare namespace approveSync {
  */
 export declare function burnBlocked<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: burnBlocked.Parameters<chain, account>): Promise<burnBlocked.ReturnValue>;
 export declare namespace burnBlocked {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type Args = {
-        /** Amount of tokens to burn. */
-        amount: bigint;
+        /** Amount of tokens to burn, in base units or formatted decimal form. */
+        amount: internal_Token.AmountInput;
         /** Address to burn tokens from. */
         from: Address;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
+    } & TokenParameter;
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type ReturnValue = WriteContractReturnType;
     type ErrorType = BaseErrorType;
     /** @internal */
@@ -1058,7 +1064,7 @@ export declare namespace burnBlocked {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.burnBlocked.call({
+     *     actions.token.burnBlocked.call(client, {
      *       from: '0x20c0...beef',
      *       amount: 100n,
      *       token: '0x20c0...babe',
@@ -1067,10 +1073,12 @@ export declare namespace burnBlocked {
      * })
      * ```
      *
+     * `amount.decimals` is inferred from the client's declared `tokens` when omitted.
+     *
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "burnBlocked";
             readonly type: "function";
@@ -2005,15 +2013,13 @@ export declare namespace burnBlockedSync {
  */
 export declare function burn<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: burn.Parameters<chain, account>): Promise<burn.ReturnValue>;
 export declare namespace burn {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type Args = {
-        /** Amount of tokens to burn. */
-        amount: bigint;
+        /** Amount of tokens to burn, in base units or formatted decimal form. */
+        amount: internal_Token.AmountInput;
         /** Memo to include in the transfer. */
         memo?: Hex.Hex | undefined;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
+    } & TokenParameter;
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type ReturnValue = WriteContractReturnType;
     type ErrorType = BaseErrorType;
     /** @internal */
@@ -2039,7 +2045,7 @@ export declare namespace burn {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.burn.call({
+     *     actions.token.burn.call(client, {
      *       amount: 100n,
      *       token: '0x20c0...babe',
      *     }),
@@ -2047,10 +2053,12 @@ export declare namespace burn {
      * })
      * ```
      *
+     * `amount.decimals` is inferred from the client's declared `tokens` when omitted.
+     *
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "burn";
             readonly type: "function";
@@ -3024,7 +3032,7 @@ export declare namespace changeTransferPolicy {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.changeTransferPolicy.call({
+     *     actions.token.changeTransferPolicy.call(client, {
      *       token: '0x20c0...babe',
      *       policyId: 1n,
      *     }),
@@ -3035,7 +3043,7 @@ export declare namespace changeTransferPolicy {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "changeTransferPolicyId";
             readonly type: "function";
@@ -4013,7 +4021,7 @@ export declare namespace create {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.create.call({
+     *     actions.token.create.call(client, {
      *       name: 'My Token',
      *       symbol: 'MTK',
      *       currency: 'USD',
@@ -4027,7 +4035,7 @@ export declare namespace create {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "createToken";
             readonly type: "function";
@@ -4286,33 +4294,38 @@ export declare namespace createSync {
  * })
  *
  * const allowance = await Actions.token.getAllowance(client, {
+ *   account: '0x...',
  *   spender: '0x...',
+ *   token: '0x...',
  * })
  * ```
  *
  * @param client - Client.
  * @param parameters - Parameters.
- * @returns The token allowance.
+ * @returns The token allowance, in base units and human-readable form.
  */
-export declare function getAllowance<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: getAllowance.Parameters<account>): Promise<getAllowance.ReturnValue>;
+export declare function getAllowance<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getAllowance.Parameters): Promise<getAllowance.ReturnValue>;
 export declare namespace getAllowance {
-    type Parameters<account extends Account | undefined = Account | undefined> = ReadParameters & GetAccountParameter<account> & Omit<Args, 'account'> & {};
     type Args = {
-        /** Account address. */
+        /** Account that owns the tokens. */
         account: Address;
-        /** Address of the spender. */
+        /** Spender of the tokens. */
         spender: Address;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
-    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'allowance', never>;
+    } & TokenParameters;
+    type Parameters = ReadParameters & Args;
+    type ReturnValue = internal_Token.Amount;
     /**
      * Defines a call to the `allowance` 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`,
+     * which is either a TIP20 token id or a contract address.
+     *
+     * @param client - Client.
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "allowance";
             readonly type: "function";
@@ -4355,31 +4368,32 @@ export declare namespace getAllowance {
  * })
  *
  * const balance = await Actions.token.getBalance(client, {
+ *   account: '0x...',
  *   token: '0x...',
  * })
  * ```
  *
  * @param client - Client.
  * @param parameters - Parameters.
- * @returns The token balance.
+ * @returns The token balance, in base units and human-readable form.
  */
 export declare function getBalance<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: getBalance.Parameters<account>): Promise<getBalance.ReturnValue>;
 export declare namespace getBalance {
-    type Parameters<account extends Account | undefined = Account | undefined> = ReadParameters & GetAccountParameter<account> & Omit<Args, 'account'>;
-    type Args = {
-        /** Account address. */
-        account: Address;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
-    type ReturnValue = ReadContractReturnType<typeof Abis.tip20, 'balanceOf', never>;
+    type Args<account extends Account | undefined = Account | undefined> = GetAccountParameter<account, Account | Address> & TokenParameters;
+    type Parameters<account extends Account | undefined = Account | undefined> = Omit<ReadParameters, 'account'> & Args<account>;
+    type ReturnValue = internal_Token.Amount;
     /**
      * Defines a call to the `balanceOf` 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`,
+     * which is either a TIP20 token id or a contract address.
+     *
+     * @param client - Client.
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, args: Args<account>): {
         abi: [{
             readonly name: "balanceOf";
             readonly type: "function";
@@ -4429,10 +4443,7 @@ export declare namespace getBalance {
  */
 export declare function getMetadata<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getMetadata.Parameters): Promise<getMetadata.ReturnValue>;
 export declare namespace getMetadata {
-    type Parameters = {
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
+    type Parameters = Omit<ReadParameters, 'account'> & TokenParameter;
     type ReturnValue = Compute<{
         /**
          * Currency (e.g. "USD").
@@ -4486,6 +4497,65 @@ export declare namespace getMetadata {
         transferPolicyId?: bigint | undefined;
     }>;
 }
+/**
+ * Gets the total supply of a TIP20 token.
+ *
+ * @example
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { tempo } from 'viem/chains'
+ * import { Actions } from 'viem/tempo'
+ *
+ * const client = createClient({
+ *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
+ *   transport: http(),
+ * })
+ *
+ * const totalSupply = await Actions.token.getTotalSupply(client, {
+ *   token: '0x...',
+ * })
+ * ```
+ *
+ * @param client - Client.
+ * @param parameters - Parameters.
+ * @returns The token total supply, in base units and human-readable form.
+ */
+export declare function getTotalSupply<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: getTotalSupply.Parameters): Promise<getTotalSupply.ReturnValue>;
+export declare namespace getTotalSupply {
+    type Args = TokenParameters;
+    type Parameters = Omit<ReadParameters, 'account'> & Args;
+    type ReturnValue = internal_Token.Amount;
+    /**
+     * 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`,
+     * which is either a TIP20 token id or a contract address.
+     *
+     * @param client - Client.
+     * @param args - Arguments.
+     * @returns The call.
+     */
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
+        abi: [{
+            readonly name: "totalSupply";
+            readonly type: "function";
+            readonly stateMutability: "view";
+            readonly inputs: readonly [];
+            readonly outputs: readonly [{
+                readonly type: "uint256";
+            }];
+        }];
+        functionName: "totalSupply";
+    } & {
+        args?: readonly [] | undefined;
+    } & {
+        address: Address;
+    } & {
+        data: import("../../index.js").Hex;
+        to: Address;
+    };
+}
 /**
  * Gets the admin role for a specific role in a TIP20 token.
  *
@@ -4526,7 +4596,7 @@ export declare namespace getRoleAdmin {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "getRoleAdmin";
             readonly type: "function";
@@ -4592,7 +4662,7 @@ export declare namespace hasRole {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "hasRole";
             readonly type: "function";
@@ -4684,7 +4754,7 @@ export declare namespace grantRoles {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.grantRoles.call({
+     *     actions.token.grantRoles.call(client, {
      *       token: '0x20c0...babe',
      *       to: '0x20c0...beef',
      *       role: 'issuer',
@@ -4696,7 +4766,7 @@ export declare namespace grantRoles {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "grantRole";
             readonly type: "function";
@@ -5632,21 +5702,19 @@ export declare namespace grantRolesSync {
  */
 export declare function mint<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: mint.Parameters<chain, account>): Promise<mint.ReturnValue>;
 export declare namespace mint {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type Args = {
-        /** Amount of tokens to mint. */
-        amount: bigint;
+        /** Amount of tokens to mint, in base units or formatted decimal form. */
+        amount: internal_Token.AmountInput;
         /** Memo to include in the mint. */
         memo?: Hex.Hex | undefined;
         /** Address to mint tokens to. */
         to: Address;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
-    };
+    } & TokenParameter;
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type ReturnValue = WriteContractReturnType;
     type ErrorType = BaseErrorType;
     /** @internal */
-    function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: any): Promise<ReturnType<action>>;
+    function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: mint.Parameters<chain, account>): Promise<ReturnType<action>>;
     /**
      * Defines a call to the `mint` or `mintWithMemo` function.
      *
@@ -5668,7 +5736,7 @@ export declare namespace mint {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.mint.call({
+     *     actions.token.mint.call(client, {
      *       to: '0x20c0...beef',
      *       amount: 100n,
      *       token: '0x20c0...babe',
@@ -5677,10 +5745,12 @@ export declare namespace mint {
      * })
      * ```
      *
+     * `amount.decimals` is inferred from the client's declared `tokens` when omitted.
+     *
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "mint";
             readonly type: "function";
@@ -6658,7 +6728,7 @@ export declare namespace pause {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.pause.call({
+     *     actions.token.pause.call(client, {
      *       token: '0x20c0...babe',
      *     }),
      *   ]
@@ -6668,7 +6738,7 @@ export declare namespace pause {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "pause";
             readonly type: "function";
@@ -7629,7 +7699,7 @@ export declare namespace renounceRoles {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.renounceRoles.call({
+     *     actions.token.renounceRoles.call(client, {
      *       token: '0x20c0...babe',
      *       role: 'issuer',
      *     }),
@@ -7640,7 +7710,7 @@ export declare namespace renounceRoles {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "renounceRole";
             readonly type: "function";
@@ -8609,7 +8679,7 @@ export declare namespace revokeRoles {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.revokeRoles.call({
+     *     actions.token.revokeRoles.call(client, {
      *       token: '0x20c0...babe',
      *       from: '0x20c0...beef',
      *       role: 'issuer',
@@ -8621,7 +8691,7 @@ export declare namespace revokeRoles {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "revokeRole";
             readonly type: "function";
@@ -9588,7 +9658,7 @@ export declare namespace setSupplyCap {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.setSupplyCap.call({
+     *     actions.token.setSupplyCap.call(client, {
      *       token: '0x20c0...babe',
      *       supplyCap: 1000000n,
      *     }),
@@ -9599,7 +9669,7 @@ export declare namespace setSupplyCap {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "setSupplyCap";
             readonly type: "function";
@@ -10564,7 +10634,7 @@ export declare namespace setRoleAdmin {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.setRoleAdmin.call({
+     *     actions.token.setRoleAdmin.call(client, {
      *       token: '0x20c0...babe',
      *       role: 'issuer',
      *       adminRole: 'admin',
@@ -10576,7 +10646,7 @@ export declare namespace setRoleAdmin {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "setRoleAdmin";
             readonly type: "function";
@@ -11510,57 +11580,36 @@ export declare namespace setRoleAdminSync {
  */
 export declare function transfer<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: transfer.Parameters<chain, account>): Promise<transfer.ReturnValue>;
 export declare namespace transfer {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type Args = {
-        /** Amount of tokens to transfer. */
-        amount: bigint;
-        /** Address to transfer tokens from. */
+        /** Amount of tokens to transfer, in base units or formatted decimal form. */
+        amount: internal_Token.AmountInput;
+        /** Address to transfer tokens from (uses an allowance via `transferFrom`). */
         from?: Address | undefined;
         /** Memo to include in the transfer. */
         memo?: Hex.Hex | undefined;
-        /** Address or ID of the TIP20 token. */
-        token: TokenId.TokenIdOrAddress;
         /** Address to transfer tokens to. */
         to: Address;
-    };
+    } & TokenParameter;
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = WriteParameters<chain, account> & Args;
     type ReturnValue = WriteContractReturnType;
     type ErrorType = BaseErrorType;
     /** @internal */
     function inner<action extends typeof writeContract | typeof writeContractSync, chain extends Chain | undefined, account extends Account | undefined>(action: action, client: Client<Transport, chain, account>, parameters: transfer.Parameters<chain, account>): Promise<ReturnType<action>>;
     /**
-     * Defines a call to the `transfer`, `transferFrom`, `transferWithMemo`, or `transferFromWithMemo` function.
+     * Defines a call to the `transfer`, `transferFrom`, `transferWithMemo`, or
+     * `transferFromWithMemo` function.
      *
-     * Can be passed as a parameter to:
-     * - [`estimateContractGas`](https://viem.sh/docs/contract/estimateContractGas): estimate the gas cost of the call
-     * - [`simulateContract`](https://viem.sh/docs/contract/simulateContract): simulate the call
-     * - [`sendCalls`](https://viem.sh/docs/actions/wallet/sendCalls): send multiple calls
+     * Can be passed as a parameter to `estimateContractGas`, `simulateContract`,
+     * `sendCalls`, `sendTransaction` (`calls`), or `multicall`. The token is
+     * selected by `token`, which is either a TIP20 token id or a contract
+     * `address`; `amount.decimals` is inferred from the client's declared
+     * `tokens` when omitted.
      *
-     * @example
-     * ```ts
-     * import { createClient, http, walletActions } from 'viem'
-     * import { tempo } from 'viem/chains'
-     * import { Actions } from 'viem/tempo'
-     *
-     * const client = createClient({
-     *   chain: tempo.extend({ feeToken: '0x20c0000000000000000000000000000000000001' })
-     *   transport: http(),
-     * }).extend(walletActions)
-     *
-     * const { result } = await client.sendCalls({
-     *   calls: [
-     *     actions.token.transfer.call({
-     *       to: '0x20c0...beef',
-     *       amount: 100n,
-     *       token: '0x20c0...babe',
-     *     }),
-     *   ]
-     * })
-     * ```
-     *
-     * @param args - Arguments.
+     * @param client - Client.
+     * @param parameters - Parameters.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, parameters: Args): {
         abi: [{
             readonly name: "transfer";
             readonly type: "function";
@@ -11638,10 +11687,28 @@ export declare namespace transfer {
         to: Address;
     };
     /**
-     * Extracts the event from the logs.
+     * Estimates the gas required to transfer TIP20 tokens. `amount.decimals` is
+     * inferred from the client's declared `tokens` when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The gas estimate.
+     */
+    function estimateGas<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: transfer.Parameters<chain, account>): Promise<bigint>;
+    /**
+     * Simulates a transfer of TIP20 tokens. `amount.decimals` is inferred from
+     * the client's declared `tokens` when omitted.
+     *
+     * @param client - Client.
+     * @param parameters - Parameters.
+     * @returns The simulation result and write request.
+     */
+    function simulate<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: transfer.Parameters<chain, account>): Promise<SimulateContractReturnType<typeof Abis.tip20, 'transfer' | 'transferFrom' | 'transferWithMemo' | 'transferFromWithMemo'>>;
+    /**
+     * Extracts the `Transfer` event from logs.
      *
      * @param logs - Logs.
-     * @returns The event.
+     * @returns The `Transfer` event.
      */
     function extractEvent(logs: Log[]): Log<bigint, number, false, undefined, true, readonly [{
         readonly name: "name";
@@ -12509,14 +12576,19 @@ export declare namespace transfer {
  */
 export declare function transferSync<chain extends Chain | undefined, account extends Account | undefined>(client: Client<Transport, chain, account>, parameters: transferSync.Parameters<chain, account>): Promise<transferSync.ReturnValue>;
 export declare namespace transferSync {
-    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = transfer.Parameters<chain, account>;
     type Args = transfer.Args;
-    type ReturnValue = GetEventArgs<typeof Abis.tip20, 'Transfer', {
+    type Parameters<chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = transfer.Parameters<chain, account>;
+    type ReturnValue = Compute<GetEventArgs<typeof Abis.tip20, 'Transfer', {
         IndexedOnly: false;
         Required: true;
     }> & {
+        /** Token decimals used to derive `formatted`, if known. */
+        decimals?: number | undefined;
+        /** Transferred amount formatted with the token's `decimals`, if known. */
+        formatted?: string | undefined;
+        /** Transaction receipt. */
         receipt: TransactionReceipt;
-    };
+    }>;
     type ErrorType = BaseErrorType;
 }
 /**
@@ -12576,7 +12648,7 @@ export declare namespace unpause {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.unpause.call({
+     *     actions.token.unpause.call(client, {
      *       token: '0x20c0...babe',
      *     }),
      *   ]
@@ -12586,7 +12658,7 @@ export declare namespace unpause {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "unpause";
             readonly type: "function";
@@ -13544,7 +13616,7 @@ export declare namespace prepareUpdateQuoteToken {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.prepareUpdateQuoteToken.call({
+     *     actions.token.prepareUpdateQuoteToken.call(client, {
      *       token: '0x20c0...babe',
      *       quoteToken: '0x20c0...cafe',
      *     }),
@@ -13555,7 +13627,7 @@ export declare namespace prepareUpdateQuoteToken {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "setNextQuoteToken";
             readonly type: "function";
@@ -14514,7 +14586,7 @@ export declare namespace updateQuoteToken {
      *
      * const { result } = await client.sendCalls({
      *   calls: [
-     *     actions.token.updateQuoteToken.call({
+     *     actions.token.updateQuoteToken.call(client, {
      *       token: '0x20c0...babe',
      *     }),
      *   ]
@@ -14524,7 +14596,7 @@ export declare namespace updateQuoteToken {
      * @param args - Arguments.
      * @returns The call.
      */
-    function call(args: Args): {
+    function call<chain extends Chain | undefined>(client: Client<Transport, chain>, args: Args): {
         abi: [{
             readonly name: "completeQuoteTokenUpdate";
             readonly type: "function";