TypeScript SDK

pnpm add @axk/sdk

1import { Kernel } from '@axk/sdk'
2
3const kernel = new Kernel({
4  network: 'mainnet',
5  role:    'liquidity',
6  attest:  process.env.AXK_ATTESTATION_KEY,
7})
8
9await kernel.connect()        // returns a connected handle
10await kernel.disconnect()     // graceful shutdown

1// typed subscription — payload narrows by schema
2kernel.on('STATE_VERIFIED', (event) => {
3  if (event.schema === 'trade.delivery.v1') {
4    // event.payload is now TradeDeliveryV1
5  }
6  if (event.schema === 'carbon.retire.v2') {
7    // event.payload is now CarbonRetireV2
8  }
9})
10
11// or filter on subscription
12kernel.subscribe({
13  schema:  ['trade.delivery.v1', 'settle.payout.v1'],
14  region:  ['rw', 'ug', 'ke'],
15})

1const tx = await kernel.settle({
2  tx:        event.proof.hash,
3  verifier:  event.attest.id,
4  amount:    event.payload.usd,
5  currency:  'USDC',
6  recipient: 'rUv3...',
7})
8
9// tx.id          — XRPL transaction id (publicly verifiable)
10// tx.elapsed     — wall-clock ms from call to finality
11// tx.proof.hash  — kernel proof hash (same family as event.proof.hash)

1await kernel.attest({
2  schema:   'trade.delivery.v1',
3  payload:  { id: 'RW-004421', cooperative: 'Nyamasheke', kg: 2400 },
4  verifier: { id: 'RISA·trade', standard: 'ISO/IEC 17025' },
5})

1import type {
2  Kernel,
3  KernelEvent,
4  TradeDeliveryV1,
5  CarbonRetireV2,
6  SettlePayoutV1,
7  InsureClaimV1,
8} from '@axk/sdk'
9
10// strict union — payload is always narrowed by schema
11type Handler = (e: KernelEvent) => void