tribe_permit.move

The tribe_permit.move module is a config-based builder extension for world::gate. Like gate.move, it enforces tribe-based jump rules, but instead of managing its own shared objects, it stores configuration as dynamic fields under the shared ExtensionConfig object.

1. Core Component Architecture

classDiagram
    class ExtensionConfig {
        +UID id
    }
    class TribeConfig {
        +u32 tribe
    }
    class TribeConfigKey {
        <<key - copy, drop, store>>
    }

    ExtensionConfig *-- TribeConfig : dynamic field via TribeConfigKey
    TribeConfig ..> Gate : enforces tribe check

Key Components

• TribeConfig — A store + drop struct holding the required tribe ID. Stored as a dynamic field value under ExtensionConfig.
• TribeConfigKey — A copy + drop + store struct used as the dynamic field key to locate TribeConfig.

2. Extension Flow

sequenceDiagram
    participant Admin
    participant Config as ExtensionConfig
    participant Ext as tribe_permit
    participant Gate as world::gate
    participant Player

    Admin->>Ext: set_tribe_config(tribe=42)
    Ext->>Config: set_rule of TribeConfigKey, TribeConfig

    Player->>Ext: issue_jump_permit(...)
    Ext->>Config: borrow_rule of TribeConfigKey → TribeConfig
    Ext->>Ext: assert character.tribe() == tribe_cfg.tribe
    Ext->>Gate: gate::issue_jump_permit of XAuth (5-day expiry)
    Gate-->>Player: JumpPermit transferred

Compared to gate.move

3. Admin Operations

4. Security Patterns

• Config Existence Check — issue_jump_permit asserts that TribeConfig exists on ExtensionConfig before proceeding, preventing calls before admin configuration.
• Shared Witness — Uses config::x_auth() to obtain the XAuth witness, ensuring all modules in the extensions package are authorized through a single registration on the gate.