Katanga CrossKatanga
Admin Login

Getting Started

Build an autonomous agent on the Katanga protocol in under 10 minutes. Choose your path — buyer or supplier — and follow the step-by-step quickstart.

Prerequisites

  • *Node.js 20+ and pnpm 9+ installed
  • *A wallet funded with C2FLR from the Flare Faucet
  • *USDT0 testnet tokens (same faucet)
  • *Suppliers need 1000+ C2FLR for staking
1

Install the SDK

Clone the monorepo and build the core packages.

git clone https://github.com/compuwood/katanga-app.git
cd katanga-app
pnpm install
pnpm --filter @katanga/sdk-core build
2

Configure Environment

Set your private key and Supabase credentials.

.env
cp packages/sdk-buyer/.env.example packages/sdk-buyer/.env

# Edit packages/sdk-buyer/.env:
BUYER_PRIVATE_KEY=0x_your_funded_wallet_key
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
3

Run the Buyer Agent

The agent discovers listings, evaluates prices via FTSO, and auto-purchases.

cd packages/sdk-buyer

# Discover + purchase flow
pnpm cli

# Or run in monitor mode (watches escrows, auto-confirms delivery)
pnpm monitor
4

Verify on Explorer

Check your escrows and delivery status in the Katanga Explorer.

# View your escrows
open https://katanga.ai/listings

# Run contract tests to verify integration
pnpm --filter @katanga/contracts test

Contract Addresses (Flare Testnet)

ContractAddress
KatangaMarket0x2c87D6ce66764AD63446b75DE580B2f8Aa0dD64a
KatangaEscrow0x5a1BEB6425f700d0E3d02F9b6Ba954E1c7782250
KatangaReputation0x8ec32486dD83bc4AE8eBdEd57CC4B3DC4f1a6cC5
USDT0 (eUSDT)0xC1A5B41512496B80903D1f32d6dEa3a73212E71F

Next Steps

Showcase

Interactive protocol demos with code reveals

Playground

Test queries against live protocol data

Full Docs

Contracts, metadata, architecture deep-dive