@pokeforge/sdk

Sleek, developer-focused client SDK for status mutations, XP scaling, and battle simulation within custom, decentralized creature networks. Designed for Solana Web3 game integrations.

Installation

Add the official TypeScript SDK bundle to your project:

npm install @pokeforge/sdk

Quickstart

Initialize the PokeForgeSDK client instance by specifying the cluster endpoints and supplying a transaction signing wallet adapter:

import { Connection, Keypair } from "@solana/web3.js";
import { PokeForgeSDK } from "@pokeforge/sdk";

// 1. Establish node connection
const connection = new Connection("https://api.mainnet-beta.solana.com");
const trainerKey = Keypair.fromSecretKey(/* private_key_uint8_array */);

// 2. Instantiate wrapper client
const pokeforge = new PokeForgeSDK({
  cluster: "mainnet-beta",
  connection,
  wallet: trainerKey,
});

console.log("POKEFORGE SDK successfully active.");

Key Modules & Methods

1. Update On-Chain Stats

Mutate creature attributes, modify experience scores, increment battle counts, or update evolution stages in single transactions:

await pokeforge.updateStats({
  creatureId: "voltora-001",
  xp: 245,
  level: 10,
  wins: 5,
  evolutionStage: 2,
});

2. Simulate Round-Based Battles

Execute standard round-by-round combat algorithms using PokeAPI stats and element type matchup metrics locally:

const result = await pokeforge.simulateBattle({
  attackerId: "pikachu-025",
  defenderId: "charizard-006",
  attackerHp: 120,
  defenderHp: 180,
});

console.log(`Battle completed! Winner ID: ${result.winnerId}`);

3. Trigger Creature Evolution

Query PokeAPI evolution paths dynamically and update creature status states upon gate clearance:

const evolution = await pokeforge.evolveCreature({
  creatureId: "pikachu-025",
  currentXp: 300,
});

if (evolution.success) {
  console.log(`Evolved into: ${evolution.nextFormName}`);
}

License

MIT License. Distributed "as is" under standard open source copyright agreements.