chore: implement a helper createAssetId function

.changeset/free-birds-soar.md

@@ -0,0 +1,4 @@
+---
+---
+
+chore: implement a helper createAssetId function

apps/docs-snippets/src/guide/contracts/minted-token-asset-id.test.ts

@@ -1,5 +1,5 @@
 import type { Contract } from 'fuels';
-import { bn, getMintedAssetId } from 'fuels';
+import { bn, getMintedAssetId, createAssetId } from 'fuels';
 
 import { DocSnippetProjectsEnum } from '../../../test/fixtures/forc-projects';
 import { createAndDeployContractFromProject } from '../../utils';
@@ -30,4 +30,16 @@
     expect(mintedAssetId).toBeDefined();
     expect(txResult.transactionResult.isStatusSuccess).toBeTruthy();
   });
+
+  it('should create valid asset ID', async () => {
+    // #region create-asset-id-1
+    const subID = '0xc7fd1d987ada439fc085cfa3c49416cf2b504ac50151e3c2335d60595cb90745';
+
+    const assetId = createAssetId(contract.id.toB256(), subID);
+    // #endregion create-asset-id-1
+    const { value } = await contract.functions.echo_asset_id_comparison(assetId).simulate();
+
+    expect(assetId).toBeDefined();
+    expect(value).toBeTruthy();
+  });
 });

apps/docs/spell-check-custom-words.txt

@@ -1,6 +1,7 @@
 ABI
 ABIs
 ASM
+AssetId
 IDE
 IDEs
 LSP

apps/docs/src/guide/contracts/minted-token-asset-id.md

@@ -17,4 +17,12 @@ Imagine that this contract is already deployed and we are about to mint some coi
 
 <<< @/../../docs-snippets/src/guide/contracts/minted-token-asset-id.test.ts#minted-token-asset-id-2{ts:line-numbers}
 
+## Obtaining the Asset ID
+
 Since the asset ID depends on the contract ID, which is always dynamic (unlike the sub ID, which can be set to a fixed value), the helper `getMintedAssetId` can be used to easily obtain the asset ID for a given contract ID and sub ID.
+
+## Create Asset Id
+
+The SDK provides a helper named `createAssetId` which takes the contract ID and sub ID as parameters. This helper internally calls `getMintedAssetId` and returns the Sway native parameter [AssetId](https://docs.fuel.network/docs/fuels-ts/interfaces/#assetid), ready to be used in a Sway program invocation:
+
+<<< @/../../docs-snippets/src/guide/contracts/minted-token-asset-id.test.ts#create-asset-id-1{ts:line-numbers}

packages/transactions/src/coders/receipt.ts

@@ -2,6 +2,7 @@
 import { Coder, BigNumberCoder, B256Coder, NumberCoder } from '@fuel-ts/abi-coder';
 import { ErrorCode, FuelError } from '@fuel-ts/errors';
 import { sha256 } from '@fuel-ts/hasher';
+import type { AssetId } from '@fuel-ts/interfaces';
 import type { BN } from '@fuel-ts/math';
 import { arrayify, concat } from '@fuel-ts/utils';
 
@@ -774,6 +775,10 @@ export const getMintedAssetId = (contractId: string, subId: string): string => {
   return sha256(concat([contractIdBytes, subIdBytes]));
 };
 
+export const createAssetId = (contractId: string, subId: string): AssetId => ({
+  bits: getMintedAssetId(contractId, subId),
+});
+
 export class ReceiptMintCoder extends Coder<ReceiptMint, ReceiptMint> {
   constructor() {
     super('ReceiptMint', 'struct ReceiptMint', 0);