E1

Sui & Move Bootcamp <> Advanced Programmable Transactions

This exercise contains a simple Node project using Typescript, that executes an advanced transaction block on the Sui blockchain, to mint a Hero NFT and a Sword NFT, and attach the Sword to the Hero as a Dynamic Object Field.

Useful Links

• Programmable Transaction Blocks
• Sui TS SDK | Programmable Transaction Blocks
• Sui TS SDK | Passing inputs to a transaction

Quickstart

• Create a .env file in the mint-hero/ directory, following the structure of the .env.example:

SUI_NETWORK=testnet
PACKAGE_ID=0xc413c2e2c1ac0630f532941be972109eae5d6734e540f20109d75a59a1efea1e
USER_SECRET_KEY=

• Run the following commands:

cd mint-hero
npm i
npm run test

Instructions

• Notice that all of the tests in the mintHeroWithSword.test.ts file are failing:
  • Transaction Status: Validates that the status of the transfer transaction is "success".
  • Created Hero And Sword: Validates that a Hero NFT and a Sword NFT are created.
  • Hero is equiped with a Sword: Validates that our Hero is equiped with a Sword.

1. Mint the Hero, the Sword, and equip it

• Modify the src/helpers/mintHeroWithSword.ts function, by adding the implementation:
  • You should use the tx.moveCall method for making custom move calls.
  • You should use the mint_hero function of the hero module to mint the Hero object.
  • You should use the new_sword function of the blacksmith module to mint the Sword object.
  • You should use the equip_sword function of the hero module to equip the Sword object.
  • You should use the include effects and objectTypes in the output, you can use:

    include: {
      effects: true,
      objectTypes: true
    }
  

  the object changes will be included under effects.objectChanges
  • Last but not least, do not forget to transfer the Hero object to an address, since the Hero object is an actual NFT that does not have the Drop ability, so it must be "consumed" somehow!!

2. Parse the IDs of the created Hero and Sword

• Modify the parseCreatedObjectsIds.ts function, so that you can extract both the Hero's and the Sword's object ID:
  • You should filter the object changes by idOperation === "Created".
  • You should pass objectTypes and objectChanges as inputs, which are obtained from the move call before.
  • Filter by the corresponding objectType to differentiate between the Hero and the Sword.

3. Parse the Swords that are attached to a specfic Hero

• Modify the getHeroSwordIds.ts function, so that you can extract the object IDs of the Swords that are attached to a Hero object:
  • You should use the suiClient.listDynamicFields function to get the dynamic fields that are attached to the Hero.
  • You should filter them by the objects type, to keep only the Swords.
  • You should use the suiClient.getDynamicObjectField function for every object, to get the object ids of the attached swords.