@toon-protocol/sdk 2.1.0 → 2.2.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-Oub-0vqU.js';
-export { a as AdaptiveDeltaController, b as AdaptiveDeltaControllerConfig, D as DecryptFulfillClaimParams, E as EncryptFulfillClaimParams, c as EncryptFulfillClaimResult, I as InMemorySwapControllerStateStore, J as JsonFileSwapControllerStateStore, P as PacketObservation, d as PacketProgress, e as PacketResolution, R as RateMonitorCallback, S as StreamSwapAdaptiveController, f as StreamSwapController, g as StreamSwapParams, h as StreamSwapResult, i as SwapControllerError, j as SwapControllerState, k as SwapControllerStateStore, U as UnwrapSwapPacketFromToonParams, l as UnwrapSwapPacketParams, m as UnwrapSwapPacketResult, W as WrapSwapPacketParams, n as WrapSwapPacketResult, o as WrapSwapPacketToToonParams, p as WrapSwapPacketToToonResult, _ as __streamSwapTesting, q as decryptFulfillClaim, r as encryptFulfillClaim, s as isSwapControllerState, t as streamSwap, u as streamSwapControlled, v as swapControllerStateKey, w as unwrapSwapPacket, x as unwrapSwapPacketFromToon, y as wrapSwapPacket, z as wrapSwapPacketToToon } from './swap-Oub-0vqU.js';
+import { R as ReceiptSessionStoreLike, A as AccumulatedClaim } from './swap-PFQTJZA7.js';
+export { a as AdaptiveDeltaController, b as AdaptiveDeltaControllerConfig, B as BoundedReceiptSessions, D as DEFAULT_RECEIPT_SESSIONS_CAP, c as DecryptFulfillClaimParams, E as EncryptFulfillClaimParams, d as EncryptFulfillClaimResult, I as InMemorySwapControllerStateStore, J as JsonFileSwapControllerStateStore, P as PacketObservation, e as PacketProgress, f as PacketResolution, g as RateMonitorCallback, h as ReceiptAddResult, i as ReceiptChainTracker, j as ReceiptSessionState, S as STREAM_RECEIPT_SIGNING_TAG, k as STREAM_RECEIPT_VERSION, l as StreamReceipt, m as StreamReceiptChain, n as StreamReceiptFields, o as StreamSwapAdaptiveController, p as StreamSwapController, q as StreamSwapParams, r as StreamSwapResult, s as SwapControllerError, t as SwapControllerState, u as SwapControllerStateStore, U as UnwrapSwapPacketFromToonParams, v as UnwrapSwapPacketParams, w as UnwrapSwapPacketResult, W as WrapSwapPacketParams, x as WrapSwapPacketResult, y as WrapSwapPacketToToonParams, z as WrapSwapPacketToToonResult, _ as __streamSwapTesting, C as decryptFulfillClaim, F as encodeReceiptSigningPayload, G as encryptFulfillClaim, H as isSwapControllerState, K as isValidStreamNonce, L as issueSessionReceipt, M as parseStreamReceipt, N as serializeReceiptChain, O as signStreamReceipt, Q as streamSwap, T as streamSwapControlled, V as swapControllerStateKey, X as unwrapSwapPacket, Y as unwrapSwapPacketFromToon, Z as verifyStreamReceipt, $ as wrapSwapPacket, a0 as wrapSwapPacketToToon } from './swap-PFQTJZA7.js';
 
 /**
  * Unified identity module for @toon-protocol/sdk.
@@ -1527,6 +1527,27 @@ interface CreateSwapHandlerConfig {
      * satisfies the contract.
      */
     seenPacketIds?: SeenPacketIdsLike;
+    /**
+     * Optional dedicated receipt signing key (issue #84, rfc-0039 stream
+     * receipts; rolling-swap spec §7.2). 32-byte secp256k1 secret key used to
+     * BIP-340-sign the per-fulfill {@link StreamReceipt}. When OMITTED,
+     * receipts are signed with `recipientSecretKey` — the maker's Nostr
+     * identity key — so senders verify against the `swapPubkey` they already
+     * discovered via kind:10032. Provide a separate key when the receipt
+     * signer should be provisioned independently of the identity key (e.g.
+     * the swap#47 coupled engine binding receipts to the chain-B claim
+     * signer); senders then verify via `StreamSwapParams.receiptPubkey`.
+     */
+    receiptSecretKey?: Uint8Array;
+    /**
+     * Optional receipt session store (issue #84). Tracks per-`streamNonce`
+     * `{seq, cumulativeDelivered}` so receipt totals are monotone within a
+     * session. Defaults to a {@link BoundedReceiptSessions} in-memory LRU.
+     * Operators that persist claims should back this with the same storage so
+     * receipt state survives restarts alongside the claim stream (a lost
+     * session restarts at seq 1, which senders reject as a forked chain).
+     */
+    receiptSessions?: ReceiptSessionStoreLike;
     /** Optional pino-compatible logger. Defaults to a no-op logger. */
     logger?: SwapHandlerLogger;
 }
@@ -1980,4 +2001,4 @@ interface StoreHealthResponse {
     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 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, type RateQuote, 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 };
+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, type RateQuote, ReceiptSessionStoreLike, 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

@@ -1,9 +1,14 @@
 import {
+  BoundedReceiptSessions,
+  DEFAULT_RECEIPT_SESSIONS_CAP,
   GiftWrapError,
   HandlerError,
   IdentityError,
   NodeError,
   PricingError,
+  ReceiptChainTracker,
+  STREAM_RECEIPT_SIGNING_TAG,
+  STREAM_RECEIPT_VERSION,
   SWAP_HANDLER_REJECT_CODES,
   SWAP_HANDLER_REJECT_MESSAGES,
   SettlementTxError,
@@ -16,6 +21,7 @@ import {
   base58Encode,
   createSwapHandler,
   decryptFulfillClaim,
+  encodeReceiptSigningPayload,
   encryptFulfillClaim,
   findSwapPair,
   fromMnemonic,
@@ -23,13 +29,19 @@ import {
   fromSecretKey,
   generateMnemonic,
   generateSolanaKeypair,
+  isValidStreamNonce,
+  issueSessionReceipt,
+  parseStreamReceipt,
+  serializeReceiptChain,
+  signStreamReceipt,
   streamSwap,
   streamSwapControlled,
   unwrapSwapPacket,
   unwrapSwapPacketFromToon,
+  verifyStreamReceipt,
   wrapSwapPacket,
   wrapSwapPacketToToon
-} from "./chunk-7LBYFU4L.js";
+} from "./chunk-RAZRWSJF.js";
 import "./chunk-UP2VWCW5.js";
 
 // src/handler-context.ts
@@ -3394,7 +3406,9 @@ function verifyAccumulatedClaim(claim, signer, minaSignerClient) {
 }
 export {
   AdaptiveDeltaController,
+  BoundedReceiptSessions,
   ChunkManager,
+  DEFAULT_RECEIPT_SESSIONS_CAP,
   GiftWrapError,
   HandlerError,
   HandlerRegistry,
@@ -3403,6 +3417,9 @@ export {
   JsonFileSwapControllerStateStore,
   NodeError,
   PricingError,
+  ReceiptChainTracker,
+  STREAM_RECEIPT_SIGNING_TAG,
+  STREAM_RECEIPT_VERSION,
   SWAP_HANDLER_REJECT_CODES,
   SWAP_HANDLER_REJECT_MESSAGES,
   SettlementTxError,
@@ -3434,6 +3451,7 @@ export {
   createSwapHandler,
   createVerificationPipeline,
   decryptFulfillClaim,
+  encodeReceiptSigningPayload,
   encryptFulfillClaim,
   fillEvmSettlementTxGas,
   findSwapPair,
@@ -3444,8 +3462,13 @@ export {
   generateSolanaKeypair,
   hexToBytes2 as hexToBytes,
   isSwapControllerState,
+  isValidStreamNonce,
+  issueSessionReceipt,
   loadMinaSignerClient,
   minaHashToField,
+  parseStreamReceipt,
+  serializeReceiptChain,
+  signStreamReceipt,
   streamSwap,
   streamSwapControlled,
   swapControllerStateKey,
@@ -3456,6 +3479,7 @@ export {
   verifyAccumulatedClaim,
   verifyEd25519Signature,
   verifyMinaSignature,
+  verifyStreamReceipt,
   wrapSwapPacket,
   wrapSwapPacketToToon
 };