Shop & Economy API

NPC Merchants

Each zone has merchants selling different tiers of gear.

Zone	NPC	Inventory
human-meadow	Grimwald the Trader	Starter gear — potions, iron weapons, leather armor
human-meadow	Bron the Blacksmith	Advanced gear — steel weapons, chainmail, shields

GET /shop/npc/:zoneId/:entityId

Returns the NPC’s item catalog with prices, stats, and descriptions.

POST /shop/buy
{
  "walletAddress": "0x...",
  "npcEntityId": "npc_grimwald",
  "tokenId": 2,
  "zoneId": "human-meadow"
}

Server validates gold balance, deducts gold, and mints the item NFT (ERC-1155) to the buyer’s wallet.

GET /wallet/:walletAddress/balance

POST /wallet/register
{ "address": "0x..." }

Grants a welcome bonus of gold to new players.

Item	Token	Price	Stats	Durability
Iron Sword	2	100g	+8 STR	60
Steel Longsword	3	250g	+14 STR	80
Hunter’s Bow	4	150g	+4 STR, +6 AGI	70
Battle Axe	5	400g	+18 STR, -1 AGI	95
Apprentice Staff	6	200g	+12 INT, +3 FAITH	65
Oak Shield	7	80g	+6 DEF	85

Reinforced (+25% stats):

Item	Price	Stats
Reinforced Iron Sword	180g	+10 STR
Reinforced Steel Longsword	400g	+18 STR
Reinforced Hunter’s Bow	250g	+5 STR, +8 AGI
Reinforced Battle Axe	600g	+23 STR
Reinforced Apprentice Staff	350g	+15 INT, +4 FAITH

Masterwork (+50% stats):

Item	Price	Stats
Masterwork Iron Sword	300g	+12 STR
Masterwork Steel Longsword	650g	+21 STR
Masterwork Battle Axe	950g	+27 STR
Masterwork Apprentice Staff	550g	+18 INT, +5 FAITH

Slot	Item	Price	Stats
Chest	Leather Vest	60g	+4 DEF, +4 HP
Chest	Chainmail Shirt	300g	+10 DEF, +12 HP
Helm	Iron Helm	45g	+3 DEF, +3 HP
Legs	Leather Leggings	55g	+2 DEF, +1 AGI
Legs	Iron Greaves	130g	+5 DEF, +6 HP
Boots	Traveler Boots	50g	+1 DEF, +2 AGI
Boots	Steel Sabatons	110g	+3 DEF, +1 AGI
Gloves	Padded Gloves	40g	+1 STR, +1 DEF
Gloves	Knight Gauntlets	150g	+2 STR, +3 DEF
Belt	Guard Belt	60g	+2 DEF, +4 HP
Belt	War Belt	140g	+4 DEF, +8 HP
Shoulders	Bronze Shoulders	70g	+3 DEF
Shoulders	Steel Pauldrons	165g	+5 DEF, +4 HP

Tanned Set — Agility-focused:

Slot	Item	Price	Stats
Chest	Tanned Leather Vest	80g	+5 DEF, +3 AGI, +5 HP
Legs	Tanned Leather Leggings	65g	+3 DEF, +2 AGI
Boots	Tanned Leather Boots	55g	+2 DEF, +3 AGI
Helm	Tanned Leather Helm	50g	+3 DEF, +1 AGI
Shoulders	Tanned Leather Shoulders	55g	+3 DEF, +1 AGI
Gloves	Tanned Leather Gloves	45g	+1 DEF, +2 AGI
Belt	Tanned Leather Belt	45g	+2 DEF, +3 HP

Reinforced Hide Set — Heavy-duty:

Slot	Item	Price	Stats
Chest	Reinforced Hide Vest	160g	+8 DEF, +4 AGI, +8 HP
Legs	Reinforced Hide Leggings	130g	+6 DEF, +3 AGI, +4 HP
Boots	Reinforced Hide Boots	110g	+4 DEF, +4 AGI
Helm	Reinforced Hide Helm	100g	+5 DEF, +2 AGI, +3 HP
Shoulders	Reinforced Hide Shoulders	120g	+6 DEF, +2 AGI
Gloves	Reinforced Hide Gloves	90g	+3 DEF, +3 AGI, +1 STR
Belt	Reinforced Hide Belt	95g	+4 DEF, +6 HP

Item	Slot	Price	Stats
Ruby Ring	Ring	120g	+4 STR, +6 HP
Sapphire Ring	Ring	120g	+4 INT, +6 MP
Emerald Ring	Ring	130g	+3 AGI, +2 LUCK, +4 HP
Diamond Amulet	Amulet	200g	+5 DEF, +8 HP, +3 FAITH
Shadow Opal Amulet	Amulet	220g	+4 STR, +3 AGI, +2 LUCK
Arcane Crystal Amulet	Amulet	280g	+6 INT, +8 MP, +3 FAITH

8 professions to gather resources and craft items.

POST /professions/learn
{ "walletAddress": "0x...", "profession": "mining" }

GET /wallet/:walletAddress/professions

Profession	Cost	Tools (Tier 1-4)	Resources
Mining	50g	Stone/Iron/Steel/Mithril Pickaxe (30-500g)	Coal, Tin, Copper, Silver, Gold Ore
Herbalism	50g	Basic/Iron/Steel/Enchanted Sickle (25-450g)	Dandelion, Lily, Rose, Lavender, Sage, Moonflower, Starbloom, Dragon’s Breath
Skinning	50g	Rusty/Iron/Steel/Master Knife (25-450g)	Scrap/Light/Medium/Heavy Leather, Pelts, Silk, Bones, Hides

Profession	Cost	Inputs	Outputs
Blacksmithing	100g	Ores, Bars	Weapons, armor, weapon upgrades (Reinforced/Masterwork)
Alchemy	75g	Herbs, Flowers	Potions, elixirs, enchantment elixirs
Cooking	40g	Raw Meat, ingredients	Cooked food (HP restoration)
Leatherworking	75g	Leather, Hides, Pelts	Tanned and Reinforced leather armor sets
Jewelcrafting	100g	Gems (Ruby, Sapphire, Emerald, Diamond, Opal, Crystal)	Rings and amulets