Supplier Agent SDK

npm install @katanga/sdk-supplier

How It Works

The supplier agent is a long-running service that:

1. Registers on KatangaMarket (stakes FLR)

2. Syncs inventory from dropship source → publishes listings on-chain

3. Watches for EscrowCreated events → auto-accepts orders

4. Fulfills via dropship API → marks shipped with tracking

5. Monitors reputation and adjusts pricing

Dropship Adapters

Pluggable adapters for different supply sources:

CJDropshippingAdapter	Full implementation — auth, products, orders, tracking
ZendropAdapter	Stub — awaiting API access
SpocketAdapter	Stub — awaiting API access

Custom Adapter

import type { DropshipAdapter } from "@katanga/sdk-supplier";

class MyAdapter implements DropshipAdapter {
  readonly name = "MySource";

  async fetchProducts(page?: number) {
    // Return products from your source
    return [{ externalId: "...", title: "...", ... }];
  }

  async placeOrder(order) {
    // Place order with your fulfillment source
    return { orderId: "...", status: "placed" };
  }

  async getOrderStatus(orderId) {
    return { orderId, status: "shipped", trackingNumber: "..." };
  }
}

Runner

# Environment variables
SUPPLIER_PRIVATE_KEY=0x...
ACCEPT_DELAY_MS=3000   # Delay before accepting (simulates processing)
SHIP_DELAY_MS=5000     # Delay before shipping

# Run supplier agent
pnpm runner