Module sdk 

Instruction builders for client SDK. Builds Instruction with correct accounts and data.

Functions

buy_bundle

Buy bundle: 150 recruitment tickets for 5 SOL (event deal).

buy_flash_sale

Flash sale: 50 tickets for 5000 shards, max 5 per day.

buy_scene

Buy scene 6, 7, or 8 with Amethyst. Unlocks entire scene (all 12 sections).

buy_scene_dojo

Buy scene (6/7/8) with mixed payment: spend all amethyst, cover shortfall with DOJO.

buy_starter_pack

Buy Starter Pack (initialize player Dojo). Optional referrer. Creates 1 starter shogun (assigned to barracks slot 0) + 1 recruitment ticket.

buy_tickets_with_shards

Daily deal: 5 tickets for 300 shards. Burns shards.

claim_collection_reward

Claim collection reward (3 ninjas same element+rarity). Pass collection_index (element×5 + rarity, 0–24). Program finds 3 matching shoguns in pool.

claim_daily_reward

Claim daily reward (1 ticket per day, stacks if not claimed). Backend signature required. Transaction must include ed25519_verify_instruction_for_daily_claim as the preceding instruction.

claim_dine_reward

Claim next dine-tier reward.

claim_forge_reward

Claim next forge-tier reward.

claim_recruit_reward

Claim next recruit-tier reward.

claim_referral_reward

Claim referral reward (SOL).

claim_shards

Claim shards as $DOJO token. Hyper Ninja–aligned: computes ore from shoguns, adds to shards, mints. Amount computed entirely on-chain; no client input (security).

clear_forge_cooldown

Clear forge upgrade cooldown. Cost = remaining minutes (shards). One tx clears all.

dine

Dine. Tier: 0=24h, 1=48h, 2=72h. Burns shards. Restores chakra for seated shogun.

ed25519_verify_instruction_for_daily_claim

Ed25519 verify instruction for daily claim. Must be prepended before claim_daily_reward. Client builds the same message as the server signs: prefix + dojo_pda + task_id.

initialize

Initialize Config, Game, and Treasury. Admin only.

level_up_shogun

Level up: spend shards, +10% SP per level. Burns shards.

log

Log (CPI from program; config signs). Variable-length message.

merge_shogun

Merge: consume from fodder_counts. merge_type: 0=10×N→1R, 1=5×R→1SR, 2=3×SR→1SSR. seed: from BSM POST /seed.

prestige_upgrade

Prestige: consume 2 from fodder_counts[rarity], upgrade seated shogun in slot. SSR/UR only.

recruit_shogun_sol

Recruit shogun(s) — pay with SOL. Adds to fodder_counts. seed: from BSM POST /seed.

recruit_shogun_tickets

Recruit shogun(s) — pay with recruitment tickets. Adds to fodder_counts. seed: from BSM POST /seed.

replace_shogun

Replace: return old to fodder, promote new from fodder. Same slot.

roll_scene_section_amethyst

Roll scene sections (1 or 10) — pay with Amethyst. seed: from BSM POST /roll/instruction (Option 7 centralized oracle).

roll_scene_section_shards

Roll scene sections (1 or 10) — pay with Shards (SPL $DOJO). seed: from BSM POST /roll/instruction (Option 7 centralized oracle).

salvage_scene_section

Salvage all duplicate scene sections for Amethyst refund. Program derives from on-chain state.

seat_shogun

Seat: promote one from fodder to barracks slot. rarity 0-4, element 0-4.

seat_shogun_fill_all

Seat multiple shoguns from fodder into empty slots. Slots inferred.

set_genesis_slot

Set genesis slot and game.last_emission_slot (admin). halving_period_slots: 0 = use default (~58 days, matches Hyper Ninja).

upgrade_barracks_shards

Upgrade barracks (Ninja Hut) level. Pay with shards. 1→2, 2→3, 3→4. Burns shards.

upgrade_barracks_sol

Upgrade barracks (Ninja Hut) level. Pay with SOL. 1→2, 2→3 only (3→4 shards only).

upgrade_forge

Upgrade forge level. Pay SOL (1–7, max level 7).