viem 2.7.5 → 2.7.8

package/_types/clients/decorators/wallet.d.ts

@@ -0,0 +1,561 @@
+import type { Abi, Address, TypedData } from 'abitype';
+import type { Account } from '../../accounts/types.js';
+import { type GetChainIdReturnType } from '../../actions/public/getChainId.js';
+import { type AddChainParameters } from '../../actions/wallet/addChain.js';
+import { type DeployContractParameters, type DeployContractReturnType } from '../../actions/wallet/deployContract.js';
+import { type GetAddressesReturnType } from '../../actions/wallet/getAddresses.js';
+import { type GetPermissionsReturnType } from '../../actions/wallet/getPermissions.js';
+import { type PrepareTransactionRequestParameterType, type PrepareTransactionRequestParameters, type PrepareTransactionRequestReturnType } from '../../actions/wallet/prepareTransactionRequest.js';
+import { type RequestAddressesReturnType } from '../../actions/wallet/requestAddresses.js';
+import { type RequestPermissionsParameters, type RequestPermissionsReturnType } from '../../actions/wallet/requestPermissions.js';
+import { type SendRawTransactionParameters, type SendRawTransactionReturnType } from '../../actions/wallet/sendRawTransaction.js';
+import { type SendTransactionParameters, type SendTransactionReturnType } from '../../actions/wallet/sendTransaction.js';
+import { type SignMessageParameters, type SignMessageReturnType } from '../../actions/wallet/signMessage.js';
+import { type SignTransactionParameters, type SignTransactionReturnType } from '../../actions/wallet/signTransaction.js';
+import { type SignTypedDataParameters, type SignTypedDataReturnType } from '../../actions/wallet/signTypedData.js';
+import { type SwitchChainParameters } from '../../actions/wallet/switchChain.js';
+import { type WatchAssetParameters, type WatchAssetReturnType } from '../../actions/wallet/watchAsset.js';
+import { type WriteContractParameters, type WriteContractReturnType } from '../../actions/wallet/writeContract.js';
+import type { Chain } from '../../types/chain.js';
+import { type ContractFunctionArgs, type ContractFunctionName } from '../../types/contract.js';
+import type { Client } from '../createClient.js';
+import type { Transport } from '../transports/createTransport.js';
+export type WalletActions<TChain extends Chain | undefined = Chain | undefined, TAccount extends Account | undefined = Account | undefined> = {
+    /**
+     * Adds an EVM chain to the wallet.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/addChain
+     * - JSON-RPC Methods: [`eth_addEthereumChain`](https://eips.ethereum.org/EIPS/eip-3085)
+     *
+     * @param args - {@link AddChainParameters}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { optimism } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   transport: custom(window.ethereum),
+     * })
+     * await client.addChain({ chain: optimism })
+     */
+    addChain: (args: AddChainParameters) => Promise<void>;
+    /**
+     * Deploys a contract to the network, given bytecode and constructor arguments.
+     *
+     * - Docs: https://viem.sh/docs/contract/deployContract
+     * - Examples: https://stackblitz.com/github/wevm/viem/tree/main/examples/contracts/deploying-contracts
+     *
+     * @param args - {@link DeployContractParameters}
+     * @returns The [Transaction](https://viem.sh/docs/glossary/terms#transaction) hash. {@link DeployContractReturnType}
+     *
+     * @example
+     * import { createWalletClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   account: privateKeyToAccount('0x…'),
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     * const hash = await client.deployContract({
+     *   abi: [],
+     *   account: '0x…,
+     *   bytecode: '0x608060405260405161083e38038061083e833981016040819052610...',
+     * })
+     */
+    deployContract: <const abi extends Abi | readonly unknown[], chainOverride extends Chain | undefined>(args: DeployContractParameters<abi, TChain, TAccount, chainOverride>) => Promise<DeployContractReturnType>;
+    /**
+     * Returns a list of account addresses owned by the wallet or client.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/getAddresses
+     * - JSON-RPC Methods: [`eth_accounts`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_accounts)
+     *
+     * @returns List of account addresses owned by the wallet or client. {@link GetAddressesReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const accounts = await client.getAddresses()
+     */
+    getAddresses: () => Promise<GetAddressesReturnType>;
+    /**
+     * Returns the chain ID associated with the current network.
+     *
+     * - Docs: https://viem.sh/docs/actions/public/getChainId
+     * - JSON-RPC Methods: [`eth_chainId`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_chainid)
+     *
+     * @returns The current chain ID. {@link GetChainIdReturnType}
+     *
+     * @example
+     * import { createWalletClient, http } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const chainId = await client.getChainId()
+     * // 1
+     */
+    getChainId: () => Promise<GetChainIdReturnType>;
+    /**
+     * Gets the wallets current permissions.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/getPermissions
+     * - JSON-RPC Methods: [`wallet_getPermissions`](https://eips.ethereum.org/EIPS/eip-2255)
+     *
+     * @returns The wallet permissions. {@link GetPermissionsReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const permissions = await client.getPermissions()
+     */
+    getPermissions: () => Promise<GetPermissionsReturnType>;
+    /**
+     * Prepares a transaction request for signing.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/prepareTransactionRequest
+     *
+     * @param args - {@link PrepareTransactionRequestParameters}
+     * @returns The transaction request. {@link PrepareTransactionRequestReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const request = await client.prepareTransactionRequest({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   to: '0x0000000000000000000000000000000000000000',
+     *   value: 1n,
+     * })
+     *
+     * @example
+     * // Account Hoisting
+     * import { createWalletClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   account: privateKeyToAccount('0x…'),
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const request = await client.prepareTransactionRequest({
+     *   to: '0x0000000000000000000000000000000000000000',
+     *   value: 1n,
+     * })
+     */
+    prepareTransactionRequest: <TParameterType extends PrepareTransactionRequestParameterType, TChainOverride extends Chain | undefined = undefined, TAccountOverride extends Account | Address | undefined = undefined>(args: PrepareTransactionRequestParameters<TChain, TAccount, TChainOverride, TAccountOverride, TParameterType>) => Promise<PrepareTransactionRequestReturnType<Chain, TAccount, TChainOverride, TAccountOverride, TParameterType>>;
+    /**
+     * Requests a list of accounts managed by a wallet.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/requestAddresses
+     * - JSON-RPC Methods: [`eth_requestAccounts`](https://eips.ethereum.org/EIPS/eip-1102)
+     *
+     * Sends a request to the wallet, asking for permission to access the user's accounts. After the user accepts the request, it will return a list of accounts (addresses).
+     *
+     * This API can be useful for dapps that need to access the user's accounts in order to execute transactions or interact with smart contracts.
+     *
+     * @returns List of accounts managed by a wallet {@link RequestAddressesReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const accounts = await client.requestAddresses()
+     */
+    requestAddresses: () => Promise<RequestAddressesReturnType>;
+    /**
+     * Requests permissions for a wallet.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/requestPermissions
+     * - JSON-RPC Methods: [`wallet_requestPermissions`](https://eips.ethereum.org/EIPS/eip-2255)
+     *
+     * @param args - {@link RequestPermissionsParameters}
+     * @returns The wallet permissions. {@link RequestPermissionsReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const permissions = await client.requestPermissions({
+     *   eth_accounts: {}
+     * })
+     */
+    requestPermissions: (args: RequestPermissionsParameters) => Promise<RequestPermissionsReturnType>;
+    /**
+     * Sends a **signed** transaction to the network
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/sendRawTransaction
+     * - JSON-RPC Method: [`eth_sendRawTransaction`](https://ethereum.github.io/execution-apis/api-documentation/)
+     *
+     * @param client - Client to use
+     * @param parameters - {@link SendRawTransactionParameters}
+     * @returns The transaction hash. {@link SendRawTransactionReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     * import { sendRawTransaction } from 'viem/wallet'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     *
+     * const hash = await client.sendRawTransaction({
+     *   serializedTransaction: '0x02f850018203118080825208808080c080a04012522854168b27e5dc3d5839bab5e6b39e1a0ffd343901ce1622e3d64b48f1a04e00902ae0502c4728cbf12156290df99c3ed7de85b1dbfe20b5c36931733a33'
+     * })
+     */
+    sendRawTransaction: (args: SendRawTransactionParameters) => Promise<SendRawTransactionReturnType>;
+    /**
+     * Creates, signs, and sends a new transaction to the network.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/sendTransaction
+     * - Examples: https://stackblitz.com/github/wevm/viem/tree/main/examples/transactions/sending-transactions
+     * - JSON-RPC Methods:
+     *   - JSON-RPC Accounts: [`eth_sendTransaction`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_sendtransaction)
+     *   - Local Accounts: [`eth_sendRawTransaction`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_sendrawtransaction)
+     *
+     * @param args - {@link SendTransactionParameters}
+     * @returns The [Transaction](https://viem.sh/docs/glossary/terms#transaction) hash. {@link SendTransactionReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const hash = await client.sendTransaction({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+     *   value: 1000000000000000000n,
+     * })
+     *
+     * @example
+     * // Account Hoisting
+     * import { createWalletClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   account: privateKeyToAccount('0x…'),
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     * const hash = await client.sendTransaction({
+     *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+     *   value: 1000000000000000000n,
+     * })
+     */
+    sendTransaction: <TChainOverride extends Chain | undefined = undefined>(args: SendTransactionParameters<TChain, TAccount, TChainOverride>) => Promise<SendTransactionReturnType>;
+    /**
+     * Calculates an Ethereum-specific signature in [EIP-191 format](https://eips.ethereum.org/EIPS/eip-191): `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/signMessage
+     * - JSON-RPC Methods:
+     *   - JSON-RPC Accounts: [`personal_sign`](https://docs.metamask.io/guide/signing-data#personal-sign)
+     *   - Local Accounts: Signs locally. No JSON-RPC request.
+     *
+     * With the calculated signature, you can:
+     * - use [`verifyMessage`](https://viem.sh/docs/utilities/verifyMessage) to verify the signature,
+     * - use [`recoverMessageAddress`](https://viem.sh/docs/utilities/recoverMessageAddress) to recover the signing address from a signature.
+     *
+     * @param args - {@link SignMessageParameters}
+     * @returns The signed message. {@link SignMessageReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const signature = await client.signMessage({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   message: 'hello world',
+     * })
+     *
+     * @example
+     * // Account Hoisting
+     * import { createWalletClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   account: privateKeyToAccount('0x…'),
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     * const signature = await client.signMessage({
+     *   message: 'hello world',
+     * })
+     */
+    signMessage: (args: SignMessageParameters<TAccount>) => Promise<SignMessageReturnType>;
+    /**
+     * Signs a transaction.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/signTransaction
+     * - JSON-RPC Methods:
+     *   - JSON-RPC Accounts: [`eth_signTransaction`](https://ethereum.github.io/execution-apis/api-documentation/)
+     *   - Local Accounts: Signs locally. No JSON-RPC request.
+     *
+     * @param args - {@link SignTransactionParameters}
+     * @returns The signed message. {@link SignTransactionReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const request = await client.prepareTransactionRequest({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   to: '0x0000000000000000000000000000000000000000',
+     *   value: 1n,
+     * })
+     * const signature = await client.signTransaction(request)
+     *
+     * @example
+     * // Account Hoisting
+     * import { createWalletClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   account: privateKeyToAccount('0x…'),
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const request = await client.prepareTransactionRequest({
+     *   to: '0x0000000000000000000000000000000000000000',
+     *   value: 1n,
+     * })
+     * const signature = await client.signTransaction(request)
+     */
+    signTransaction: <TChainOverride extends Chain | undefined>(args: SignTransactionParameters<TChain, TAccount, TChainOverride>) => Promise<SignTransactionReturnType>;
+    /**
+     * Signs typed data and calculates an Ethereum-specific signature in [EIP-191 format](https://eips.ethereum.org/EIPS/eip-191): `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/signTypedData
+     * - JSON-RPC Methods:
+     *   - JSON-RPC Accounts: [`eth_signTypedData_v4`](https://docs.metamask.io/guide/signing-data#signtypeddata-v4)
+     *   - Local Accounts: Signs locally. No JSON-RPC request.
+     *
+     * @param client - Client to use
+     * @param args - {@link SignTypedDataParameters}
+     * @returns The signed data. {@link SignTypedDataReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const signature = await client.signTypedData({
+     *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+     *   domain: {
+     *     name: 'Ether Mail',
+     *     version: '1',
+     *     chainId: 1,
+     *     verifyingContract: '0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC',
+     *   },
+     *   types: {
+     *     Person: [
+     *       { name: 'name', type: 'string' },
+     *       { name: 'wallet', type: 'address' },
+     *     ],
+     *     Mail: [
+     *       { name: 'from', type: 'Person' },
+     *       { name: 'to', type: 'Person' },
+     *       { name: 'contents', type: 'string' },
+     *     ],
+     *   },
+     *   primaryType: 'Mail',
+     *   message: {
+     *     from: {
+     *       name: 'Cow',
+     *       wallet: '0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826',
+     *     },
+     *     to: {
+     *       name: 'Bob',
+     *       wallet: '0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB',
+     *     },
+     *     contents: 'Hello, Bob!',
+     *   },
+     * })
+     *
+     * @example
+     * // Account Hoisting
+     * import { createWalletClient, http } from 'viem'
+     * import { privateKeyToAccount } from 'viem/accounts'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   account: privateKeyToAccount('0x…'),
+     *   chain: mainnet,
+     *   transport: http(),
+     * })
+     * const signature = await client.signTypedData({
+     *   domain: {
+     *     name: 'Ether Mail',
+     *     version: '1',
+     *     chainId: 1,
+     *     verifyingContract: '0xCcCCccccCCCCcCCCCCCcCcCccCcCCCcCcccccccC',
+     *   },
+     *   types: {
+     *     Person: [
+     *       { name: 'name', type: 'string' },
+     *       { name: 'wallet', type: 'address' },
+     *     ],
+     *     Mail: [
+     *       { name: 'from', type: 'Person' },
+     *       { name: 'to', type: 'Person' },
+     *       { name: 'contents', type: 'string' },
+     *     ],
+     *   },
+     *   primaryType: 'Mail',
+     *   message: {
+     *     from: {
+     *       name: 'Cow',
+     *       wallet: '0xCD2a3d9F938E13CD947Ec05AbC7FE734Df8DD826',
+     *     },
+     *     to: {
+     *       name: 'Bob',
+     *       wallet: '0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB',
+     *     },
+     *     contents: 'Hello, Bob!',
+     *   },
+     * })
+     */
+    signTypedData: <const TTypedData extends TypedData | {
+        [key: string]: unknown;
+    }, TPrimaryType extends string>(args: SignTypedDataParameters<TTypedData, TPrimaryType, TAccount>) => Promise<SignTypedDataReturnType>;
+    /**
+     * Switch the target chain in a wallet.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/switchChain
+     * - JSON-RPC Methods: [`eth_switchEthereumChain`](https://eips.ethereum.org/EIPS/eip-3326)
+     *
+     * @param args - {@link SwitchChainParameters}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet, optimism } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * await client.switchChain({ id: optimism.id })
+     */
+    switchChain: (args: SwitchChainParameters) => Promise<void>;
+    /**
+     * Adds an EVM chain to the wallet.
+     *
+     * - Docs: https://viem.sh/docs/actions/wallet/watchAsset
+     * - JSON-RPC Methods: [`eth_switchEthereumChain`](https://eips.ethereum.org/EIPS/eip-747)
+     *
+     * @param args - {@link WatchAssetParameters}
+     * @returns Boolean indicating if the token was successfully added. {@link WatchAssetReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const success = await client.watchAsset({
+     *   type: 'ERC20',
+     *   options: {
+     *     address: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
+     *     decimals: 18,
+     *     symbol: 'WETH',
+     *   },
+     * })
+     */
+    watchAsset: (args: WatchAssetParameters) => Promise<WatchAssetReturnType>;
+    /**
+     * Executes a write function on a contract.
+     *
+     * - Docs: https://viem.sh/docs/contract/writeContract
+     * - Examples: https://stackblitz.com/github/wevm/viem/tree/main/examples/contracts/writing-to-contracts
+     *
+     * A "write" function on a Solidity contract modifies the state of the blockchain. These types of functions require gas to be executed, and hence a [Transaction](https://viem.sh/docs/glossary/terms) is needed to be broadcast in order to change the state.
+     *
+     * Internally, uses a [Wallet Client](https://viem.sh/docs/clients/wallet) to call the [`sendTransaction` action](https://viem.sh/docs/actions/wallet/sendTransaction) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData).
+     *
+     * __Warning: The `write` internally sends a transaction – it does not validate if the contract write will succeed (the contract may throw an error). It is highly recommended to [simulate the contract write with `contract.simulate`](https://viem.sh/docs/contract/writeContract#usage) before you execute it.__
+     *
+     * @param args - {@link WriteContractParameters}
+     * @returns A [Transaction Hash](https://viem.sh/docs/glossary/terms#hash). {@link WriteContractReturnType}
+     *
+     * @example
+     * import { createWalletClient, custom, parseAbi } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const hash = await client.writeContract({
+     *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+     *   abi: parseAbi(['function mint(uint32 tokenId) nonpayable']),
+     *   functionName: 'mint',
+     *   args: [69420],
+     * })
+     *
+     * @example
+     * // With Validation
+     * import { createWalletClient, custom, parseAbi } from 'viem'
+     * import { mainnet } from 'viem/chains'
+     *
+     * const client = createWalletClient({
+     *   chain: mainnet,
+     *   transport: custom(window.ethereum),
+     * })
+     * const { request } = await client.simulateContract({
+     *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
+     *   abi: parseAbi(['function mint(uint32 tokenId) nonpayable']),
+     *   functionName: 'mint',
+     *   args: [69420],
+     * }
+     * const hash = await client.writeContract(request)
+     */
+    writeContract: <const abi extends Abi | readonly unknown[], functionName extends ContractFunctionName<abi, 'payable' | 'nonpayable'>, args extends ContractFunctionArgs<abi, 'pure' | 'view', functionName>, TChainOverride extends Chain | undefined = undefined>(args: WriteContractParameters<abi, functionName, args, TChain, TAccount, TChainOverride>) => Promise<WriteContractReturnType>;
+};
+export declare function walletActions<TTransport extends Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends Account | undefined = Account | undefined>(client: Client<TTransport, TChain, TAccount>): WalletActions<TChain, TAccount>;
+//# sourceMappingURL=wallet.d.ts.map

package/_types/clients/decorators/wallet.d.ts.map

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

package/_types/clients/transports/createTransport.d.ts

@@ -0,0 +1,36 @@
+import type { ErrorType } from '../../errors/utils.js';
+import type { Chain } from '../../types/chain.js';
+import type { EIP1193RequestFn } from '../../types/eip1193.js';
+import type { ClientConfig } from '../createClient.js';
+export type TransportConfig<TType extends string = string, TEIP1193RequestFn extends EIP1193RequestFn = EIP1193RequestFn> = {
+    /** The name of the transport. */
+    name: string;
+    /** The key of the transport. */
+    key: string;
+    /** The JSON-RPC request function that matches the EIP-1193 request spec. */
+    request: TEIP1193RequestFn;
+    /** The base delay (in ms) between retries. */
+    retryDelay?: number;
+    /** The max number of times to retry. */
+    retryCount?: number;
+    /** The timeout (in ms) for requests. */
+    timeout?: number;
+    /** The type of the transport. */
+    type: TType;
+};
+export type Transport<TType extends string = string, TRpcAttributes = Record<string, any>, TEIP1193RequestFn extends EIP1193RequestFn = EIP1193RequestFn> = <TChain extends Chain | undefined = Chain>({ chain, }: {
+    chain?: TChain;
+    pollingInterval?: ClientConfig['pollingInterval'];
+    retryCount?: TransportConfig['retryCount'];
+    timeout?: TransportConfig['timeout'];
+}) => {
+    config: TransportConfig<TType>;
+    request: TEIP1193RequestFn;
+    value?: TRpcAttributes;
+};
+export type CreateTransportErrorType = ErrorType;
+/**
+ * @description Creates an transport intended to be used with a client.
+ */
+export declare function createTransport<TType extends string, TRpcAttributes extends Record<string, any>>({ key, name, request, retryCount, retryDelay, timeout, type, }: TransportConfig<TType>, value?: TRpcAttributes): ReturnType<Transport<TType, TRpcAttributes>>;
+//# sourceMappingURL=createTransport.d.ts.map

package/_types/clients/transports/createTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTransport.d.ts","sourceRoot":"","sources":["../../../clients/transports/createTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,MAAM,eAAe,CACzB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,iBAAiB,SAAS,gBAAgB,GAAG,gBAAgB,IAC3D;IACF,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,4EAA4E;IAC5E,OAAO,EAAE,iBAAiB,CAAA;IAC1B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,IAAI,EAAE,KAAK,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,SAAS,CACnB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,iBAAiB,SAAS,gBAAgB,GAAG,gBAAgB,IAC3D,CAAC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,EAAE,EAC7C,KAAK,GACN,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAA;IACjD,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IAC1C,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;CACrC,KAAK;IACJ,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAC9B,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAAA;AAEhD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,SAAS,MAAM,EACpB,cAAc,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAE1C,EACE,GAAG,EACH,IAAI,EACJ,OAAO,EACP,UAAc,EACd,UAAgB,EAChB,OAAO,EACP,IAAI,GACL,EAAE,eAAe,CAAC,KAAK,CAAC,EACzB,KAAK,CAAC,EAAE,cAAc,GACrB,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAM9C"}

package/_types/clients/transports/custom.d.ts

@@ -0,0 +1,23 @@
+import type { ErrorType } from '../../errors/utils.js';
+import { type CreateTransportErrorType, type Transport, type TransportConfig } from './createTransport.js';
+type EthereumProvider = {
+    request(...args: any): Promise<any>;
+};
+export type CustomTransportConfig = {
+    /** The key of the transport. */
+    key?: TransportConfig['key'];
+    /** The name of the transport. */
+    name?: TransportConfig['name'];
+    /** The max number of times to retry. */
+    retryCount?: TransportConfig['retryCount'];
+    /** The base delay (in ms) between retries. */
+    retryDelay?: TransportConfig['retryDelay'];
+};
+export type CustomTransport = Transport<'custom', {}, EthereumProvider['request']>;
+export type CustomTransportErrorType = CreateTransportErrorType | ErrorType;
+/**
+ * @description Creates a custom transport given an EIP-1193 compliant `request` attribute.
+ */
+export declare function custom<TProvider extends EthereumProvider>(provider: TProvider, config?: CustomTransportConfig): CustomTransport;
+export {};
+//# sourceMappingURL=custom.d.ts.map

package/_types/clients/transports/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../clients/transports/custom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACd,KAAK,eAAe,EAErB,MAAM,sBAAsB,CAAA;AAE7B,KAAK,gBAAgB,GAAG;IAAE,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,CAAA;AAE/D,MAAM,MAAM,qBAAqB,GAAG;IAClC,gCAAgC;IAChC,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAC5B,iCAAiC;IACjC,IAAI,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAA;IAC9B,wCAAwC;IACxC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IAC1C,8CAA8C;IAC9C,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,CACrC,QAAQ,EACR,EAAE,EACF,gBAAgB,CAAC,SAAS,CAAC,CAC5B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,GAAG,SAAS,CAAA;AAE3E;;GAEG;AACH,wBAAgB,MAAM,CAAC,SAAS,SAAS,gBAAgB,EACvD,QAAQ,EAAE,SAAS,EACnB,MAAM,GAAE,qBAA0B,GACjC,eAAe,CAWjB"}