ERC-1155 Interaction

ERC-1155 is the multi-token standard — a single contract can hold both fungible tokens (like gold coins in a game) and non-fungible tokens (like unique items), with efficient batch operations built in. Standard ERC-1155 contracts work on Sei without modification.

Try it: deploy an ERC-1155

Compile and deploy a real ERC-1155 to Sei testnet from the browser — the Remix sandbox preloads an OpenZeppelin-based DemoMultiToken with a public mint(id, amount). Then point the read/write patterns below at your deployed address. First, add Sei testnet to your wallet: In Remix, compile under Solidity Compiler, then Deploy & Run with Environment set to Injected Provider — MetaMask.

Setup

import { createPublicClient, createWalletClient, http, parseAbi } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { sei } from 'viem/chains';

const client = createPublicClient({ chain: sei, transport: http() });
const account = privateKeyToAccount('0xYourPrivateKey');
const walletClient = createWalletClient({ account, chain: sei, transport: http() });

const ERC1155_ABI = parseAbi([
  'function balanceOf(address account, uint256 id) view returns (uint256)',
  'function balanceOfBatch(address[] accounts, uint256[] ids) view returns (uint256[])',
  'function isApprovedForAll(address account, address operator) view returns (bool)',
  'function setApprovalForAll(address operator, bool approved)',
  'function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes data)',
  'function safeBatchTransferFrom(address from, address to, uint256[] ids, uint256[] amounts, bytes data)',
  'function uri(uint256 id) view returns (string)',
  'event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value)',
  'event TransferBatch(address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values)',
]);

const CONTRACT = '0xContractAddress';

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com');
const wallet = new ethers.Wallet('0xYourPrivateKey', provider);

const ERC1155_ABI = [
  'function balanceOf(address account, uint256 id) view returns (uint256)',
  'function balanceOfBatch(address[] accounts, uint256[] ids) view returns (uint256[])',
  'function isApprovedForAll(address account, address operator) view returns (bool)',
  'function setApprovalForAll(address operator, bool approved)',
  'function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes data)',
  'function safeBatchTransferFrom(address from, address to, uint256[] ids, uint256[] amounts, bytes data)',
  'function uri(uint256 id) view returns (string)',
  'event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value)',
  'event TransferBatch(address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values)',
];

const CONTRACT = '0xContractAddress';
const readContract = new ethers.Contract(CONTRACT, ERC1155_ABI, provider);
const writeContract = new ethers.Contract(CONTRACT, ERC1155_ABI, wallet);

Reading a Single Balance

const balance = await client.readContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'balanceOf',
  args: ['0xOwnerAddress', 1n], // token ID 1
});

const balance = await readContract.balanceOf('0xOwnerAddress', 1n);

Batch Balance Query

balanceOfBatch retrieves multiple owner/ID pairs in one call — the most efficient way to load a user’s inventory:

const owners = ['0xOwner', '0xOwner', '0xOwner'] as const;
const ids = [1n, 2n, 3n];

const balances = await client.readContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'balanceOfBatch',
  args: [owners, ids],
});
// balances[0] = balance of token 1, balances[1] = token 2, etc.

const owners = ['0xOwner', '0xOwner', '0xOwner'];
const ids = [1n, 2n, 3n];

const balances = await readContract.balanceOfBatch(owners, ids);

Reading Token Metadata URI

viem

const uri = await client.readContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'uri',
  args: [1n],
});
// URI often contains {id} — replace it with the hex token ID per ERC-1155 spec
const resolvedUri = uri.replace('{id}', (1n).toString(16).padStart(64, '0'));

Transferring a Single Token

const hash = await walletClient.writeContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'safeTransferFrom',
  args: [account.address, '0xRecipient', 1n, 5n, '0x'], // transfer 5 of token ID 1
});

const receipt = await client.waitForTransactionReceipt({ hash });

const tx = await writeContract.safeTransferFrom(wallet.address, '0xRecipient', 1n, 5n, '0x');
const receipt = await tx.wait();

Batch Transfer

Send multiple token IDs in a single transaction:

const hash = await walletClient.writeContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'safeBatchTransferFrom',
  args: [
    account.address,
    '0xRecipient',
    [1n, 2n, 3n],     // token IDs
    [5n, 10n, 1n],    // amounts
    '0x',
  ],
});

const tx = await writeContract.safeBatchTransferFrom(
  wallet.address,
  '0xRecipient',
  [1n, 2n, 3n],
  [5n, 10n, 1n],
  '0x',
);

Operator Approval

// Grant an operator permission to transfer all tokens
const hash = await walletClient.writeContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'setApprovalForAll',
  args: ['0xOperatorAddress', true],
});

// Check approval status
const isApproved = await client.readContract({
  address: CONTRACT,
  abi: ERC1155_ABI,
  functionName: 'isApprovedForAll',
  args: ['0xOwnerAddress', '0xOperatorAddress'],
});

const tx = await writeContract.setApprovalForAll('0xOperatorAddress', true);

const isApproved = await readContract.isApprovedForAll('0xOwnerAddress', '0xOperatorAddress');

Watching Transfer Events

// Watch single transfers
const unwatch = client.watchContractEvent({
  address: CONTRACT,
  abi: ERC1155_ABI,
  eventName: 'TransferSingle',
  onLogs: (logs) => {
    logs.forEach(({ args }) => {
      console.log(`Token ${args.id}: ${args.from} → ${args.to}, amount: ${args.value}`);
    });
  },
});

// Watch batch transfers
const unwatchBatch = client.watchContractEvent({
  address: CONTRACT,
  abi: ERC1155_ABI,
  eventName: 'TransferBatch',
  onLogs: (logs) => {
    logs.forEach(({ args }) => {
      console.log(`Batch from ${args.from} → ${args.to}:`, args.ids, args.values);
    });
  },
});

readContract.on('TransferSingle', (operator, from, to, id, value) => {
  console.log(`Token ${id}: ${from} → ${to}, amount: ${value}`);
});

readContract.on('TransferBatch', (operator, from, to, ids, values) => {
  console.log(`Batch from ${from} → ${to}:`, ids, values);
});

Overview

Essentials

seid CLI

Frontend Development

Smart Contracts

sei-js Library

Videos

Ecosystem Tutorials

Reference

Hardware Wallets

ERC-1155 Interaction

ERC-1155 Interaction

Try it: deploy an ERC-1155

Setup

Reading a Single Balance

Batch Balance Query

Reading Token Metadata URI

Transferring a Single Token

Batch Transfer

Operator Approval

Watching Transfer Events

​ERC-1155 Interaction

​Try it: deploy an ERC-1155

​Setup

​Reading a Single Balance

​Batch Balance Query

​Reading Token Metadata URI

​Transferring a Single Token

​Batch Transfer

​Operator Approval

​Watching Transfer Events

ERC-1155 Interaction

Try it: deploy an ERC-1155

Setup

Reading a Single Balance

Batch Balance Query

Reading Token Metadata URI

Transferring a Single Token

Batch Transfer

Operator Approval

Watching Transfer Events