Docs – Fight Code

[Referenced for Solana programs; Rust/ SPL; with flexibility for adaptation to EVM/ Base]

Fight Code Architecture & Logic

The Fight Code smart contract, deployed as a Solana Program, orchestrates the 1v1 NFT battle adjudication with cyclic logic: “rock-paper-scissors” as a loose analogy. This Solana-native implementation leverages Anchor framework for account management, ensuring gas-efficient execution and scalability for 1,000+ simultaneous users via Helius RPC nodes.

A user initiates a Challenge by invoking the ‘post_challenge instruction within the Battle Code Program. If a FCODE wager is involved the ‘post_wager instruction is called and if Challenge accepted both Users see a request to invoke ‘post_escrow instruction.

The Program fetches the body type, variable traits—Strength, Speed, Intelligence, Weapon, and Shield; 8-15 points total depending on the NFT via their SPL Token metadata accounts.

It retrieves the chosen Environ (e.g., NYC, Mars, Coliseum) from the `BattleState` account, factoring in its three movable 3D objects as contextual modifiers.

Using a custom Rust function (`evaluate traits`), the contract computes a battle SCORE by comparing trait values against a pre-programmed dataset of outcomes. This SCORE reflects each NFT’s strategic positioning.

Solana Program Library (SPL) for token-related operations.
Program-Derived Addresses (PDAs) used to handle secure, program-controlled data storage
adapted using Solang (a tool to compile Solidity for Solana) for EVM chains
Program data managed through Solana accounts; efficient state management

[ Battle Logic SCORING ]

Small Chance Element

When the SCORE is closer than 45%/55% a random die roll is generated using Solana’s ‘rand ‘crate, producing a value from 1 to 10. If 1–5, the score of the apparent loser is incremented by that amount, introducing a small chance to overturn the outcome. If 6-10, the preliminary winner is confirmed.

This adds small chance to skill adjustment and circumvents coders gaming the system. This logic is encapsulated in the `adjust_with_die` function, ensuring a tamper-proof random number generation via Solana’s consensus layer.

Winner Issuance

The final SCORE is processed by the `determine_winner` function, which outputs a `Pubkey` for the victorious wallet. The contract updates the winner’s NFT metadata with 1 additional victory Trait point (capped at 30) using Metaplex’s `update_metadata` instruction.

NFT gaming fair play open source contract
gameplay chance derived from user trait input and AI smart contract evaluation

[ ELITE level NFTs]

Battle Clips | AI Video NFT

An ELITE Battle triggers the `request_video` function, initiating the AI API stitching process for the BattleClip video NFT. 2D renderings of all possible attacks, defense and actions are stored off-chain on IPFS and accessed via CID hashes. A call is made for the 21 images needed to represent this finalized Battle. The 21 images (10 of each character plus the Environ) are sent to the video AI API; leveraging an off-chain oracle (e.g., Chainlink) -via a secure RPC endpoint, initiating the generation of a 10-second stitched BattleClip video.

The off-chain AI account is a prepaid custodial account managed by the Battle Code project, ensuring seamless API invocation. Concurrently, the smart contract executes an internal *FCODE* token deduction from the winner’s purse to the Battle Code treasury account, optimizing on-chain and off-chain flow within the Program’s instruction set.

Prior to an ELITE Challenge being posted or accepted a “Notice” of the BattleCLip NFT fee is displayed. Fees at today’s/ market rates may be $usd .10 – .30 cents to render and mint the BattleClip NFT.

BattleClip NFTs open market

The BattleClip video NFT is implemented as a child NFT, linked to the (FC) NFT via Metaplex’s hierarchical metadata structure on Solana, utilizing a custom Program to establish the parent-child relationship within the SPL Token framework.

This child NFT can be detached and independently sold by the owner through a dedicated ‘detach_child_nft instruction, enabling open market via Magic Eden etc.

NFT sales and trading for the BC NFT / & the BattleClip NFTs
AI video API integration mints Battle NFT for mint fee

[ Tokenomics ]

100M Token Supply

The FCODE utility token, integrated within the Solana Program, facilitates seamless on-chain operations by enabling an internal conversion to SOL for minting and gas fees; adding an additional 5% onto the gas fees, for the Battle Code treasury account.

TGE – Token generation event for a full 60% released and unlocked; at a low enough MC $5-10M that the incentive to stake and build with the project ensues.

Home

Overview; Code Logic

Battle Code Architecture & Logic

The Battle Code smart contract, deployed as a Solana Program, orchestrates the 1v1 NFT battle adjudication with cyclic logic: “rock-paper-scissors” as a loose analogy. This Solana-native implementation leverages Anchor framework for account management, ensuring gas-efficient execution and scalability for 1,000+ simultaneous users via Helius RPC nodes.

A user initiates a Challenge by invoking the ‘post_challenge instruction within the Battle Code Program. If a BCODE wager is involved the ‘post_wager instruction is called and if Challenge accepted both Users see a request to invoke ‘post_escrow instruction.

Scoring the Battle

Small Chance Element

Battle Video NFT

Battle Clips | AI Video NFT

An ELITE Battle triggers the `request_video` function, initiating the AI API stitching process for the BattleClip video NFT. 2D renderings of all possible attacks, defense and actions are stored off-chain on IPFS and accessed via CID hashes. A call is made for the 21 images needed to represent this finalized Battle. The 21 images (10 of each character plus the Environ) are sent to the video AI API; leveraging an off-chain oracle (e.g., Chainlink) -via a secure RPC endpoint, initiating the generation of a 10-second stitched BattleClip video.

The off-chain AI account is a prepaid custodial account managed by the Battle Code project, ensuring seamless API invocation. Concurrently, the smart contract executes an internal *BCODE* token deduction from the winner’s purse to the Battle Code treasury account, optimizing on-chain and off-chain flow within the Program’s instruction set.

Prior to an ELITE Challenge being posted or accepted a “Notice” of the BattleCLip NFT fee is displayed. Fees at today’s/ market rates may be $usd .10 – .30 cents to render and mint the BattleClip NFT.

The BattleClip video NFT is implemented as a child NFT, linked to the (BC) NFT via Metaplex’s hierarchical metadata structure on Solana, utilizing a custom Program to establish the parent-child relationship within the SPL Token framework.

This child NFT can be detached and independently sold by the owner through a dedicated ‘detach_child_nft instruction, enabling open market via Magic Eden etc.

BCODE Token

100M Token Supply

The BCODE utility token, integrated within the Solana Program, facilitates seamless on-chain operations by enabling an internal conversion to SOL for minting and gas fees; adding an additional 5% onto the gas fees, for the Battle Code treasury account.

TGE – Token generation event for a full 60% released and unlocked; at a low enough MC $5-10M that the incentive to stake and build with the project ensues.

White Paper