# Working with Tokens

{% hint style="warning" %}
Make sure to implement the [prerequisite code](https://connect.socios.com/interact-with-chiliz-chain/prerequisites), or else the examples in this page will not work!
{% endhint %}

Of note: When working with official Fan Tokens in your project, you must use their correct addresses in your dApp. See here:

{% content-ref url="working-with-tokens/testnet-fan-token-addresses" %}
[testnet-fan-token-addresses](https://connect.socios.com/interact-with-chiliz-chain/working-with-tokens/testnet-fan-token-addresses)
{% endcontent-ref %}

{% content-ref url="working-with-tokens/mainnet-fan-token-addresses" %}
[mainnet-fan-token-addresses](https://connect.socios.com/interact-with-chiliz-chain/working-with-tokens/mainnet-fan-token-addresses)
{% endcontent-ref %}

### Prerequisite: ERC20ABI JSON file <a href="#prerequisite-survey-json-file" id="prerequisite-survey-json-file"></a>

{% hint style="success" %}
When working with Fan Tokens, and for some use-cases described in this page (the ones that import `ERC20ABI`), you will need the below **ERC20ABI.json** file saved in your project folder.

Make sure that you import that file in your code in order to achieve the wanted step (the samples already have the necessary `import` code).
{% endhint %}

{% file src="<https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2F4TYSk9KJGsbbvnEWLF1w%2FFanTokenABI.json?alt=media&token=84a15b49-8e5f-4a5c-9052-9ef9ed717b06>" %}

## Retrieve user token balances

You can retrieve how many tokens of a specific type (ERC-20) a user holds in their wallet.&#x20;

From there, you can create any scenario related to the balance. \
For instance, you can implement token-gating contents: giving access to certain content of your website only to holders of a certain token.

{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}

```javascript
import erc20ABI from './ERC20ABI.json';

const tokenAddress = '0xYourTokenAddress'; // Replace with the actual ERC-20 contract address
const userAddress = '0xUserWalletAddress'; // Replace with the user's wallet address

async function getTokenBalance() {
  const balance = await client.readContract({
    address: tokenAddress,
    abi: erc20ABI,
    functionName: 'balanceOf', // This is standard ERC-20 function to get balance
    args: [userAddress],
  });
  return balance.toString();
}

// Example usage
getTokenBalance().then(console.log);
```

{% endcode %}

{% hint style="success" %}
If you want to know if the user holds a specific token, make sure to check their wallet balance **and also to check their staked balance.** Read [how to know what's staked](https://connect.socios.com/working-with-staking#knowing-whats-staked).

Indeed, staked tokens are not taken into account in the wallet balance as they are not held in the wallet anymore: they are held on the staking smart-contract.
{% endhint %}

***

## Retrieve user CHZ balance

You can retrieve how many tokens of a specific native token a user has held in their wallet; for instance, CHZ on Chiliz Chain.

{% code lineNumbers="true" fullWidth="true" %}

```javascript
async function getNativeTokenBalance(address) {
  const balance = await client.getBalance({
    address,
  });
  return balance.toString();
}

// Example usage. Replace 0xUserWalletAddress with the actual user wallet address.
getNativeTokenBalance('0xUserWalletAddress').then(console.log);
```

{% endcode %}

***

## Send ERC-20 Tokens to a wallet

You can send any token held in your wallet to any other wallet.

{% hint style="success" %}
This is a code-based alternative to the `POST /admin/wallet/transfer/fan-token` endpoint, which was deprecated from the Socios.com API in Q1 2025.
{% endhint %}

{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}

```javascript
import { createWalletClient, privateKeyToAccount } from 'viem';

const privateKey = '0xSenderPrivateKey'; // Replace with the sender's private key
const account = privateKeyToAccount(privateKey);
const walletClient = createWalletClient({
  account,
  transport: http('YOUR-CHOSEN-RPC-ENDPOINT.com'),
});

async function sendTokens(to, amount) {
  const txHash = await walletClient.writeContract({
    address: '0xYourTokenAddress', // Replace with the ERC-20 token contract address
    abi: erc20ABI,
    functionName: 'transfer', // Standard ERC-20 function to transfer tokens
    args: [to, BigInt(amount * 1e18)],
  });
  return txHash;
}

// Example usage. Replace 0xRecipientAddress with the actual recepient wallet address, and 10 with the exact amount to send.
sendTokens('0xRecipientAddress', 10).then(console.log);
```

{% endcode %}

{% hint style="danger" %}
**Your private key must only be used in server-side code.** \
DO NOT release code on production with your private key shared on front-end side code.
{% endhint %}