@flyingwhale/receipt

FW-001 Execution Receipt Standard — Open standard for Bitcoin-native AI agent execution proofs on Stacks.

Generate freely. Verify only here.

What is FW-001?

FW-001 defines a standard execution receipt format for Bitcoin-native AI agents operating on Stacks. Any agent or tool can generate FW-001 receipts freely. Verification — the act of proving a receipt is legitimate — is centralized at Flying Whale and requires querying the on-chain trust graph.

On-chain IP: SP322ZK4VXT3KGDT9YQANN9R28SCT02MZ97Y24BRW.whale-ip-store-v1

Install

npm install @flyingwhale/receipt

Usage

Generate a Receipt (Free — No API Key)

import { createReceipt } from '@flyingwhale/receipt';

const receipt = createReceipt({
  executor:  'SP322ZK4VXT3KGDT9YQANN9R28SCT02MZ97Y24BRW',
  action:    'jingswap_v2_deposit_stx',
  txid:      'abc123def456...',
  block:     7500000,
});

// receipt.hash proves integrity
// receipt.standard === "FW-001"
console.log(receipt.hash);  // SHA-256 of canonical fields

Verify a Receipt (Requires Network)

import { verifyReceipt } from '@flyingwhale/receipt';

const result = await verifyReceipt(receipt);

if (result.fw_verified) {
  console.log(`✅ Verified. Score: ${result.score} | Tier: ${result.tier}`);
} else {
  console.log('❌ Unverified — Higher Risk');
}

Get Trust Score

import { getScore } from '@flyingwhale/receipt';

const { score, tier, allocation_pct } = await getScore('SP322...');
// score: 485 | tier: "Council" | allocation_pct: 100

Format for Display

import { formatReceipt } from '@flyingwhale/receipt';

console.log(formatReceipt(receipt));
// ╔══════════════════════════════════════════
// ║  FW-001 Execution Receipt
// ║  Flying Whale · zaghmout.btc · ERC-8004 #54
// ╠══════════════════════════════════════════
// ║  Executor : SP322ZK4VXT3KGDT9YQANN9R28SCT02MZ97Y24BRW
// ║  Action   : jingswap_v2_deposit_stx
// ║  TX       : abc123def456...
// ║  Block    : 7500000
// ║  Hash     : 5921c4a08aed4a71...
// ╚══════════════════════════════════════════

Receipt Format

interface FW001Receipt {
  standard:   "FW-001";   // Always this literal
  version:    "1.0";      // Format version
  executor:   string;     // ERC-8004:{id} or Stacks address
  action:     string;     // Tool name or function called
  txid:       string;     // Stacks transaction ID
  block:      number;     // Block height at execution
  timestamp:  string;     // ISO 8601
  hash:       string;     // SHA-256 of canonical fields
  signature?: string;     // SIP-018 (optional)
  route?:     string;     // Routing path (optional)
}

Canonical Hash

SHA-256("FW-001:{executor}:{action}:{txid}:{block}:{timestamp}")

Trust Score → Capital Tier

| Tier | Score | Allocation | Fee | |------|-------|-----------|-----| | Council | ≥ 485 | 100% | 0.10% | | Elite | ≥ 300 | 90% | 0.15% | | Agent | ≥ 100 | 70% | 0.25% | | Scout | ≥ 10 | 40% | 0.50% | | Unverified | 0 | 0% | — |

Verification API

Base URL: https://flying-whale-marketplace-production.up.railway.app

| Endpoint | Description | |----------|-------------| | GET /api/fw | Standard info | | GET /api/fw/score/:address | Trust score | | GET /api/fw/verify/:txid | TX verification + receipt | | GET /api/capital/tier | Full tier map | | GET /api/capital/route/:address | Execution suggestion |

License

MIT — COPYRIGHT 2026 Flying Whale — zaghmout.btc | ERC-8004 #54

Open standard. Free to implement. Verification centralized at Flying Whale.