After creating your modules, you need to tell Yours Protocol which modules a token should implement. This can be done either at token creation time or later when the token already exists.
Token Creation
When creating a new token, specify which modules it should support:
// Create a character that can equip items
operation create_character(name: text) {
val account = ft4.auth.authenticate();
// Create token with character module
val spec = yours.token_specification(
project = yours.project_info("Game Example", chain_context.blockchain_rid),
collection = "Characters",
name,
modules = ["characters"] // Specify modules at creation
);
val token = yours.create_token(spec);
characters.attach(token, name); // Initialize character data
}
// Create an equippable item
operation create_item(name: text, power: integer) {
val account = ft4.auth.authenticate();
// Create token with item module
val spec = yours.token_specification(
project = yours.project_info("Game Example", chain_context.blockchain_rid),
collection = "Items",
name,
modules = ["items"] // Specify modules at creation
);
val token = yours.create_token(spec);
items.attach(token, power); // Initialize item data
}
Adding Modules Later
You can also add module support to existing tokens:
// Make an existing token equippable
operation make_item(token: yours.token, power: integer) {
val account = ft4.auth.authenticate();
// Add items module to token
items.attach(token, power);
}
Best Practices
Attachment
Provide helper functions in your modules to handle the attachment process:
// modules/items/functions.rell
function attach(token: yours.token, power: integer) {
// Initialize item data
yours.attach_module(token, "items");
create item(token, power);
}
// modules/characters/functions.rell
function attach(token: yours.token, name: text) {
yours.attach_module(token, "characters");
// Initialize character data
create character(token, name, experience_points = 0);
}
