Skip to main content

Transfer Tokens & NFTs

Transfering 1,000 CHILL tokens or a Chillwhale NFT between two Universal Profiles
Transfering 1,000 CHILL tokens between two Universal Profiles.

info

The full code of this example can be found in the 👾 lukso-playground.

This guide will teach you how to transfer LSP7 tokens or LSP8 NFTs from a Universal Profile to any address.

Setup Dependencies​

You will need the following libraries to do this tutorial:

npm install ethers @lukso/lsp-smart-contracts

Examples​

First, create an instance of the LSP7 or LSP8 contract. You will need:

  • the address of the LSP7 or LSP8 Token contract you want to transfer tokens / NFT from.
  • one of the following smart contract ABI from the @lukso/lsp-smart-contracts package:
    • LSP7DigitalAsset if you want to transfer tokens.
    • LSP8IdentifiableDigitalAsset if you want to transfer an NFT from the collection.

Transfer LSP7 tokens​

Call the LSP7 transfer(address,address,uint256,bool,bytes) function and pass the amount as 3rd parameter.

Since most tokens have 18 decimals(), make sure to specify the amount with 18 decimals place. For instance, if you want to transfer 8 tokens the amount parameter will be: 8_000_000_000_000_000_000 ✅, not 8 ❌.

Otherwise, the transfer might have occured but you might not see the balance of the recipient updated, since you transferred only a tiny small amount (8 for a token with 18 decimals is basically 1 / 1e18). To do so easily, use one of number utility function from ethers.js or web3.js.

import { ethers } from 'ethers';

// Import the LSP7 ABI
import LSP7DigitalAsset from '@lukso/lsp-smart-contracts/artifacts/LSP7DigitalAsset.json';

// Connect to the UP Browser extension
const provider = new ethers.BrowserProvider(window.lukso);
await provider.send('eth_requestAccounts', []);
const signer = await provider.getSigner();

// Create instance of the CHILL token contract
const chillToken = new ethers.Contract(
  '0x5b8b0e44d4719f8a328470dccd3746bfc73d6b14', // Chillwhale Token contract address
  LSP7DigitalAsset.abi,
);

await chillToken.transfer(
  signer.getAddress(), // (from) sender address (= our Universal Profile)
  '0x02e655F92f01BC7880807ec409F134b91bb28381', // (to) recipient's address
  ethers.parseUnits('15', 18), // (amount) of tokens to transfer (CHILL have 18 decimals)
  true, // (force) flag, false to only allow contract with a Universal Receiver, true for any address (EOA or any contract)
  '0x', // (data) any additional data to send alongside the transfer
);
Notes on decimals

If you are transferring LSP7 tokens with 0 as decimals() or NFTs represented as LSP7 with TokenType 1, just pass the amount as a number without using the number formatting function.

Here is an example to transfer 2 x digital trading cards from the LUKSO Family Game (series LFG03):

// Create instance of the LUKSO Family Game (LFG03) token contract
const luksoFamilyGameSeries03 = new ethers.Contract(
  '0x6a58a1f2cbb5b39d90618736a7730bff0fa72801', // LUKSO Family Game (LFG03) contract address
  LSP7DigitalAsset.abi,
);

await luksoFamilyGameSeries03.transfer(
  signer.getAddress(), // (from) sender address (= our Universal Profile)
  '0x02e655F92f01BC7880807ec409F134b91bb28381', // (to) recipient's address
  2, // (amount) of tokens to transfer (LFG03 token contract has 0 decimals)
  true, // (force) flag, false to only allow contract with a Universal Receiver, true for any address (EOA or any contract)
  '0x', // (data) any additional data to send alongside the transfer
);

Transfer LSP8 NFTs​

Call the LSP8 transfer(address,address,bytes32,bool,bytes) function and pass the tokenId of the NFT from the collection you want to transfer as 3rd parameter.

Make sure you specify the tokenId as a 32 bytes long value, as shown in the code snippet below.

import { ethers } from 'ethers';

// Import the LSP8 ABI
import LSP8IdentifiableDigitalAsset from '@lukso/lsp-smart-contracts/artifacts/LSP8IdentifiableDigitalAsset.json';

// Connect to the UP Browser extension
const provider = new ethers.BrowserProvider(window.lukso);
await provider.send('eth_requestAccounts', []);
const signer = await provider.getSigner();

// Create instance of the Chillwhale NFT collection contract
const chillwhaleNft = new ethers.Contract(
  '0x86e817172b5c07f7036bf8aa46e2db9063743a83', // Chillwhale NFT collection contract address
  LSP8IdentifiableDigitalAsset.abi,
);

// Create the bytes32 representation of the tokenId number 319 (2nd param right pad to 32 bytes)
const tokenId = ethers.toBeHex(319, 32);

await chillwhaleNft.transfer(
  signer.getAddress(), // (from) sender address (= our Universal Profile)
  '0x02e655F92f01BC7880807ec409F134b91bb28381', // (to) recipient's address
  tokenId, // (tokenId) of the NFT to transfer
  true, // (force) flag, false to only allow contract with a Universal Receiver, true for any address (EOA or any contract)
  '0x', // (data) any additional data to send alongside the transfer
);

Found an error in the docs?
Thinking of a missing guide?
Give us feedback →

Questions? Want to learn more?

Ask your questions to the team or community on the LUKSO Discord server.