Fuel TS SDK

⌘K

Address Conversion

Icon LinkAddress

Addresses and varying address formats are commonplace when interacting with decentralized applications. Furthermore, different networks may enforce different address formats.

The Fuel Network uses the B256 address format for its interactions, an example of which can be seen below:

const b256 =
  '0x9ae5b658754e096e4d681c548daf46354495a437cc61492599e33fc64dcdc30c';

However, a hexlified B256 (hex) is another common address format; an example can be seen below:

const b256Address =
  '0xbebd3baab326f895289ecbd4210cf886ce41952316441ae4cac35f00f0e882a6';

At times, these can even be wrapped in a Struct . Such as an Asset ID or a EVM Address :

const evmAddress: EvmAddress = {
  bits: '0x000000000000000000000000210cf886ce41952316441ae4cac35f00f0e882a6',
};

The TS-SDK makes converting between these addresses simple using the Address helper, which provides various utilities for conversion.

The following conversion guide will show how to utilize this class to convert between address formats, as well as Sway Standard Types.

Icon LinkAddress Conversion

This guide demonstrates how to convert between address formats and Sway Standard Types using helper functions. Native types are wrappers for bytes, and you can perform conversions between them by leveraging these functions and classes.

Icon LinkConverting a Contract ID

The Contract id property is an instance of the Address Icon Link class. Therefore, it can be converted using the Address Icon Link class functions such as toAddress and toB256:

import type { B256Address } from 'fuels';
import { Address, Provider, Contract } from 'fuels';
 
import { LOCAL_NETWORK_URL } from '../../../../env';
import { Counter } from '../../../../typegend/contracts';
 
const provider = new Provider(LOCAL_NETWORK_URL);
 
const contractAbi = Counter.abi;
const contractAddress = new Address(
  '0x6d309766c0f1c6f103d147b287fabecaedd31beb180d45cf1bf7d88397aecc6f'
);
 
const contract = new Contract(contractAddress, contractAbi, provider);
 
const b256: B256Address = contract.id.toAddress();
// 0x6d309766c0f1c6f103d147b287fabecaedd31beb180d45cf1bf7d88397aecc6f

Icon LinkConverting a Wallet Address

Similarly, the Wallet address property is also of type Address Icon Link and can therefore use the same Address Icon Link class functions for conversion:

import type { B256Address, WalletLocked } from 'fuels';
import { Address, Provider, Wallet } from 'fuels';
 
import { LOCAL_NETWORK_URL } from '../../../../env';
 
const provider = new Provider(LOCAL_NETWORK_URL);
 
const address = new Address(
  '0x6d309766c0f1c6f103d147b287fabecaedd31beb180d45cf1bf7d88397aecc6f'
);
 
const wallet: WalletLocked = Wallet.fromAddress(address, provider);
 
const b256: B256Address = wallet.address.toAddress();
// 0x6d309766c0f1c6f103d147b287fabecaedd31beb180d45cf1bf7d88397aecc6f

Icon LinkConverting an Asset ID

Asset IDs are a wrapped B256 value. The following example shows how to create an Address Icon Link from a B256 type:

import type { AssetId, B256Address } from 'fuels';
import { Address } from 'fuels';
 
const b256: B256Address =
  '0x6d309766c0f1c6f103d147b287fabecaedd31beb180d45cf1bf7d88397aecc6f';
const address: Address = new Address(b256);
const assetId: AssetId = address.toAssetId();
// {
//    bits: '0x6d309766c0f1c6f103d147b287fabecaedd31beb180d45cf1bf7d88397aecc6f
// }