@toon-protocol/sdk 1.0.0 → 2.0.0

package/dist/index.d.ts

@@ -4,8 +4,8 @@ import { NostrEvent, UnsignedEvent } from 'nostr-tools/pure';
 import { ToonRoutingMeta } from '@toon-protocol/core/toon';
 import { TransportConfig } from '@toon-protocol/connector';
 export { TransportConfig } from '@toon-protocol/connector';
-import { A as AccumulatedClaim } from './swap-D4Ozr_BM.js';
-export { D as DecryptFulfillClaimParams, E as EncryptFulfillClaimParams, a as EncryptFulfillClaimResult, P as PacketProgress, R as RateMonitorCallback, S as StreamSwapController, b as StreamSwapParams, c as StreamSwapResult, U as UnwrapSwapPacketFromToonParams, d as UnwrapSwapPacketParams, e as UnwrapSwapPacketResult, W as WrapSwapPacketParams, f as WrapSwapPacketResult, g as WrapSwapPacketToToonParams, h as WrapSwapPacketToToonResult, _ as __streamSwapTesting, i as decryptFulfillClaim, j as encryptFulfillClaim, s as streamSwap, k as streamSwapControlled, u as unwrapSwapPacket, l as unwrapSwapPacketFromToon, w as wrapSwapPacket, m as wrapSwapPacketToToon } from './swap-D4Ozr_BM.js';
+import { A as AccumulatedClaim } from './swap-DF4ghKio.js';
+export { D as DecryptFulfillClaimParams, E as EncryptFulfillClaimParams, a as EncryptFulfillClaimResult, P as PacketProgress, R as RateMonitorCallback, S as StreamSwapController, b as StreamSwapParams, c as StreamSwapResult, U as UnwrapSwapPacketFromToonParams, d as UnwrapSwapPacketParams, e as UnwrapSwapPacketResult, W as WrapSwapPacketParams, f as WrapSwapPacketResult, g as WrapSwapPacketToToonParams, h as WrapSwapPacketToToonResult, _ as __streamSwapTesting, i as decryptFulfillClaim, j as encryptFulfillClaim, s as streamSwap, k as streamSwapControlled, u as unwrapSwapPacket, l as unwrapSwapPacketFromToon, w as wrapSwapPacket, m as wrapSwapPacketToToon } from './swap-DF4ghKio.js';
 
 /**
  * Unified identity module for @toon-protocol/sdk.
@@ -173,7 +173,7 @@ declare class GiftWrapError extends ToonError {
     constructor(message: string, cause?: Error);
 }
 /**
- * Error thrown when Mill swap handler orchestration fails.
+ * Error thrown when swap handler orchestration fails.
  * Used for rate-conversion errors (invalid format, zero, overflow guards),
  * unsupported pair lookups, and issuer-boundary failures that are NOT
  * gift-wrap-specific. Gift-wrap failures continue to surface as `GiftWrapError`.
@@ -187,7 +187,7 @@ declare class SwapHandlerError extends ToonError {
  * All failures are categorized by a narrow `code` so callers can branch on
  * cause. `INVALID_*` codes are construction-time validation failures (thrown
  * synchronously before any packet fires). `FULFILL_DECODE_FAILED` surfaces
- * when the Mill returns `accepted: true` but the FULFILL data cannot be
+ * when the Swap returns `accepted: true` but the FULFILL data cannot be
  * decoded — this is a non-fatal per-packet error and is captured in
  * `StreamSwapResult.errors[]`.
  */
@@ -214,7 +214,7 @@ declare class StreamSwapError extends Error {
  * @stable — Epic 13 Chain Bridge DVM depends on this error shape.
  */
 declare class SettlementTxError extends Error {
-    readonly code: 'INVALID_INPUT' | 'MISSING_SETTLEMENT_METADATA' | 'UNSUPPORTED_CHAIN' | 'MISSING_RECIPIENT' | 'RECIPIENT_MISMATCH' | 'MILL_SIGNER_MISMATCH' | 'DUPLICATE_NONCE' | 'NON_MONOTONIC_CUMULATIVE' | 'INVALID_SIGNATURE_LENGTH' | 'INVALID_SIGNATURE_V' | 'ENCODING_FAILED';
+    readonly code: 'INVALID_INPUT' | 'MISSING_SETTLEMENT_METADATA' | 'UNSUPPORTED_CHAIN' | 'MISSING_RECIPIENT' | 'RECIPIENT_MISMATCH' | 'SWAP_SIGNER_MISMATCH' | 'DUPLICATE_NONCE' | 'NON_MONOTONIC_CUMULATIVE' | 'INVALID_SIGNATURE_LENGTH' | 'INVALID_SIGNATURE_V' | 'ENCODING_FAILED';
     readonly cause?: unknown;
     constructor(code: SettlementTxError['code'], message: string, options?: {
         cause?: unknown;
@@ -395,18 +395,18 @@ declare function createPaymentHandlerBridge(config: PaymentHandlerBridgeConfig):
  * Event storage handler stub for @toon-protocol/sdk.
  *
  * This is a stub that throws. The real implementation lives in
- * `@toon-protocol/town` -- see `createEventStorageHandler` from that package.
+ * `@toon-protocol/relay` -- see `createEventStorageHandler` from that package.
  *
- * The SDK is the framework; Town is the relay implementation. SDK consumers
- * building relay functionality should use `@toon-protocol/town` directly.
+ * The SDK is the framework; Relay is the relay implementation. SDK consumers
+ * building relay functionality should use `@toon-protocol/relay` directly.
  */
 /**
  * Creates an event storage handler.
  *
- * **Stub** -- throws "not yet implemented". See `@toon-protocol/town` for the
+ * **Stub** -- throws "not yet implemented". See `@toon-protocol/relay` for the
  * real relay implementation of this handler.
  *
- * @see {@link https://github.com/ALLiDoizCode/toon/tree/main/packages/town | @toon-protocol/town}
+ * @see {@link https://github.com/toon-protocol/relay | @toon-protocol/relay}
  */
 declare function createEventStorageHandler(_config: unknown): unknown;
 
@@ -1358,7 +1358,7 @@ declare function uploadBlob(node: PublishableNode, blob: Buffer, destination: st
 declare function uploadBlobChunked(node: PublishableNode, blob: Buffer, destination: string, options: UploadBlobChunkedOptions): Promise<string>;
 
 /**
- * Mill Swap Handler (Story 12.3)
+ * Swap Handler (Story 12.3)
  *
  * `createSwapHandler()` factory produces a kind:1059 `Handler` that:
  *   1. Unwraps an incoming NIP-59 gift-wrapped ILP swap packet (via Story 12.2).
@@ -1381,7 +1381,7 @@ declare function uploadBlobChunked(node: PublishableNode, blob: Buffer, destinat
 
 /** Parameters passed to a {@link ClaimIssuer.issueClaim} call. */
 interface IssueClaimParams {
-    /** Source-asset amount received by the Mill (ILP packet amount, source micro-units). */
+    /** Source-asset amount received by the Swap (ILP packet amount, source micro-units). */
     sourceAmount: bigint;
     /** Target-asset amount owed to the sender (post-rate-conversion, target micro-units). */
     targetAmount: bigint;
@@ -1390,9 +1390,9 @@ interface IssueClaimParams {
     /**
      * The sender's real Nostr pubkey (extracted from the unwrapped seal).
      *
-     * Identity-layer key only: used by the Mill for inventory ledger keying and
+     * Identity-layer key only: used by the Swap for inventory ledger keying and
      * the sender→channel sticky binding (`channelState.reserve()` /
-     * `channelState.release()`). The Mill MUST NOT pass this to chain-layer
+     * `channelState.release()`). The Swap MUST NOT pass this to chain-layer
      * signers as the balance-proof `recipient` — use {@link chainRecipient}
      * for that (Story 12.9 D12-011).
      */
@@ -1401,11 +1401,11 @@ interface IssueClaimParams {
      * The sender's chain-specific payout address for `pair.to.chain`
      * (Story 12.9 AC-10). Extracted and format-validated from the rumor's
      * `chain-recipient` tag by the swap handler. REQUIRED. This is the
-     * address the Mill's `PaymentChannelSigner` MUST use as the balance-proof
+     * address the Swap's `PaymentChannelSigner` MUST use as the balance-proof
      * `recipient` (e.g., 20-byte EVM address, 32-byte Solana Ed25519 pubkey).
      */
     chainRecipient: string;
-    /** The inner rumor (for optional Mill-side context; may be ignored by the issuer). */
+    /** The inner rumor (for optional Swap-side context; may be ignored by the issuer). */
     rumor: UnsignedEvent;
 }
 /**
@@ -1418,7 +1418,7 @@ interface IssueClaimParams {
 interface IssueClaimResult {
     /** Signed claim bytes ready for NIP-44 encryption (chain-specific format). */
     claim: Uint8Array;
-    /** Optional Mill-side claim ID for logging/tracing. */
+    /** Optional Swap-side claim ID for logging/tracing. */
     claimId?: string;
     /** Channel identifier on the target chain. */
     channelId?: string;
@@ -1428,8 +1428,8 @@ interface IssueClaimResult {
     cumulativeAmount?: bigint;
     /** Recipient address (the sender's target-asset address). */
     recipient?: string;
-    /** Mill's on-chain signer address. */
-    millSignerAddress?: string;
+    /** Swap's on-chain signer address. */
+    swapSignerAddress?: string;
 }
 /**
  * Pluggable signed-claim issuer. Story 12.3 defines only the contract — the
@@ -1438,7 +1438,7 @@ interface IssueClaimResult {
  * The issuer owns inventory accounting and signing-key material. The handler
  * relies on `issueClaim()` being atomic with inventory debit: if the call
  * resolves, the target-asset amount MUST be considered committed from the
- * Mill's reserves. If the call throws, no inventory change SHOULD have occurred.
+ * Swap's reserves. If the call throws, no inventory change SHOULD have occurred.
  */
 interface ClaimIssuer {
     /**
@@ -1482,9 +1482,9 @@ interface SeenPacketIdsLike {
 }
 /** Configuration for {@link createSwapHandler}. */
 interface CreateSwapHandlerConfig {
-    /** Mill's secp256k1 secret key for unwrapping gift-wrapped packets (32 bytes). */
+    /** Swap's secp256k1 secret key for unwrapping gift-wrapped packets (32 bytes). */
     recipientSecretKey: Uint8Array;
-    /** Swap pairs this Mill currently supports. */
+    /** Swap pairs this Swap currently supports. */
     swapPairs: SwapPair[];
     /** Claim issuer delegate (Story 12.4 plugs in the multi-chain implementation). */
     claimIssuer: ClaimIssuer;
@@ -1524,11 +1524,11 @@ declare const SWAP_HANDLER_REJECT_CODES: {
     readonly UNREACHABLE: "F02";
     /** Duplicate packet — `seenPacketIds` replay hit. */
     readonly DUPLICATE_PACKET: "F04";
-    /** Requested swap pair is not advertised by this Mill. */
+    /** Requested swap pair is not advertised by this Swap. */
     readonly UNSUPPORTED_PAIR: "F06";
     /** Transient internal failure — signing, rate provider, or unexpected. */
     readonly INTERNAL: "T00";
-    /** Insufficient Mill inventory for the requested amount. */
+    /** Insufficient Swap inventory for the requested amount. */
     readonly INSUFFICIENT_LIQUIDITY: "T04";
 };
 /**
@@ -1553,7 +1553,7 @@ declare const SWAP_HANDLER_REJECT_MESSAGES: {
  * Uses BigInt arithmetic throughout — never coerces to `Number` — to preserve
  * 18-decimal EVM precision (Epic 11 retro MAX_SAFE_INTEGER guard).
  *
- * Rounds toward zero (integer division), which economically favors the Mill
+ * Rounds toward zero (integer division), which economically favors the Swap
  * (standard market-maker convention).
  *
  * @throws {SwapHandlerError} If rate format is invalid, rate is zero, or
@@ -1570,7 +1570,7 @@ declare function applyRate(params: ApplyRateParams): bigint;
  */
 declare function findSwapPair(rumor: UnsignedEvent, pairs: SwapPair[]): SwapPair | null;
 /**
- * Construct a kind:1059 Mill inbound-swap handler.
+ * Construct a kind:1059 Swap inbound-swap handler.
  *
  * The returned `Handler` is a pure closure over `config`; two calls with the
  * same config yield two independent-but-equivalent handlers. Register via
@@ -1586,9 +1586,9 @@ declare function createSwapHandler(config: CreateSwapHandlerConfig): Handler;
  *
  * ## What is implemented (and unit-tested)
  *
- * - {@link verifyMinaSignature}: verifies the Mill's off-chain balance-proof
+ * - {@link verifyMinaSignature}: verifies the Swap's off-chain balance-proof
  *   signature using `mina-signer` (`verifyFields`). This is the EXACT inverse
- *   of the Mill's {@link MinaPaymentChannelSigner} (`packages/mill/src/payment-channel-signer.ts`),
+ *   of the Swap's {@link MinaPaymentChannelSigner} (`packages/swap/src/payment-channel-signer.ts`),
  *   which signs `balanceProofFieldsMina(channelId, cumulativeAmount, nonce, recipient)`
  *   via `mina-signer`'s `signFields` and emits the base58 signature string as
  *   the claim's `claimBytes` (UTF-8). The field-element derivation lives in
@@ -1614,10 +1614,10 @@ declare function createSwapHandler(config: CreateSwapHandlerConfig): Handler;
  * generate the proof + broadcast. See the on-chain settlement note below
  * (connector 3.8.1 wires the dual-party claim path — connector#84).
  *
- * Note also: the Mill↔sender wire proof here (a Schnorr signature over four
+ * Note also: the Swap↔sender wire proof here (a Schnorr signature over four
  * field elements) is a DIFFERENT object than the connector's on-chain
  * `MinaPaymentChannelSDK` Poseidon-commitment proof shape
- * (`{ commitment, signature, nonce }`). The verifier matches the Mill's
+ * (`{ commitment, signature, nonce }`). The verifier matches the Swap's
  * actual emitted format (`MinaPaymentChannelSigner`), which is what a sender
  * receives on-wire.
  *
@@ -1654,8 +1654,8 @@ declare function loadMinaSignerClient(): Promise<MinaSignerClientLike | undefine
  * `AccumulatedClaim`.
  *
  * Re-derives the signed field-element message via {@link balanceProofFieldsMina}
- * (identical to the Mill signer), decodes the claim's `claimBytes` to the
- * base58 signature string the Mill emitted, and verifies it against
+ * (identical to the Swap signer), decodes the claim's `claimBytes` to the
+ * base58 signature string the Swap emitted, and verifies it against
  * `expectedSignerAddress` using a `mina-signer` `Client`.
  *
  * `client` MUST be a pre-loaded `mina-signer` `Client` (see
@@ -1700,8 +1700,8 @@ interface SettlementBundle {
     nonce: string;
     /** Recipient address (the sender's target-asset address — the one that will receive funds). */
     recipient: string;
-    /** Mill's on-chain signer address (expected signer of the balance-proof signature). */
-    millSignerAddress: string;
+    /** Swap's on-chain signer address (expected signer of the balance-proof signature). */
+    swapSignerAddress: string;
     /**
      * Raw UNSIGNED transaction bytes ready for the caller to sign (or for a
      * Chain Bridge DVM to gas-sponsor + sign). EVM: RLP-encoded tx with
@@ -1733,13 +1733,13 @@ interface SettlementBundle {
     sourceAssetCode: string;
 }
 /**
- * Per-chain Mill signer configuration.
+ * Per-chain Swap signer configuration.
  *
  * @since 12.6
  */
-interface MillSignerConfig {
+interface SwapSignerConfig {
     /**
-     * Expected on-chain signer address for the Mill. EVM: 0x + 40 lowercase
+     * Expected on-chain signer address for the Swap. EVM: 0x + 40 lowercase
      * hex chars. Solana: base58-encoded 32-byte Ed25519 pubkey. Mina: base58 pubkey.
      */
     address: string;
@@ -1765,8 +1765,8 @@ interface MillSignerConfig {
 interface BuildSettlementTxParams {
     /** Claims to settle. Typically `streamSwapResult.claims`. MUST be non-empty. */
     claims: readonly AccumulatedClaim[];
-    /** Per-chain Mill signer configuration. Keyed by `claim.pair.to.chain`. */
-    signers: Record<string, MillSignerConfig>;
+    /** Per-chain Swap signer configuration. Keyed by `claim.pair.to.chain`. */
+    signers: Record<string, SwapSignerConfig>;
     /** Sender's target-asset address per chain. Keyed by `claim.pair.to.chain`. */
     recipients: Record<string, string>;
     /** When `true` (default), verify every claim's signature against `signers[chain].address`. */
@@ -1831,7 +1831,7 @@ declare function fillEvmSettlementTxGas(bundle: SettlementBundle, gas: {
     nonce: bigint;
     gasPrice: bigint;
     gasLimit: bigint;
-}, signer: MillSignerConfig): Uint8Array;
+}, signer: SwapSignerConfig): Uint8Array;
 
 /**
  * `buildSettlementTx()` — public entrypoint for Story 12.6.
@@ -1854,7 +1854,7 @@ declare function fillEvmSettlementTxGas(bundle: SettlementBundle, gas: {
  *   2. Optionally verify each claim's signature. Rejected claims land in
  *      `result.rejected[]` and are dropped from further processing.
  *   3. Group surviving claims by `(chain, channelId)`. Within each group,
- *      assert recipient + millSignerAddress consensus, unique nonces, and
+ *      assert recipient + swapSignerAddress consensus, unique nonces, and
  *      non-decreasing cumulativeAmount with nonce.
  *   4. Pick the winning claim per group (highest nonce).
  *   5. Dispatch each winner to its chain-specific tx builder.
@@ -1871,7 +1871,7 @@ declare function fillEvmSettlementTxGas(bundle: SettlementBundle, gas: {
  *   claims: result.claims,
  *   signers: {
  *     'evm:base:8453': {
- *       address: '0xmill...',
+ *       address: '0xswap...',
  *       contractAddress: '0xtokennetwork...',
  *       chainId: 8453,
  *     },
@@ -1884,7 +1884,7 @@ declare function fillEvmSettlementTxGas(bundle: SettlementBundle, gas: {
 declare function buildSettlementTx(params: BuildSettlementTxParams): BuildSettlementTxResult;
 /**
  * Standalone utility: verify a single `AccumulatedClaim`'s signature against
- * a `MillSignerConfig` without running the full grouping/winner pipeline.
+ * a `SwapSignerConfig` without running the full grouping/winner pipeline.
  *
  * Useful inside a `streamSwap()` `onPacket` callback for mid-stream claim
  * validation.
@@ -1897,7 +1897,7 @@ declare function buildSettlementTx(params: BuildSettlementTxParams): BuildSettle
  * @stable
  * @since 12.6
  */
-declare function verifyAccumulatedClaim(claim: AccumulatedClaim, signer: MillSignerConfig, minaSignerClient?: MinaSignerClientLike): {
+declare function verifyAccumulatedClaim(claim: AccumulatedClaim, signer: SwapSignerConfig, minaSignerClient?: MinaSignerClientLike): {
     valid: true;
 } | {
     valid: false;
@@ -1921,30 +1921,30 @@ declare function verifyAccumulatedClaim(claim: AccumulatedClaim, signer: MillSig
 declare function verifyEd25519Signature(claim: AccumulatedClaim, expectedSignerAddress: string): boolean;
 
 /**
- * DvmHealthResponse — canonical type for the DVM BLS health endpoint.
- * Exported from @toon-protocol/sdk so Townhouse and the entrypoint share
- * the same definition (mirrors MillHealthResponse from @toon-protocol/mill).
+ * StoreHealthResponse — canonical type for the Store BLS health endpoint.
+ * Exported from @toon-protocol/sdk so the node and the entrypoint share
+ * the same definition (mirrors SwapHealthResponse from @toon-protocol/swap).
  */
 /** Per-kind job count for jobsRecent.byKind */
-interface DvmJobsByKindEntry {
+interface StoreJobsByKindEntry {
     kind: number;
     count: number;
 }
 /** Per-status job counts for the sliding window */
-interface DvmJobsByStatus {
+interface StoreJobsByStatus {
     processing: number;
     success: number;
     error: number;
     partial: number;
 }
 /** Windowed recent-jobs telemetry (default window: 5 min) */
-interface DvmJobsRecent {
+interface StoreJobsRecent {
     total: number;
-    byKind: DvmJobsByKindEntry[];
-    byStatus: DvmJobsByStatus;
+    byKind: StoreJobsByKindEntry[];
+    byStatus: StoreJobsByStatus;
 }
-/** Response shape for GET /health on the DVM BLS server (port 3400). */
-interface DvmHealthResponse {
+/** Response shape for GET /health on the Store BLS server (port 3400). */
+interface StoreHealthResponse {
     status: 'starting' | 'ok' | 'stopping' | 'stopped' | 'error';
     version: string;
     nodePubkey: string;
@@ -1954,7 +1954,7 @@ interface DvmHealthResponse {
     /** Per-kind pricing in string-encoded bigint (e.g. { "5094": "10", "5250": "10000" }). */
     kindPricing: Record<string, string>;
     basePricePerByte: string;
-    jobsRecent: DvmJobsRecent;
+    jobsRecent: StoreJobsRecent;
 }
 
-export { AccumulatedClaim, type AddChunkResult, type ApplyRateParams, type ArweaveDvmConfig, type ArweaveUploadAdapter, type BuildSettlementTxParams, type BuildSettlementTxResult, type BuildSkillDescriptorConfig, ChunkManager, type ChunkManagerConfig, type ClaimIssuer, type CreateHandlerContextOptions, type CreateSwapHandlerConfig, type DvmHealthResponse, type DvmJobsByKindEntry, type DvmJobsByStatus, type DvmJobsRecent, type FromMnemonicOptions, GiftWrapError, type Handler, type HandlerContext, HandlerError, HandlerRegistry, type HandlerResponse, IdentityError, type IssueClaimParams, type IssueClaimResult, type MillSignerConfig, type MinaIdentity, type MinaSignerClientLike, type NodeConfig, NodeError, type NodeIdentity, type PaymentHandlerBridgeConfig, type PaymentRequest, type PaymentResponse, type PrefixClaimHandlerOptions, PricingError, type PricingValidationResult, type PricingValidatorConfig, type PublishEventResult, type PublishableNode, SWAP_HANDLER_REJECT_CODES, SWAP_HANDLER_REJECT_MESSAGES, type ServiceNode, type SettlementBundle, SettlementTxError, type SolanaIdentity, type StartResult, StreamSwapError, SwapHandlerError, type SwapHandlerLogger, SwarmCoordinator, type SwarmCoordinatorOptions, type SwarmState, type ToonIdentity, TurboUploadAdapter, type UploadBlobChunkedOptions, type UploadBlobOptions, VerificationError, type VerificationPipelineConfig, type VerificationResult, type WorkflowEventStore, WorkflowOrchestrator, type WorkflowOrchestratorOptions, type WorkflowState, applyRate, base58Decode, base58Encode, buildSettlementTx, buildSkillDescriptor, createArweaveDvmHandler, createEventStorageHandler, createHandlerContext, createNode, createPaymentHandlerBridge, createPrefixClaimHandler, createPricingValidator, createSwapHandler, createVerificationPipeline, fillEvmSettlementTxGas, findSwapPair, fromMnemonic, fromMnemonicFull, fromSecretKey, generateMnemonic, generateSolanaKeypair, loadMinaSignerClient, uploadBlob, uploadBlobChunked, verifyAccumulatedClaim, verifyEd25519Signature, verifyMinaSignature };
+export { AccumulatedClaim, type AddChunkResult, type ApplyRateParams, type ArweaveDvmConfig, type ArweaveUploadAdapter, type BuildSettlementTxParams, type BuildSettlementTxResult, type BuildSkillDescriptorConfig, ChunkManager, type ChunkManagerConfig, type ClaimIssuer, type CreateHandlerContextOptions, type CreateSwapHandlerConfig, type FromMnemonicOptions, GiftWrapError, type Handler, type HandlerContext, HandlerError, HandlerRegistry, type HandlerResponse, IdentityError, type IssueClaimParams, type IssueClaimResult, type MinaIdentity, type MinaSignerClientLike, type NodeConfig, NodeError, type NodeIdentity, type PaymentHandlerBridgeConfig, type PaymentRequest, type PaymentResponse, type PrefixClaimHandlerOptions, PricingError, type PricingValidationResult, type PricingValidatorConfig, type PublishEventResult, type PublishableNode, SWAP_HANDLER_REJECT_CODES, SWAP_HANDLER_REJECT_MESSAGES, type ServiceNode, type SettlementBundle, SettlementTxError, type SolanaIdentity, type StartResult, type StoreHealthResponse, type StoreJobsByKindEntry, type StoreJobsByStatus, type StoreJobsRecent, StreamSwapError, SwapHandlerError, type SwapHandlerLogger, type SwapSignerConfig, SwarmCoordinator, type SwarmCoordinatorOptions, type SwarmState, type ToonIdentity, TurboUploadAdapter, type UploadBlobChunkedOptions, type UploadBlobOptions, VerificationError, type VerificationPipelineConfig, type VerificationResult, type WorkflowEventStore, WorkflowOrchestrator, type WorkflowOrchestratorOptions, type WorkflowState, applyRate, base58Decode, base58Encode, buildSettlementTx, buildSkillDescriptor, createArweaveDvmHandler, createEventStorageHandler, createHandlerContext, createNode, createPaymentHandlerBridge, createPrefixClaimHandler, createPricingValidator, createSwapHandler, createVerificationPipeline, fillEvmSettlementTxGas, findSwapPair, fromMnemonic, fromMnemonicFull, fromSecretKey, generateMnemonic, generateSolanaKeypair, loadMinaSignerClient, uploadBlob, uploadBlobChunked, verifyAccumulatedClaim, verifyEd25519Signature, verifyMinaSignature };

package/dist/index.js

@@ -29,7 +29,7 @@ import {
   unwrapSwapPacketFromToon,
   wrapSwapPacket,
   wrapSwapPacketToToon
-} from "./chunk-XTHUXP63.js";
+} from "./chunk-Z6S56VPV.js";
 import "./chunk-UP2VWCW5.js";
 
 // src/handler-context.ts
@@ -260,7 +260,7 @@ function createPaymentHandlerBridge(config) {
 // src/event-storage-handler.ts
 function createEventStorageHandler(_config) {
   throw new Error(
-    "createEventStorageHandler is not yet implemented in @toon-protocol/sdk. Use @toon-protocol/town for the relay implementation."
+    "createEventStorageHandler is not yet implemented in @toon-protocol/sdk. Use @toon-protocol/relay for the relay implementation."
   );
 }
 
@@ -2184,7 +2184,7 @@ function rlpEncodeUnsignedTx(params) {
   ]);
 }
 function buildEvmSettlementTx(winner, signer, recipient, selectedClaimIndex, claimsMerged) {
-  if (winner.channelId === void 0 || winner.cumulativeAmount === void 0 || winner.nonce === void 0 || winner.recipient === void 0 || winner.millSignerAddress === void 0) {
+  if (winner.channelId === void 0 || winner.cumulativeAmount === void 0 || winner.nonce === void 0 || winner.recipient === void 0 || winner.swapSignerAddress === void 0) {
     throw new SettlementTxError(
       "MISSING_SETTLEMENT_METADATA",
       "EVM winner claim missing settlement-context fields"
@@ -2193,13 +2193,13 @@ function buildEvmSettlementTx(winner, signer, recipient, selectedClaimIndex, cla
   if (!signer.contractAddress) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      `EVM MillSignerConfig.contractAddress is required for chain ${winner.pair.to.chain}`
+      `EVM SwapSignerConfig.contractAddress is required for chain ${winner.pair.to.chain}`
     );
   }
   if (typeof signer.chainId !== "number" || !Number.isInteger(signer.chainId) || signer.chainId <= 0) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      `EVM MillSignerConfig.chainId must be a positive integer, got ${signer.chainId}`
+      `EVM SwapSignerConfig.chainId must be a positive integer, got ${signer.chainId}`
     );
   }
   const channelIdBytes = hexToBytes2(winner.channelId);
@@ -2228,7 +2228,7 @@ function buildEvmSettlementTx(winner, signer, recipient, selectedClaimIndex, cla
     cumulativeAmount: winner.cumulativeAmount,
     nonce: winner.nonce,
     recipient,
-    millSignerAddress: winner.millSignerAddress,
+    swapSignerAddress: winner.swapSignerAddress,
     unsignedTxBytes,
     expectedEventSignature: EVM_SETTLEMENT_EVENT_TOPIC,
     claimsMerged,
@@ -2247,13 +2247,13 @@ function fillEvmSettlementTxGas(bundle, gas, signer) {
   if (!signer.contractAddress) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      "EVM MillSignerConfig.contractAddress is required for gas-fill"
+      "EVM SwapSignerConfig.contractAddress is required for gas-fill"
     );
   }
   if (typeof signer.chainId !== "number" || signer.chainId <= 0) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      "EVM MillSignerConfig.chainId must be a positive integer"
+      "EVM SwapSignerConfig.chainId must be a positive integer"
     );
   }
   const channelIdBytes = hexToBytes2(bundle.channelId);
@@ -2416,7 +2416,7 @@ function verifyMinaSignature(claim, expectedSignerAddress, client) {
   }
 }
 function buildMinaSettlementTx(winner, signer, recipient, selectedClaimIndex, claimsMerged) {
-  if (winner.channelId === void 0 || winner.cumulativeAmount === void 0 || winner.nonce === void 0 || winner.recipient === void 0 || winner.millSignerAddress === void 0) {
+  if (winner.channelId === void 0 || winner.cumulativeAmount === void 0 || winner.nonce === void 0 || winner.recipient === void 0 || winner.swapSignerAddress === void 0) {
     throw new SettlementTxError(
       "MISSING_SETTLEMENT_METADATA",
       "Mina winner claim missing settlement-context fields"
@@ -2425,7 +2425,7 @@ function buildMinaSettlementTx(winner, signer, recipient, selectedClaimIndex, cl
   if (!signer.address) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      `Mina MillSignerConfig.address is required for chain ${winner.pair.to.chain}`
+      `Mina SwapSignerConfig.address is required for chain ${winner.pair.to.chain}`
     );
   }
   if (winner.claimBytes.length === 0) {
@@ -2442,7 +2442,7 @@ function buildMinaSettlementTx(winner, signer, recipient, selectedClaimIndex, cl
     cumulativeAmount: winner.cumulativeAmount,
     nonce: winner.nonce,
     recipient,
-    millSignerAddress: winner.millSignerAddress,
+    swapSignerAddress: winner.swapSignerAddress,
     unsignedTxBytes,
     claimsMerged,
     selectedClaimIndex,
@@ -2520,7 +2520,7 @@ function bigintToBytes8LE(x) {
   return out;
 }
 function buildSolanaSettlementTx(winner, signer, recipient, selectedClaimIndex, claimsMerged) {
-  if (winner.channelId === void 0 || winner.cumulativeAmount === void 0 || winner.nonce === void 0 || winner.recipient === void 0 || winner.millSignerAddress === void 0) {
+  if (winner.channelId === void 0 || winner.cumulativeAmount === void 0 || winner.nonce === void 0 || winner.recipient === void 0 || winner.swapSignerAddress === void 0) {
     throw new SettlementTxError(
       "MISSING_SETTLEMENT_METADATA",
       "Solana winner claim missing settlement-context fields"
@@ -2529,17 +2529,17 @@ function buildSolanaSettlementTx(winner, signer, recipient, selectedClaimIndex,
   if (!signer.programId) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      `Solana MillSignerConfig.programId is required for chain ${winner.pair.to.chain}`
+      `Solana SwapSignerConfig.programId is required for chain ${winner.pair.to.chain}`
     );
   }
   let programIdBytes;
   let recipientBytes;
-  let millBytes;
+  let swapBytes;
   let channelIdBytes;
   try {
     programIdBytes = base58Decode(signer.programId);
     recipientBytes = base58Decode(recipient);
-    millBytes = base58Decode(winner.millSignerAddress);
+    swapBytes = base58Decode(winner.swapSignerAddress);
     channelIdBytes = base58Decode(winner.channelId);
   } catch (err) {
     throw new SettlementTxError(
@@ -2560,10 +2560,10 @@ function buildSolanaSettlementTx(winner, signer, recipient, selectedClaimIndex,
       `Solana recipient must decode to 32 bytes, got ${recipientBytes.length}`
     );
   }
-  if (millBytes.length !== 32) {
+  if (swapBytes.length !== 32) {
     throw new SettlementTxError(
       "INVALID_INPUT",
-      `Solana millSignerAddress must decode to 32 bytes, got ${millBytes.length}`
+      `Solana swapSignerAddress must decode to 32 bytes, got ${swapBytes.length}`
     );
   }
   if (channelIdBytes.length !== 32) {
@@ -2578,7 +2578,7 @@ function buildSolanaSettlementTx(winner, signer, recipient, selectedClaimIndex,
     bigintToBytes8LE(BigInt(winner.nonce)),
     winner.claimBytes
   );
-  const accounts = [recipientBytes, millBytes, channelIdBytes, programIdBytes];
+  const accounts = [recipientBytes, swapBytes, channelIdBytes, programIdBytes];
   const header = new Uint8Array([1, 0, 1]);
   const accountsCountByte = new Uint8Array([accounts.length]);
   const recentBlockhash = new Uint8Array(32);
@@ -2615,7 +2615,7 @@ function buildSolanaSettlementTx(winner, signer, recipient, selectedClaimIndex,
     cumulativeAmount: winner.cumulativeAmount,
     nonce: winner.nonce,
     recipient,
-    millSignerAddress: winner.millSignerAddress,
+    swapSignerAddress: winner.swapSignerAddress,
     unsignedTxBytes,
     claimsMerged,
     selectedClaimIndex,
@@ -2650,10 +2650,10 @@ function buildSettlementTx(params) {
   for (let i = 0; i < params.claims.length; i++) {
     const c = params.claims[i];
     if (c === void 0) continue;
-    if (c.channelId === void 0 || c.nonce === void 0 || c.cumulativeAmount === void 0 || c.recipient === void 0 || c.millSignerAddress === void 0) {
+    if (c.channelId === void 0 || c.nonce === void 0 || c.cumulativeAmount === void 0 || c.recipient === void 0 || c.swapSignerAddress === void 0) {
       throw new SettlementTxError(
         "MISSING_SETTLEMENT_METADATA",
-        `claims[${i}] missing one or more of { channelId, nonce, cumulativeAmount, recipient, millSignerAddress }`
+        `claims[${i}] missing one or more of { channelId, nonce, cumulativeAmount, recipient, swapSignerAddress }`
       );
     }
   }
@@ -2843,11 +2843,11 @@ function buildSettlementTx(params) {
     const first = g.claims[0];
     if (!first) continue;
     const firstRecipient = first.claim.recipient;
-    const firstMillSigner = first.claim.millSignerAddress;
-    if (firstRecipient === void 0 || firstMillSigner === void 0) {
+    const firstSwapSigner = first.claim.swapSignerAddress;
+    if (firstRecipient === void 0 || firstSwapSigner === void 0) {
       throw new SettlementTxError(
         "MISSING_SETTLEMENT_METADATA",
-        "winner claim missing recipient/millSignerAddress (unreachable after validation)"
+        "winner claim missing recipient/swapSignerAddress (unreachable after validation)"
       );
     }
     for (let i = 1; i < g.claims.length; i++) {
@@ -2860,10 +2860,10 @@ function buildSettlementTx(params) {
           `claims in channel ${g.channelId} disagree on recipient: ${firstRecipient} vs ${String(c.recipient)} (claim indices ${first.originalIndex}, ${entry.originalIndex})`
         );
       }
-      if (c.millSignerAddress !== firstMillSigner) {
+      if (c.swapSignerAddress !== firstSwapSigner) {
         throw new SettlementTxError(
-          "MILL_SIGNER_MISMATCH",
-          `claims in channel ${g.channelId} disagree on millSignerAddress: ${firstMillSigner} vs ${String(c.millSignerAddress)}`
+          "SWAP_SIGNER_MISMATCH",
+          `claims in channel ${g.channelId} disagree on swapSignerAddress: ${firstSwapSigner} vs ${String(c.swapSignerAddress)}`
         );
       }
     }
@@ -2925,7 +2925,7 @@ function buildSettlementTx(params) {
       if (recipient.toLowerCase() !== firstRecipient.toLowerCase()) {
         throw new SettlementTxError(
           "RECIPIENT_MISMATCH",
-          `recipients[${g.chain}] (${recipient}) does not match Mill-reported recipient (${firstRecipient})`
+          `recipients[${g.chain}] (${recipient}) does not match Swap-reported recipient (${firstRecipient})`
         );
       }
       bundle = buildEvmSettlementTx(
@@ -2939,7 +2939,7 @@ function buildSettlementTx(params) {
       if (recipient !== firstRecipient) {
         throw new SettlementTxError(
           "RECIPIENT_MISMATCH",
-          `recipients[${g.chain}] (${recipient}) does not match Mill-reported recipient (${firstRecipient})`
+          `recipients[${g.chain}] (${recipient}) does not match Swap-reported recipient (${firstRecipient})`
         );
       }
       bundle = buildSolanaSettlementTx(
@@ -2953,7 +2953,7 @@ function buildSettlementTx(params) {
       if (recipient !== firstRecipient) {
         throw new SettlementTxError(
           "RECIPIENT_MISMATCH",
-          `recipients[${g.chain}] (${recipient}) does not match Mill-reported recipient (${firstRecipient})`
+          `recipients[${g.chain}] (${recipient}) does not match Swap-reported recipient (${firstRecipient})`
         );
       }
       bundle = buildMinaSettlementTx(