Bushido Passport -- Universal Gamer Identity

Bushido Passport is a universal gamer identity protocol native to the Vexidus blockchain. Players carry a provable, portable identity -- including achievements, skill ratings, reputation, and portable items -- across any game or platform that integrates the SDK.

Why Bushido Passport?

For gamers:

• One identity across all games -- your rank, achievements, and items follow you
• Soulbound achievement NFTs that prove what you've earned (no buying achievements)
• Quantum-resistant: your identity is still yours in 2040

For game developers:

• One-call SDK integration: bp.attest() handles everything
• No need to build your own identity system
• Players arrive with a pre-built reputation -- instant personalization
• Earn royalties on portable item resales

Core Concepts

Passport Account

Every wallet can create one Bushido Passport -- an on-chain identity with:

• Samurai Name -- unique display name across all games
• Mon -- profile image/crest
• Skill Ratings -- four ELO-style ratings that evolve across games
• Samurai Rank -- calculated from skill averages
• Achievements -- soulbound VSC-21 NFTs from specific games
• Items -- portable game assets with configurable tradability
• Honor Points -- lifetime achievement score

Skill System

Four skill categories (baseline 1000, max 5000):

Category	What It Measures
Combat Prowess	Action, PvP, reflexes
Strategic Wisdom	Planning, puzzle-solving, tactics
Social Honor	Teamwork, community contribution
Exploration Spirit	Discovery, completionism

Games submit skill deltas via attestations. Your rank evolves automatically:

Rank	Skill Average	Japanese
Ashigaru	< 1200	足軽
Gokenin	1200+	御家人
Hatamoto	1400+	旗本
Daimyo	1700+	大名
Shogun	2000+	将軍

Achievements (Soulbound NFTs)

Games mint achievements as VSC-21 soulbound tokens. Each achievement records:

• Which game awarded it
• What type of achievement
• Skill impact (how much each rating changed)
• Rarity (what percentage of players earned it)
• Timestamp

Achievements are non-transferable -- you can't buy someone else's Dragon Slayer badge.

Portable Items

Games can mint items to player passports with configurable portability:

Level	Can Port to Other Games	Can Sell on Marketplace
Locked	No	No
Portable	Yes	No
Tradeable	Yes	Yes (game earns royalty)
Unrestricted	Yes	Yes (no royalty)

Games earn 0-15% royalty on every resale of items they created.

SDK Integration

For Game Developers (Node.js)

import { BushidoPassport } from '@bushido-passport/sdk'

const bp = new BushidoPassport({
  rpcUrl: 'https://rpc.vexidus.io',
  gameId: 'your_game',
  gameWallet: gameKeypair,
})

// Award achievement + update skills -- ONE call
await bp.attest(playerWallet, {
  type: 'dragon_slayer',
  name: 'Dragon Slayer',
  combat: +150,
  wisdom: +50,
})

For Any Game Engine (REST)

curl -X POST https://rpc.vexidus.io \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "vex_submitAttestation",
    "params": ["<game_wallet>", "<player>", "your_game",
               "dragon_slayer", "Dragon Slayer", null, null,
               150, 50, 0, 0],
    "id": 1
  }'

Works from Unity, Unreal, Godot -- any engine that can make HTTP requests.

Read Player Data

import { BushidoPassportReader } from '@bushido-passport/sdk'

const reader = new BushidoPassportReader('https://rpc.vexidus.io')
const passport = await reader.getPassport(walletAddress)
const achievements = await reader.getAchievements(walletAddress)
const items = await reader.getItems(walletAddress)

Quantum-Resistant Identity

Vexidus uses Ed25519 + Dilithium3 (CRYSTALS) hybrid signatures. Every Bushido Passport is signed with keys that survive quantum computing.

When quantum computers break ECDSA (Ethereum, Solana, every other chain), Vexidus passports remain cryptographically valid. Your rank is still yours in 2040.

Operations

Disc	Operation	Description
71	CreatePassport	Create passport with samurai name + mon
72	UpdatePassportProfile	Change name or mon
73	TransferPassport	Wallet migration / recovery
74-77	Game Registry	Register, update, deactivate, verify games
78	SubmitAttestation	Award achievement + update skills (one call)
79	SetClanMembership	On-chain clan proof
80-82	Admin	Freeze, unfreeze, revoke achievement
83-86	Items	Mint, transfer, update portability, burn
87-89	Marketplace	List, buy, cancel

RPC Methods

vex_getPassport(address)              -- Full passport data
vex_getPassportByName(name)           -- Lookup by samurai name
vex_getAchievements(address, game?)   -- Achievement NFTs
vex_getItems(address, game?)          -- Portable items
vex_getGameInfo(gameId)               -- Game details
vex_getMarketplaceListings(game?)     -- Active item listings
vex_getPassportStats()                -- Network-wide stats

Transaction Cost

~$0.0003 per attestation. Games can award thousands of achievements per day without meaningful cost. This makes the system viable for indie developers, not just large studios.