@wowok/wowok

WoWok Blockchain TypeScript API — the core SDK for building on WoWok.

npm install @wowok/wowok

Overview

@wowok/wowok is the programmatic SDK for the WoWok blockchain. It provides a complete TypeScript API for on-chain operations, cryptography, transaction building, and off-chain utilities — used by the MCP server and any application that needs to interact with the WoWok network directly.

Key Modules

| Module | Entry | Description | |--------|-------|-------------| | Client | @wowok/wowok/client | Multi-transport client (gRPC, GraphQL, JSON-RPC) | | BCS | @wowok/wowok/bcs | Binary Canonical Serialization | | Cryptography | @wowok/wowok/cryptography | Core crypto primitives | | Keypairs | @wowok/wowok/keypairs/ed25519 | Ed25519 keypair | | | @wowok/wowok/keypairs/secp256k1 | Secp256k1 keypair | | | @wowok/wowok/keypairs/secp256r1 | Secp256r1 keypair | | | @wowok/wowok/keypairs/falcon512 | Post-quantum Falcon-512 keypair | | | @wowok/wowok/keypairs/passkey | WebAuthn passkey support | | Transactions | @wowok/wowok/transactions | Transaction building and signing | | Multi-signature | @wowok/wowok/multisig | Multi-sig account management | | Verification | @wowok/wowok/verify | Signature and data verification | | Utils | @wowok/wowok/utils | General utilities | | WoWok W Layer | @wowok/wowok/w | High-level WoWok operations (call, query, local, messenger) |

WoWok W Layer

The w/ namespace provides high-level abstractions tailored for WoWok protocol operations:

| Sub-module | Purpose | |------------|---------| | w/call | On-chain operations: Guard, Service, Machine, Order, Progress, Arbitration, Treasury, Reward, Allocation, Permission, Contact, Demand, Payment, Passport, Repository | | w/query | On-chain data query helpers | | w/local | Local operations: account management, config, cache, WTS, WIP, secure storage | | w/messenger | End-to-end encrypted messaging with post-quantum crypto | | w/common | Shared types and constants |

Quick Start

import { WoWokClient } from '@wowok/wowok/client';
import { Ed25519Keypair } from '@wowok/wowok/keypairs/ed25519';

const client = new WoWokClient({ url: 'https://testnet.wowok.net' });
const keypair = Ed25519Keypair.generate();

For AI Assistants

This SDK powers the WoWok MCP server, which allows AI assistants to interact with the blockchain through natural language. For the best AI experience, install both:

• MCP Server: @wowok/agent-mcp — configure in your AI client's MCP settings
• Skills: npm install -g @wowok/skills — structured AI guidance for using WoWok tools correctly

WoWok Skills provide structured guidance that significantly reduces the learning curve of the MCP server. They help AI assistants understand tool constraints, safety protocols, and build order — reducing errors and speeding up development.

Key benefits:

• Structured guidance — AI understands complex workflows without trial and error
• Role-specific — Provider, Customer, Arbitrator, and Shared skill sets loaded contextually
• Auto MCP setup — Skills package auto-installs and configures the @wowok/agent-mcp server

Supported clients: Claude Code, OpenAI Codex, ChatGPT Desktop (Codex Mode), Trae IDE, CodeBuddy, Cursor, Windsurf, Qoder, Roo Code, GitHub Copilot.

Related Links

• MCP Server: https://www.npmjs.com/package/@wowok/agent-mcp
• MCP Source: https://github.com/wowok-ai/agent
• AI Skills: https://github.com/wowok-ai/skills
• Docs: https://github.com/wowok-ai/docs
• X: https://x.com/Wowok_Ai