@kashscript/trade

High-level wrappers around the Kash-Trade Suite + Trust-Score logic. A thin TypeScript layer over @kashscript/trade-sdk for the common cases.

⚠ Commercial package (SSLA Schedule B). Production use requires an active paid Plan on the Kash-Registry. See LICENSE.

bun add @kashscript/trade @kashscript/identity-core

What this package vs. trade-sdk

| Package | When to reach for it | |---------------------------|------------------------------------------------------------| | @kashscript/trade | App code: "I want to publish a trade record, score a counterparty, or check trust." High-level functions, sensible defaults. | | @kashscript/trade-sdk | Contracts + low-level kernel: hydration, EIP-712 signals, custom paradigm parameters, direct contract calls. Use when you need fine control. |

Most apps use @kashscript/trade for everyday flows and reach into @kashscript/trade-sdk only when they need a knob the wrapper hasn't exposed yet.

Quickstart

import { publishTradeRecord, computeTrustScore } from "@kashscript/trade";

// Publish a kash.trade.* record using the FSM kernel
await publishTradeRecord({
  type: "OTDC",
  consumer: "did:kash:alice",
  provider: "did:kash:bob",
  total: 10_000_000n,
  // ...rest of the manifest
});

// Compute a trust score for a counterparty based on their history
const score = await computeTrustScore("did:kash:bob");
console.log(score);   // { score: 87, samples: 14, lastUpdated: ... }

What's in the box

| Subpath | Purpose | |----------------------------------------|-----------------------------------------| | @kashscript/trade | Default — re-exports the high-level API | | @kashscript/trade/contracts | Address registry per chain | | @kashscript/trade/trust-score | Bayesian counterparty trust scoring | | @kashscript/trade/kernel | Re-exports the FSM kernel from trade-sdk | | @kashscript/trade/kernel/fsm | Master state machine — 13 transitions | | @kashscript/trade/kernel/splitter | BPS recipient splitter logic | | @kashscript/trade/kernel/manifest | Manifest validators | | @kashscript/trade/kernel/types | TypeScript types for every paradigm | | @kashscript/trade/kernel/errors | Typed error classes |

Licensing

This is a Schedule B Commercial Package under the KashScript Sovereign Software License Agreement v1.0.

| Use | Plan required | |-----------------------------|-------------------------| | Local development / eval | free (no Plan needed) | | 14-day production trial | trial | | Production (any user-facing)| paid / team / enterprise |

Run kash login from @kashscript/kstack once installed to obtain an Access Token. The package will function on free for development but will refuse to operate in Production Use mode without a covering Plan.

See LICENSE for the full terms.