Transfer Native Tokens

Transfer ETH/SOL from a Wallet

This guide will walk you through the process of sending ETH from your wallet using the Crossmint transactions API.

Prerequisites

Ensure you have a wallet created. You can follow the Quickstart for server wallets to prepare one. You will need:

• API Key: Ensure you have your Crossmint API key with the scope wallets:transactions.create.
• Wallet Locator: The locator of the wallet you want to transfer the tokens from.

Sending the transaction

Ethereum

We provide a Create Transaction API for your wallet. To send ETH, we need to set the following parameters:

• calls: An array of objects with the following properties:
  • to: The recipient’s Ethereum address.
  • value: The amount of ETH to send, in wei.
  • data: Unnecessary for just sending ETH. Set it to "0x".
• chain: The chain where the transaction will be sent.
• signer: One of the wallet’s signers. In most cases, this will be the admin signer.

sendTransaction.ts

const walletLocator = '0x...';
const apiKey = 'sk_staging...';
const recipientAddress = '0x...';
const signerAddress = '0x...';

async function sendTransaction() {
    const response = await fetch(`https://api.crossmint.com/2022-06-09/wallets/${walletLocator}/transactions`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'X-API-KEY': apiKey,
        },
        body: JSON.stringify({
            params: {
                calls: [
                    {
                        to: recipientAddress,
                        value: '100000000000000000', // 0.1 ETH in wei
                        data: '0x',
                    },
                ],
                chain: 'base-sepolia',
                signer: `evm-keypair:${signerAddress}`,
            },
        }),
    });

    const data = await response.json();
    console.log(data);
}

sendTransaction().catch(console.error);

We provide a Create Transaction API for your wallet. To send ETH, we need to set the following parameters:

• calls: An array of objects with the following properties:
  • to: The recipient’s Ethereum address.
  • value: The amount of ETH to send, in wei.
  • data: Unnecessary for just sending ETH. Set it to "0x".
• chain: The chain where the transaction will be sent.
• signer: One of the wallet’s signers. In most cases, this will be the admin signer.

sendTransaction.ts

const walletLocator = '0x...';
const apiKey = 'sk_staging...';
const recipientAddress = '0x...';
const signerAddress = '0x...';

async function sendTransaction() {
    const response = await fetch(`https://api.crossmint.com/2022-06-09/wallets/${walletLocator}/transactions`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'X-API-KEY': apiKey,
        },
        body: JSON.stringify({
            params: {
                calls: [
                    {
                        to: recipientAddress,
                        value: '100000000000000000', // 0.1 ETH in wei
                        data: '0x',
                    },
                ],
                chain: 'base-sepolia',
                signer: `evm-keypair:${signerAddress}`,
            },
        }),
    });

    const data = await response.json();
    console.log(data);
}

sendTransaction().catch(console.error);

1. First, we need to prepare the transaction that will send 0.001 SOL.

   For the transaction parameters:

   • Use "11111111111111111111111111111111" as the blockhash (Crossmint will replace this)
   • Use "11111111111111111111111111111112" as the payerKey (Crossmint will replace this)
   • Do not include the sending wallet in the signers array
   • Do not sign the transaction (Crossmint will handle signing)

   The transaction will be properly configured on Crossmint’s servers with the correct values before execution. Crossmint will also pay for the transaction fee.

   prepareTransaction.ts

   import { PublicKey, TransactionMessage, VersionedTransaction, SystemProgram } from "@solana/web3.js";
   import base58 from "bs58";
   
   // Addresses
   const fromPublicKey = new PublicKey("your_wallet_address");
   const toPublicKey = new PublicKey("recipient_address");
   const amount = 10000000; // Amount in lamports (1 SOL = 1,000,000,000 lamports)
   
   // Create a transaction
   const message = new TransactionMessage({
       instructions: [
           SystemProgram.transfer({
               fromPubkey: fromPublicKey,
               toPubkey: toPublicKey,
               lamports: amount,
           }),
       ],
       recentBlockhash: "11111111111111111111111111111111",
       payerKey: new PublicKey("11111111111111111111111111111112"),
   }).compileToV0Message();
   
   const transaction = new VersionedTransaction(message);
   const serializedTransactionStr = base58.encode(transaction.serialize());
   console.log("Base58 Encoded Transaction:", serializedTransactionStr);
   
   

2. Send the transaction to the /transactions endpoint. We only need to send the transaction field with the base58 encoded transaction generated in the previous step.

   sendTransaction.ts

   const apiKey = "sk_staging...";
   const walletLocator = "0x...";
   
   async function sendTransaction(serializedTransactionStr) {
       const response = await fetch(`https://staging.crossmint.com/api/2022-06-09/wallets/${walletLocator}/transactions`, {
           method: "POST",
           headers: {
               "X-API-KEY": apiKey,
               "Content-Type": "application/json",
           },
           body: JSON.stringify({
               params: {
                   transaction: serializedTransactionStr,
               },
           }),
       });
   
       const data = await response.json();
       console.log(data);
   }
   
   sendTransaction("your_base58_encoded_transaction_string").catch(console.error);