viem 2.0.0-beta.12 → 2.0.0-beta.14

package/_esm/actions/wallet/prepareTransactionRequest.js

@@ -0,0 +1,114 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { internal_estimateFeesPerGas, } from '../../actions/public/estimateFeesPerGas.js';
+import { estimateGas, } from '../../actions/public/estimateGas.js';
+import { getBlock, } from '../../actions/public/getBlock.js';
+import { getTransactionCount, } from '../../actions/public/getTransactionCount.js';
+import {} from '../../errors/account.js';
+import { Eip1559FeesNotSupportedError, MaxFeePerGasTooLowError, } from '../../errors/fee.js';
+import { getAction } from '../../utils/getAction.js';
+import { assertRequest } from '../../utils/transaction/assertRequest.js';
+import { getTransactionType } from '../../utils/transaction/getTransactionType.js';
+/**
+ * Prepares a transaction request for signing.
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/prepareTransactionRequest.html
+ *
+ * @param args - {@link PrepareTransactionRequestParameters}
+ * @returns The transaction request. {@link PrepareTransactionRequestReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { prepareTransactionRequest } from 'viem/actions'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const request = await prepareTransactionRequest(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   to: '0x0000000000000000000000000000000000000000',
+ *   value: 1n,
+ * })
+ *
+ * @example
+ * // Account Hoisting
+ * import { createWalletClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { mainnet } from 'viem/chains'
+ * import { prepareTransactionRequest } from 'viem/actions'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const request = await prepareTransactionRequest(client, {
+ *   to: '0x0000000000000000000000000000000000000000',
+ *   value: 1n,
+ * })
+ */
+export async function prepareTransactionRequest(client, args) {
+    const { account: account_ = client.account, chain, gas, nonce, parameters = ['fees', 'gas', 'nonce', 'type'], type, } = args;
+    const account = account_ ? parseAccount(account_) : undefined;
+    const block = await getAction(client, getBlock, 'getBlock')({ blockTag: 'latest' });
+    const request = { ...args, ...(account ? { from: account?.address } : {}) };
+    if (parameters.includes('nonce') && typeof nonce === 'undefined' && account)
+        request.nonce = await getAction(client, getTransactionCount, 'getTransactionCount')({
+            address: account.address,
+            blockTag: 'pending',
+        });
+    if ((parameters.includes('fees') || parameters.includes('type')) &&
+        typeof type === 'undefined') {
+        try {
+            request.type = getTransactionType(request);
+        }
+        catch {
+            // infer type from block
+            request.type =
+                typeof block.baseFeePerGas === 'bigint' ? 'eip1559' : 'legacy';
+        }
+    }
+    if (parameters.includes('fees')) {
+        if (request.type === 'eip1559') {
+            // EIP-1559 fees
+            const { maxFeePerGas, maxPriorityFeePerGas } = await internal_estimateFeesPerGas(client, {
+                block: block,
+                chain,
+                request: request,
+            });
+            if (typeof args.maxPriorityFeePerGas === 'undefined' &&
+                args.maxFeePerGas &&
+                args.maxFeePerGas < maxPriorityFeePerGas)
+                throw new MaxFeePerGasTooLowError({
+                    maxPriorityFeePerGas,
+                });
+            request.maxPriorityFeePerGas = maxPriorityFeePerGas;
+            request.maxFeePerGas = maxFeePerGas;
+        }
+        else {
+            // Legacy fees
+            if (typeof args.maxFeePerGas !== 'undefined' ||
+                typeof args.maxPriorityFeePerGas !== 'undefined')
+                throw new Eip1559FeesNotSupportedError();
+            const { gasPrice: gasPrice_ } = await internal_estimateFeesPerGas(client, {
+                block: block,
+                chain,
+                request: request,
+                type: 'legacy',
+            });
+            request.gasPrice = gasPrice_;
+        }
+    }
+    if (parameters.includes('gas') && typeof gas === 'undefined')
+        request.gas = await getAction(client, estimateGas, 'estimateGas')({
+            ...request,
+            account: account
+                ? { address: account.address, type: 'json-rpc' }
+                : undefined,
+        });
+    assertRequest(request);
+    delete request.parameters;
+    return request;
+}
+//# sourceMappingURL=prepareTransactionRequest.js.map

package/_esm/actions/wallet/prepareTransactionRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareTransactionRequest.js","sourceRoot":"","sources":["../../../actions/wallet/prepareTransactionRequest.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAEL,2BAA2B,GAC5B,MAAM,4CAA4C,CAAA;AACnD,OAAO,EAGL,WAAW,GACZ,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAEL,QAAQ,GACT,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAEL,mBAAmB,GACpB,MAAM,6CAA6C,CAAA;AAGpD,OAAO,EAAiC,MAAM,yBAAyB,CAAA;AACvE,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAQ5B,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAKpD,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAA;AAiElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAO7C,MAA2C,EAC3C,IAMC;IAUD,MAAM,EACJ,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,OAAO,EAClC,KAAK,EACL,GAAG,EACH,KAAK,EACL,UAAU,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAC7C,IAAI,GACL,GAAG,IAAI,CAAA;IACR,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE7D,MAAM,KAAK,GAAG,MAAM,SAAS,CAC3B,MAAM,EACN,QAAQ,EACR,UAAU,CACX,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEzB,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IAE3E,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,OAAO;QACzE,OAAO,CAAC,KAAK,GAAG,MAAM,SAAS,CAC7B,MAAM,EACN,mBAAmB,EACnB,qBAAqB,CACtB,CAAC;YACA,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAA;IAEJ,IACE,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,IAAI,KAAK,WAAW,EAC3B,CAAC;QACD,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAC/B,OAAkC,CAC5B,CAAA;QACV,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;YACxB,OAAO,CAAC,IAAI;gBACV,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;QAClE,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,gBAAgB;YAChB,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAC1C,MAAM,2BAA2B,CAAC,MAAM,EAAE;gBACxC,KAAK,EAAE,KAAc;gBACrB,KAAK;gBACL,OAAO,EAAE,OAA8C;aACxD,CAAC,CAAA;YAEJ,IACE,OAAO,IAAI,CAAC,oBAAoB,KAAK,WAAW;gBAChD,IAAI,CAAC,YAAY;gBACjB,IAAI,CAAC,YAAY,GAAG,oBAAoB;gBAExC,MAAM,IAAI,uBAAuB,CAAC;oBAChC,oBAAoB;iBACrB,CAAC,CAAA;YAEJ,OAAO,CAAC,oBAAoB,GAAG,oBAAoB,CAAA;YACnD,OAAO,CAAC,YAAY,GAAG,YAAY,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,cAAc;YACd,IACE,OAAO,IAAI,CAAC,YAAY,KAAK,WAAW;gBACxC,OAAO,IAAI,CAAC,oBAAoB,KAAK,WAAW;gBAEhD,MAAM,IAAI,4BAA4B,EAAE,CAAA;YAE1C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,2BAA2B,CAC/D,MAAM,EACN;gBACE,KAAK,EAAE,KAAc;gBACrB,KAAK;gBACL,OAAO,EAAE,OAA8C;gBACvD,IAAI,EAAE,QAAQ;aACf,CACF,CAAA;YACD,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,KAAK,WAAW;QAC1D,OAAO,CAAC,GAAG,GAAG,MAAM,SAAS,CAC3B,MAAM,EACN,WAAW,EACX,aAAa,CACd,CAAC;YACA,GAAG,OAAO;YACV,OAAO,EAAE,OAAO;gBACd,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE;gBAChD,CAAC,CAAC,SAAS;SACW,CAAC,CAAA;IAE7B,aAAa,CAAC,OAAkC,CAAC,CAAA;IAEjD,OAAO,OAAO,CAAC,UAAU,CAAA;IAEzB,OAAO,OAMN,CAAA;AACH,CAAC"}

package/_esm/actions/wallet/requestAddresses.js

@@ -0,0 +1,30 @@
+import { getAddress } from '../../utils/address/getAddress.js';
+/**
+ * Requests a list of accounts managed by a wallet.
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/requestAddresses.html
+ * - 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.
+ *
+ * @param client - Client to use
+ * @returns List of accounts managed by a wallet {@link RequestAddressesReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { requestAddresses } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const accounts = await requestAddresses(client)
+ */
+export async function requestAddresses(client) {
+    const addresses = await client.request({ method: 'eth_requestAccounts' }, { retryCount: 0 });
+    return addresses.map((address) => getAddress(address));
+}
+//# sourceMappingURL=requestAddresses.js.map

package/_esm/actions/wallet/requestAddresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestAddresses.js","sourceRoot":"","sources":["../../../actions/wallet/requestAddresses.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAO9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAIpC,MAA2C;IAE3C,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CACpC,EAAE,MAAM,EAAE,qBAAqB,EAAE,EACjC,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAA;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AACxD,CAAC"}

package/_esm/actions/wallet/requestPermissions.js

@@ -0,0 +1,30 @@
+/**
+ * Requests permissions for a wallet.
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/requestPermissions.html
+ * - JSON-RPC Methods: [`wallet_requestPermissions`](https://eips.ethereum.org/EIPS/eip-2255)
+ *
+ * @param client - Client to use
+ * @param parameters - {@link RequestPermissionsParameters}
+ * @returns The wallet permissions. {@link RequestPermissionsReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { requestPermissions } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const permissions = await requestPermissions(client, {
+ *   eth_accounts: {}
+ * })
+ */
+export async function requestPermissions(client, permissions) {
+    return client.request({
+        method: 'wallet_requestPermissions',
+        params: [permissions],
+    }, { retryCount: 0 });
+}
+//# sourceMappingURL=requestPermissions.js.map

package/_esm/actions/wallet/requestPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestPermissions.js","sourceRoot":"","sources":["../../../actions/wallet/requestPermissions.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAItC,MAA2C,EAC3C,WAAyC;IAEzC,OAAO,MAAM,CAAC,OAAO,CACnB;QACE,MAAM,EAAE,2BAA2B;QACnC,MAAM,EAAE,CAAC,WAAW,CAAC;KACtB,EACD,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAA;AACH,CAAC"}

package/_esm/actions/wallet/sendRawTransaction.js

@@ -0,0 +1,31 @@
+/**
+ * Sends a **signed** transaction to the network
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/sendRawTransaction.html
+ * - 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 sendRawTransaction(client, {
+ *   serializedTransaction: '0x02f850018203118080825208808080c080a04012522854168b27e5dc3d5839bab5e6b39e1a0ffd343901ce1622e3d64b48f1a04e00902ae0502c4728cbf12156290df99c3ed7de85b1dbfe20b5c36931733a33'
+ * })
+ */
+export async function sendRawTransaction(client, { serializedTransaction }) {
+    return client.request({
+        method: 'eth_sendRawTransaction',
+        params: [serializedTransaction],
+    }, { retryCount: 0 });
+}
+//# sourceMappingURL=sendRawTransaction.js.map

package/_esm/actions/wallet/sendRawTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendRawTransaction.js","sourceRoot":"","sources":["../../../actions/wallet/sendRawTransaction.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiC,EACjC,EAAE,qBAAqB,EAAgC;IAEvD,OAAO,MAAM,CAAC,OAAO,CACnB;QACE,MAAM,EAAE,wBAAwB;QAChC,MAAM,EAAE,CAAC,qBAAqB,CAAC;KAChC,EACD,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAA;AACH,CAAC"}

package/_esm/actions/wallet/sendTransaction.js

@@ -0,0 +1,130 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { AccountNotFoundError } from '../../errors/account.js';
+import { assertCurrentChain, } from '../../utils/chain/assertCurrentChain.js';
+import { getTransactionError, } from '../../utils/errors/getTransactionError.js';
+import { extract } from '../../utils/formatters/extract.js';
+import { formatTransactionRequest, } from '../../utils/formatters/transactionRequest.js';
+import { getAction } from '../../utils/getAction.js';
+import { assertRequest, } from '../../utils/transaction/assertRequest.js';
+import { getChainId } from '../public/getChainId.js';
+import { prepareTransactionRequest, } from './prepareTransactionRequest.js';
+import { sendRawTransaction, } from './sendRawTransaction.js';
+/**
+ * Creates, signs, and sends a new transaction to the network.
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/sendTransaction.html
+ * - 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 client - Client to use
+ * @param parameters - {@link SendTransactionParameters}
+ * @returns The [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) hash. {@link SendTransactionReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { sendTransaction } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const hash = await sendTransaction(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *   value: 1000000000000000000n,
+ * })
+ *
+ * @example
+ * // Account Hoisting
+ * import { createWalletClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { mainnet } from 'viem/chains'
+ * import { sendTransaction } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const hash = await sendTransaction(client, {
+ *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *   value: 1000000000000000000n,
+ * })
+ */
+export async function sendTransaction(client, args) {
+    const { account: account_ = client.account, chain = client.chain, accessList, data, gas, gasPrice, maxFeePerGas, maxPriorityFeePerGas, nonce, to, value, ...rest } = args;
+    if (!account_)
+        throw new AccountNotFoundError({
+            docsPath: '/docs/actions/wallet/sendTransaction',
+        });
+    const account = parseAccount(account_);
+    try {
+        assertRequest(args);
+        let chainId;
+        if (chain !== null) {
+            chainId = await getAction(client, getChainId, 'getChainId')({});
+            assertCurrentChain({
+                currentChainId: chainId,
+                chain,
+            });
+        }
+        if (account.type === 'local') {
+            // Prepare the request for signing (assign appropriate fees, etc.)
+            const request = await getAction(client, prepareTransactionRequest, 'prepareTransactionRequest')({
+                account,
+                accessList,
+                chain,
+                data,
+                gas,
+                gasPrice,
+                maxFeePerGas,
+                maxPriorityFeePerGas,
+                nonce,
+                to,
+                value,
+                ...rest,
+            });
+            if (!chainId)
+                chainId = await getAction(client, getChainId, 'getChainId')({});
+            const serializer = chain?.serializers?.transaction;
+            const serializedTransaction = (await account.signTransaction({
+                ...request,
+                chainId,
+            }, { serializer }));
+            return await getAction(client, sendRawTransaction, 'sendRawTransaction')({
+                serializedTransaction,
+            });
+        }
+        const chainFormat = client.chain?.formatters?.transactionRequest?.format;
+        const format = chainFormat || formatTransactionRequest;
+        const request = format({
+            // Pick out extra data that might exist on the chain's transaction request type.
+            ...extract(rest, { format: chainFormat }),
+            accessList,
+            data,
+            from: account.address,
+            gas,
+            gasPrice,
+            maxFeePerGas,
+            maxPriorityFeePerGas,
+            nonce,
+            to,
+            value,
+        });
+        return await client.request({
+            method: 'eth_sendTransaction',
+            params: [request],
+        }, { retryCount: 0 });
+    }
+    catch (err) {
+        throw getTransactionError(err, {
+            ...args,
+            account,
+            chain: args.chain || undefined,
+        });
+    }
+}
+//# sourceMappingURL=sendTransaction.js.map

package/_esm/actions/wallet/sendTransaction.js.map

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

package/_esm/actions/wallet/signMessage.js

@@ -0,0 +1,70 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { AccountNotFoundError } from '../../errors/account.js';
+import { stringToHex, toHex, } from '../../utils/encoding/toHex.js';
+/**
+ * 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.html
+ * - JSON-RPC Methods:
+ *   - JSON-RPC Accounts: [`personal_sign`](https://docs.metamask.io/guide/signing-data.html#personal-sign)
+ *   - Local Accounts: Signs locally. No JSON-RPC request.
+ *
+ * With the calculated signature, you can:
+ * - use [`verifyMessage`](https://viem.sh/docs/utilities/verifyMessage.html) to verify the signature,
+ * - use [`recoverMessageAddress`](https://viem.sh/docs/utilities/recoverMessageAddress.html) to recover the signing address from a signature.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link SignMessageParameters}
+ * @returns The signed message. {@link SignMessageReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { signMessage } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const signature = await signMessage(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   message: 'hello world',
+ * })
+ *
+ * @example
+ * // Account Hoisting
+ * import { createWalletClient, custom } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { mainnet } from 'viem/chains'
+ * import { signMessage } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const signature = await signMessage(client, {
+ *   message: 'hello world',
+ * })
+ */
+export async function signMessage(client, { account: account_ = client.account, message, }) {
+    if (!account_)
+        throw new AccountNotFoundError({
+            docsPath: '/docs/actions/wallet/signMessage',
+        });
+    const account = parseAccount(account_);
+    if (account.type === 'local')
+        return account.signMessage({ message });
+    const message_ = (() => {
+        if (typeof message === 'string')
+            return stringToHex(message);
+        if (message.raw instanceof Uint8Array)
+            return toHex(message.raw);
+        return message.raw;
+    })();
+    return client.request({
+        method: 'personal_sign',
+        params: [message_, account.address],
+    }, { retryCount: 0 });
+}
+//# sourceMappingURL=signMessage.js.map

package/_esm/actions/wallet/signMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signMessage.js","sourceRoot":"","sources":["../../../actions/wallet/signMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAI7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAM9D,OAAO,EAEL,WAAW,EACX,KAAK,GACN,MAAM,+BAA+B,CAAA;AAiBtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAI/B,MAA2C,EAC3C,EACE,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,OAAO,EAClC,OAAO,GACyB;IAElC,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,oBAAoB,CAAC;YAC7B,QAAQ,EAAE,kCAAkC;SAC7C,CAAC,CAAA;IACJ,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAErE,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;QACrB,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAA;QAC5D,IAAI,OAAO,CAAC,GAAG,YAAY,UAAU;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,OAAO,CAAC,GAAG,CAAA;IACpB,CAAC,CAAC,EAAE,CAAA;IAEJ,OAAO,MAAM,CAAC,OAAO,CACnB;QACE,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC;KACpC,EACD,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAA;AACH,CAAC"}

package/_esm/actions/wallet/signTransaction.js

@@ -0,0 +1,88 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { AccountNotFoundError } from '../../errors/account.js';
+import {} from '../../types/rpc.js';
+import { assertCurrentChain, } from '../../utils/chain/assertCurrentChain.js';
+import { formatTransactionRequest, } from '../../utils/formatters/transactionRequest.js';
+import { getAction } from '../../utils/getAction.js';
+import { numberToHex } from '../../utils/index.js';
+import { assertRequest, } from '../../utils/transaction/assertRequest.js';
+import { getChainId } from '../public/getChainId.js';
+/**
+ * Signs a transaction.
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/signTransaction.html
+ * - 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 serialized tranasction. {@link SignTransactionReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { signTransaction } from 'viem/actions'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const signature = await signTransaction(client, {
+ *   account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ *   to: '0x0000000000000000000000000000000000000000',
+ *   value: 1n,
+ * })
+ *
+ * @example
+ * // Account Hoisting
+ * import { createWalletClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { mainnet } from 'viem/chains'
+ * import { signTransaction } from 'viem/actions'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const signature = await signTransaction(client, {
+ *   to: '0x0000000000000000000000000000000000000000',
+ *   value: 1n,
+ * })
+ */
+export async function signTransaction(client, args) {
+    const { account: account_ = client.account, chain = client.chain, ...transaction } = args;
+    if (!account_)
+        throw new AccountNotFoundError({
+            docsPath: '/docs/actions/wallet/signTransaction',
+        });
+    const account = parseAccount(account_);
+    assertRequest({
+        account,
+        ...args,
+    });
+    const chainId = await getAction(client, getChainId, 'getChainId')({});
+    if (chain !== null)
+        assertCurrentChain({
+            currentChainId: chainId,
+            chain,
+        });
+    const formatters = chain?.formatters || client.chain?.formatters;
+    const format = formatters?.transactionRequest?.format || formatTransactionRequest;
+    if (account.type === 'local')
+        return account.signTransaction({
+            ...transaction,
+            chainId,
+        }, { serializer: client.chain?.serializers?.transaction });
+    return await client.request({
+        method: 'eth_signTransaction',
+        params: [
+            {
+                ...format(transaction),
+                chainId: numberToHex(chainId),
+                from: account.address,
+            },
+        ],
+    }, { retryCount: 0 });
+}
+//# sourceMappingURL=signTransaction.js.map

package/_esm/actions/wallet/signTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signTransaction.js","sourceRoot":"","sources":["../../../actions/wallet/signTransaction.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,GACb,MAAM,sCAAsC,CAAA;AAI7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAQ9D,OAAO,EAA8B,MAAM,oBAAoB,CAAA;AAQ/D,OAAO,EAEL,kBAAkB,GACnB,MAAM,yCAAyC,CAAA;AAEhD,OAAO,EAEL,wBAAwB,GACzB,MAAM,8CAA8C,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAEL,aAAa,GACd,MAAM,0CAA0C,CAAA;AACjD,OAAO,EAA4B,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAwB9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAKnC,MAA2C,EAC3C,IAAiE;IAEjE,MAAM,EACJ,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,OAAO,EAClC,KAAK,GAAG,MAAM,CAAC,KAAK,EACpB,GAAG,WAAW,EACf,GAAG,IAAI,CAAA;IAER,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,oBAAoB,CAAC;YAC7B,QAAQ,EAAE,sCAAsC;SACjD,CAAC,CAAA;IACJ,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IAEtC,aAAa,CAAC;QACZ,OAAO;QACP,GAAG,IAAI;KACR,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAA;IACrE,IAAI,KAAK,KAAK,IAAI;QAChB,kBAAkB,CAAC;YACjB,cAAc,EAAE,OAAO;YACvB,KAAK;SACN,CAAC,CAAA;IAEJ,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,MAAM,CAAC,KAAK,EAAE,UAAU,CAAA;IAChE,MAAM,MAAM,GACV,UAAU,EAAE,kBAAkB,EAAE,MAAM,IAAI,wBAAwB,CAAA;IAEpE,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;QAC1B,OAAO,OAAO,CAAC,eAAe,CAC5B;YACE,GAAG,WAAW;YACd,OAAO;SAC8B,EACvC,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CACjB,CAAA;IAEzC,OAAO,MAAM,MAAM,CAAC,OAAO,CACzB;QACE,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE;YACN;gBACE,GAAG,MAAM,CAAC,WAA4C,CAAC;gBACvD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;gBAC7B,IAAI,EAAE,OAAO,CAAC,OAAO;aACc;SACtC;KACF,EACD,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAA;AACH,CAAC"}

package/_esm/actions/wallet/signTypedData.js

@@ -0,0 +1,126 @@
+import { parseAccount, } from '../../accounts/utils/parseAccount.js';
+import { AccountNotFoundError, } from '../../errors/account.js';
+import { isHex } from '../../utils/data/isHex.js';
+import { stringify } from '../../utils/stringify.js';
+import { getTypesForEIP712Domain, validateTypedData, } from '../../utils/typedData.js';
+/**
+ * Signs typed data and calculates an Ethereum-specific signature in [https://eips.ethereum.org/EIPS/eip-712](https://eips.ethereum.org/EIPS/eip-712): `sign(keccak256("\x19\x01" ‖ domainSeparator ‖ hashStruct(message)))`
+ *
+ * - Docs: https://viem.sh/docs/actions/wallet/signTypedData.html
+ * - JSON-RPC Methods:
+ *   - JSON-RPC Accounts: [`eth_signTypedData_v4`](https://docs.metamask.io/guide/signing-data.html#signtypeddata-v4)
+ *   - Local Accounts: Signs locally. No JSON-RPC request.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link SignTypedDataParameters}
+ * @returns The signed data. {@link SignTypedDataReturnType}
+ *
+ * @example
+ * import { createWalletClient, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { signTypedData } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   chain: mainnet,
+ *   transport: custom(window.ethereum),
+ * })
+ * const signature = await signTypedData(client, {
+ *   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'
+ * import { signTypedData } from 'viem/wallet'
+ *
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x…'),
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const signature = await signTypedData(client, {
+ *   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!',
+ *   },
+ * })
+ */
+export async function signTypedData(client, parameters) {
+    const { account: account_ = client.account, domain, message, primaryType, } = parameters;
+    if (!account_)
+        throw new AccountNotFoundError({
+            docsPath: '/docs/actions/wallet/signTypedData',
+        });
+    const account = parseAccount(account_);
+    const types = {
+        EIP712Domain: getTypesForEIP712Domain({ domain }),
+        ...parameters.types,
+    };
+    // Need to do a runtime validation check on addresses, byte ranges, integer ranges, etc
+    // as we can't statically check this with TypeScript.
+    validateTypedData({ domain, message, primaryType, types });
+    if (account.type === 'local')
+        return account.signTypedData({ domain, message, primaryType, types });
+    const typedData = stringify({ domain: domain ?? {}, message, primaryType, types }, (_, value) => (isHex(value) ? value.toLowerCase() : value));
+    return client.request({
+        method: 'eth_signTypedData_v4',
+        params: [account.address, typedData],
+    }, { retryCount: 0 });
+}
+//# sourceMappingURL=signTypedData.js.map