1 of 1

transferCrypto

How to call the API from an app

Then, depending on whether you're trying to connect to a metamask account or a non-metamask account, you can call the snap API in the following way:

const snapId = `npm:@hashgraph/hedera-wallet-snap`

const transferCryptoAPI = async () => {
  const externalAccountParams = {
    externalAccount: {
      accountIdOrEvmAddress: '0.0.12345',
      curve: 'ED25519'
    }
  }

  const transfers = [
    {
      assetType: 'HBAR', // 'HBAR' | 'TOKEN' | 'NFT'
      to: '0.0.4498148',
      amount: 1,
      assetId?, // You must pass in a Token ID or NFT Id for transferring tokens
      from?,    // This can be passed if you're trying to do a delegated transfer
    }
  ]

  // If you're sending to an exchange account, 
  // you will likely need to fill this out
  const memo = '' 

  await window.ethereum.request({
    method: 'wallet_invokeSnap',
    params: {
      snapId,
      request: {
        method: 'transferCrypto',
        params: {
          network: 'testnet',
          transfers,
          memo,
          maxFee: undefined
          /* 
            Uncomment the below line if you want to connect 
            to a non-metamask account
          */
          // ...externalAccountParams
        }
      }
    }
  })
}

If you pass an 'undefined' value to maxFee, the snap uses the maximum possible value as maxFee

What the API does

Parses the arguments that were passed such as the asset to transfer, who to transfer to and the amount to transfer.
Send the asset to the receiver address
Returns the transaction receipt as response

An example response:

{
  "currentAccount": {
    "hederaAccountId": "0.0.4559",
    "hederaEvmAddress": "0x3ba201df50314e4702d4d92b52d304ee63bfca23",
    "balance": {
      "hbars": 89.60505513,
      "timestamp": "Thu, 01 Feb 2024 21:22:58 GMT",
      "tokens": {}
    },
    "network": "testnet"
  },
  "receipt": {
    "status": "SUCCESS",
    "accountId": "",
    "fileId": "",
    "contractId": "",
    "topicId": "",
    "tokenId": "",
    "scheduleId": "",
    "exchangeRate": {
      "hbars": 1,
      "cents": 12,
      "expirationTime": "Mon, 25 Nov 1963 17:31:44 GMT",
      "exchangeRateInCents": 12
    },
    "topicSequenceNumber": "0",
    "topicRunningHash": "",
    "totalSupply": "0",
    "scheduledTransactionId": "",
    "serials": [],
    "duplicates": [],
    "children": []
  }
}

Live Demo on CodePen