🔺 Grabber-key

Your Gateway to the Portal Worlds

In the Portal Point ecosystem, GRABBERS are more than just game objects. They are keys—gateways to mysterious realms, hidden stories, and rewards in the form of $POINT tokens. The player's journey through the Portal begins with activating a Grabber.

---

🔹 What is a Grabber?

A Grabber is a special digital item that players activate before entering a session. Once activated, it becomes a target within the Portal—players must tap it at the right moment to collect points. A wrong tap, however, can result in losing your accumulated multiplier and drastically lowering your rewards.

---

🔹 Access to Worlds

Every Grabber serves as a key to specific worlds and storylines within the Portal. Some are tied to unique locations, characters, or events. Only with the appropriate key can a player access exclusive NFT-based worlds and explore their immersive comic-style narratives.

---

🔹 Limited Collection

There are 100 unique types of Grabbers in the game. Each has its own visual identity, theme, and role:

• Some provide steady point income

• Others are rare and yield significantly more, especially with high multipliers

• Top-tier Grabbers unlock access to the most secret and valuable realms

---

🔹 NFTs and Shared Ownership

Some Grabbers are released as NFTs with collective ownership. This means multiple players can co-own a rare key and benefit together—sharing both access privileges and in-game earnings. It opens up a new model of collaborative gameplay and a DAO-style digital economy.

---

🔹 Gameplay Value

Grabbers are not just "point catchers." They are symbols of transformation and access, allowing players to craft strategic approaches to earning while exploring the Portal’s vast multiverse.

---

🔹 The Access Control & Incentive Layer

Within the PORTAL POINT architecture, Grabber Keys are the primary utility primitive that operationalizes user engagement, controls access to digital assets, and facilitates the bridge between Telegram-based interaction and the Stellar-centric economy. They are smart, stateful tokens whose logic is executed on the Stellar blockchain via Soroban contracts, while their distribution and initial user interaction occur via the Telegram/TON layer.

1. Core Technical Definition & Function

A Grabber Key is a stateful digital token, implemented primarily as a Stellar Custom Asset, that encodes a user's right to:

• Initiate a Game Session: Activate a time-bound interaction loop within the Telegram Mini-App.

• Claim In-Game Points (POINT): Generate verifiable proof of engagement, which is processed off-chain and later attested to on-chain.

• Unlock Specific PORTAL Worlds: Serve as a cryptographic key, where ownership is validated against a Soroban smart contract to grant access to a corresponding Stellar NFT World and its metadata.

State Model: Each key has an on-chain state (active, cooldown, charged) managed by a Soroban contract, influencing its cooldown periods, multiplier efficiency, and access privileges.

2. Integration in the Multi-Chain Data Flow

The lifecycle of a Grabber Key demonstrates the separation of concerns in the stack:

User Action (Telegram/TON Layer)
         ↓
Activates Key via Mini-App → Records intent (off-chain)
         ↓
Stellar Validation Layer (Soroban)
         ├── Contract `access_controller` verifies key ownership & state
         ├── If valid: returns signed access token & updates key state
         └── Event emitted: `PortalAccessGranted(key_id, world_id)`
         ↓
Game Session & POINT Accumulation (Off-Chain Logic)
         ↓
Attestation Generation (Portal Backend)
         ├── Session results (POINT earned) signed into an attestation
         └── Attestation root anchored on Stellar via `ManageData`
         ↓
Asset Access & Redemption
         ├── For World Access: Client presents access token to view NFT World content.
         └── For Partner Games (e.g., HERO2QUEST): Proof of POINT attestation can be redeemed for in-game assets via a separate Stellar utility NFT.

3. Classification & Smart Properties

The collection is governed by a deterministic contract defining types

rust:

// Soroban Contract: Key Registry
pub struct KeySchema {
    pub key_class: u8,       // 1-100, defines visual and thematic identity
    pub rarity: RarityTier,  // Common, Rare, Epic, Legendary
    pub base_multiplier: i64, // Base POINT multiplier (e.g., 100, 200, 500)
    pub cooldown_secs: u64,  // Session cooldown period
    pub required_stake: Option<Asset>, // Optional $PORTAL stake for activation
    pub max_holders: u32,    // For shared keys (1 = solo, >1 = collective)
}

pub enum RarityTier {
    Common,      // Standard access, high supply.
    Rare,        // Enhanced multiplier, event-linked.
    Epic,        // Grants access to worlds with generative AI content.
    Legendary,   // Enables shared ownership (multi-sig) & revenue share.
}

Shared Ownership (Legendary Keys): Implemented via Stellar's AUTHORIZATION_REQUIRED and CLAWBACK flags. The NFT is held by a dedicated Vault Account. Co-owners hold shares represented by secondary tokens or off-chain agreements. A Soroban contract manages profit distribution (in XLM) and vote-based activation.

4. Access Control Mechanism

Access to a PORTAL World (a Stellar NFT) is not granted by mere possession but by proving active, valid ownership of a linked key at the moment of request

rust:

// Simplified Access Control Logic
fn can_access_world(user: Address, world_id: BytesN<32>) -> bool {
    // 1. Fetch the required key class for this world
    let required_key = world_requirements.get(world_id);

    // 2. Check user's balance for that specific key asset
    let user_balance = user.balance_of(required_key.asset);

    // 3. Verify key is not in cooldown and is active
    let key_state = key_states.get((user, required_key.asset));
    return user_balance > 0 &&
           key_state.status == Status::Active &&
           current_time() > key_state.cooldown_until;
}

5. Economic & Governance Interface

• POINT Multiplier Engine: The key's rarity and charged state factor into the off-chain calculation of POINT rewards, creating a transparent and verifiable incentive model.

• Governance Link: Legendary keys often double as voting shares in decentralized curation decisions (e.g., selecting themes for AI-generated worlds).

• Secondary Market Bridge: While utility resides on Stellar, select key collections can be mirrored as ERC-721 tokens on Polygon (via the decentralized bridge) for listing on platforms like Rarible, separating their collectible value from their functional utility.

6. Summary: Technical Role

The Grabber Key subsystem is a hybrid smart contract that:

1. Serves as a Gating Function for high-value digital assets (NFT Worlds).

2. Acts as a Provable Engagement Node in the Proof-of-Participation Protocol.

3. Implements a Microeconomic Model via programmable rarity, cooldowns, and staking requirements.

4. Enables Novel Ownership Models through shared asset functionality on Stellar. It is the critical link that transforms casual Telegram gameplay into structured, verifiable, and valuable on-chain activity within the Stellar ecosystem.