Fuel TS SDK

⌘K

Asset Id

Icon LinkAsset ID

An Asset ID can be represented using the AssetId type. It's definition matches the Sway standard library type being a Struct wrapper around an inner Bits256 value.

import type { AssetId } from 'fuels';
import { getRandomB256 } from 'fuels';
 
const bits256 = getRandomB256();
 
const assetId: AssetId = {
  bits: bits256,
};

Icon LinkUsing an Asset ID

You can easily use the AssetId type within your Sway programs. Consider the following contract that can compares and return an AssetId:

contract;
 
abi EvmTest {
    fn echo_asset_id() -> AssetId;
    fn echo_asset_id_comparison(asset_id: AssetId) -> bool;
    fn echo_asset_id_input(asset_id: AssetId) -> AssetId;
}
 
const ASSET_ID: AssetId = AssetId::from(0x9ae5b658754e096e4d681c548daf46354495a437cc61492599e33fc64dcdc30c);
 
impl EvmTest for Contract {
    fn echo_asset_id() -> AssetId {
        ASSET_ID
    }
 
    fn echo_asset_id_comparison(asset_id: AssetId) -> bool {
        asset_id == ASSET_ID
    }
 
    fn echo_asset_id_input(asset_id: AssetId) -> AssetId {
        asset_id
    }
}

The AssetId struct can be passed to the contract function as follows:

const assetId: AssetId = {
  bits: '0x9ae5b658754e096e4d681c548daf46354495a437cc61492599e33fc64dcdc30c',
};
 
const { value } = await contract.functions
  .echo_asset_id_comparison(assetId)
  .get();

And to validate the returned value:

const { value } = await contract.functions.echo_asset_id().get();
 
console.log('value', value);
// const value: AssetId = {
//   bits: '0x9ae5b658754e096e4d681c548daf46354495a437cc61492599e33fc64dcdc30c',
// };