import type { Client } from '../../clients/createClient.js'; import type { Transport } from '../../clients/transports/createTransport.js'; import type { Abi } from '../../strk-types/abi.js'; import type { Account } from '../../types/account.js'; import type { Chain } from '../../types/chain.js'; import type { ContractFunctionArgs, ContractFunctionName, ContractFunctionParameters } from '../../types/contract.js'; export type WriteContractParameters = ContractFunctionName, args extends ContractFunctionArgs = ContractFunctionArgs, allFunctionNames = ContractFunctionName> = ContractFunctionParameters; export type WriteContractReturnTypes = any; export type WriteContractErrorType = any; /** * 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 client - Client to use * @param parameters - {@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' * import { writeContract } from 'viem/contract' * * const client = createWalletClient({ * chain: mainnet, * transport: custom(window.ethereum), * }) * const hash = await writeContract(client, { * address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2', * abi: parseAbi(['function mint(uint32 tokenId) nonpayable']), * functionName: 'mint', * args: [69420], * }) * * @example * // With Validation * import { createWalletClient, http, parseAbi } from 'viem' * import { mainnet } from 'viem/chains' * import { simulateContract, writeContract } from 'viem/contract' * * const client = createWalletClient({ * chain: mainnet, * transport: http(), * }) * const { request } = await simulateContract(client, { * address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2', * abi: parseAbi(['function mint(uint32 tokenId) nonpayable']), * functionName: 'mint', * args: [69420], * } * const hash = await writeContract(client, request) */ export declare function writeContract = ContractFunctionName, args extends ContractFunctionArgs = ContractFunctionArgs>(client: Client, parameters: WriteContractParameters): Promise; //# sourceMappingURL=writeContract.d.ts.map