EVM Wallets

import { EVMWallet } from "@crossmint/wallets-sdk";

// Assuming you have a wallet instance
const evmWallet = EVMWallet.from(wallet);

evmWallet.sendTransaction(params: EVMTransactionInput): Promise<Transaction>

const tx = await evmWallet.sendTransaction({
    transaction: "0x...", // Serialized transaction hex
});

console.log(tx.hash);
console.log(tx.explorerLink);

const tx = await evmWallet.sendTransaction({
    to: "0xContractAddress...",
    value: 0n, // Value in wei (bigint)
    data: "0x...", // Encoded function call
});

const ERC20_ABI = [
    {
        name: "transfer",
        type: "function",
        inputs: [
            { name: "to", type: "address" },
            { name: "amount", type: "uint256" },
        ],
        outputs: [{ name: "", type: "bool" }],
        stateMutability: "nonpayable",
    },
];

const tx = await evmWallet.sendTransaction({
    to: "0xTokenContractAddress...",
    abi: ERC20_ABI,
    functionName: "transfer",
    args: ["0xRecipient...", 1000000n], // 1 USDC (6 decimals)
    value: 0n,
});

const preparedTx = await evmWallet.sendTransaction({
    to: "0xContractAddress...",
    data: "0x...",
    options: {
        experimental_prepareOnly: true,
    },
});

console.log(preparedTx.transactionId);

// Approve later
const completedTx = await wallet.approve({
    transactionId: preparedTx.transactionId,
});

const tx = await evmWallet.sendTransaction({
    to: "0xContractAddress...",
    data: "0x...",
    options: {
        experimental_signer: "external-wallet:0x...",
    },
});

evmWallet.signMessage(params: SignMessageInput): Promise<Signature>

const signResult = await evmWallet.signMessage({
    message: "Hello, blockchain!",
});

console.log(signResult.signature);   // "0x..."
console.log(signResult.signatureId); // Signature ID for tracking

const preparedSig = await evmWallet.signMessage({
    message: "Hello, blockchain!",
    options: {
        experimental_prepareOnly: true,
    },
});

console.log(preparedSig.signatureId);

// Approve later
const completedSig = await wallet.approve({
    signatureId: preparedSig.signatureId,
});

console.log(completedSig.signature);

evmWallet.signTypedData(params: SignTypedDataInput): Promise<Signature>

const signResult = await evmWallet.signTypedData({
    domain: {
        name: "My DApp",
        version: "1",
        chainId: 137n, // Polygon
        verifyingContract: "0xContractAddress...",
    },
    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: "Alice",
            wallet: "0xAlice...",
        },
        to: {
            name: "Bob",
            wallet: "0xBob...",
        },
        contents: "Hello, Bob!",
    },
    chain: "polygon",
});

console.log(signResult.signature);

const permitSignature = await evmWallet.signTypedData({
    domain: {
        name: "USD Coin",
        version: "2",
        chainId: 137n,
        verifyingContract: "0xUSDCContractAddress...",
    },
    types: {
        Permit: [
            { name: "owner", type: "address" },
            { name: "spender", type: "address" },
            { name: "value", type: "uint256" },
            { name: "nonce", type: "uint256" },
            { name: "deadline", type: "uint256" },
        ],
    },
    primaryType: "Permit",
    message: {
        owner: wallet.address,
        spender: "0xSpenderAddress...",
        value: 1000000n,
        nonce: 0n,
        deadline: BigInt(Math.floor(Date.now() / 1000) + 3600),
    },
    chain: "polygon",
});

evmWallet.getViemClient(params?: { transport?: HttpTransport }): PublicClient

import { http } from "viem";

// Get client with default transport
const viemClient = evmWallet.getViemClient();

// Or provide custom transport
const customClient = evmWallet.getViemClient({
    transport: http("https://polygon-rpc.com"),
});

// Use Viem client for read operations
const blockNumber = await viemClient.getBlockNumber();
const balance = await viemClient.getBalance({ address: wallet.address });

import { CrossmintWallets, createCrossmint, EVMWallet } from "@crossmint/wallets-sdk";

// Initialize
const crossmint = createCrossmint({ apiKey: "..." });
const crossmintWallets = CrossmintWallets.from(crossmint);

// Get wallet
const wallet = await crossmintWallets.getOrCreateWallet({
    chain: "polygon",
    signer: { type: "email", email: "[email protected]", onAuthRequired: async (...) => {...} },
});

// Cast to EVM wallet
const evmWallet = EVMWallet.from(wallet);

// Mint NFT
const NFT_CONTRACT_ABI = [
    {
        name: "mint",
        type: "function",
        inputs: [{ name: "to", type: "address" }],
        outputs: [],
        stateMutability: "payable",
    },
];

const mintTx = await evmWallet.sendTransaction({
    to: "0xNFTContractAddress...",
    abi: NFT_CONTRACT_ABI,
    functionName: "mint",
    args: [wallet.address],
    value: 0n, // Mint price in wei
});

console.log(`NFT minted! Transaction: ${mintTx.explorerLink}`);