@invisi-labs/sdk 1.1.5 → 1.1.6

package/dist/{operation-types-DIazgS2d.d.cts → NoteOutput-DRkVnwlx.d.cts}

@@ -1,10 +1,40 @@
-import { c as StoredNote, W as WalletScope, b as WalletStore } from './state-AUnz7TG7.cjs';
-import { TransactionContext, CanonicalBlock, NoteMembership, FundingInput, TransactRequestParams, CreditMembership, Protocol, ChainReader, ProtocolDataProvider, TokenProtocol } from '@invisi-labs/protocol';
+import { Hex, Note, CreditDeliveryState, ViewingCapability, Wallet, PublicWallet, WalletAuthorizationProvider } from '@invisi-labs/core';
+import { Address, Hex as Hex$1, Delivery, ShieldParams, ShieldOutput, CreateCreditParams, CreditDrawParams, CancelCreditParams, TopUpCreditParams, TransactRequest } from '@invisi-labs/protocol/contracts';
+import { c as StoredNote, W as WalletScope, b as WalletStore } from './state-C4HZFotm.cjs';
+import { FundingInput, TransactionContext, CanonicalBlock, NoteMembership, TransactRequestParams, CreditMembership, Protocol, ChainReader, ProtocolDataProvider, TokenProtocol } from '@invisi-labs/protocol';
+import { Signer, Provider } from 'ethers';
 import * as _invisi_labs_prover from '@invisi-labs/prover';
 import { Prover, ProverOptions, AggregateMember } from '@invisi-labs/prover';
-import { Hex, Note, CreditDeliveryState, ViewingCapability, Wallet, PublicWallet, WalletAuthorizationProvider, ReceivingKeyLookup } from '@invisi-labs/core';
-import { Signer } from 'ethers';
-import { Address, Hex as Hex$1, Delivery, ShieldParams, ShieldOutput, CreateCreditParams, CreditDrawParams, CancelCreditParams, TopUpCreditParams, TransactRequest } from '@invisi-labs/protocol/contracts';
+
+type PreparationIntent = {
+    kind: "transfer";
+    options: TransferPreparation;
+} | {
+    kind: "shield";
+    options: ShieldPreparation;
+} | {
+    kind: "create-credit";
+    options: CreateCreditPreparation;
+} | {
+    kind: "top-up-credit";
+    options: TopUpCreditPreparation;
+} | {
+    kind: "cancel-credit";
+    options: CancelCreditPreparation;
+};
+type BroadcasterFeeSource = "public-funding" | "private-inputs" | "payout";
+interface WithBroadcasterOptions {
+    maxFeeAmount: bigint;
+    feeSource?: BroadcasterFeeSource;
+    maxAttempts?: number;
+    /** Optional app-owned permit signing, requested once for the final gross funding amount. */
+    fundingPermit?: (request: {
+        payer: `0x${string}`;
+        amount: bigint;
+        tokenAddress: `0x${string}`;
+        protocolAddress: `0x${string}`;
+    }) => Promise<NonNullable<TransferPreparation["funding"]>["permit"]>;
+}
 
 interface GasBenchmarkShape {
     kind: OperationPlan["kind"];
@@ -117,12 +147,6 @@ interface FundingSource {
     deadline?: bigint;
     permit?: NonNullable<FundingInput["permit"]>;
 }
-interface PaymentOutput {
-    /** Version-specific application data. Omission uses built-in v1 with no data. */
-    payload?: Uint8Array;
-    to: string;
-    amount: bigint;
-}
 /** Public submission mode; backend proof targets are selected internally. */
 type TransactionExecution = "single" | "aggregate";
 interface TransactionProveOptions extends ProverOptions {
@@ -138,25 +162,43 @@ interface TransferPreparation {
         to: Address;
         amount: bigint;
     };
-    outputs: readonly PaymentOutput[];
+    /** Immediate public fee paid from this operation's token. */
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
+    outputs: readonly NoteOutput[];
     funding?: FundingSource;
     deadline?: bigint;
 }
 interface ShieldPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     tokenAddress: Address;
-    outputs: readonly PaymentOutput[];
+    outputs: readonly NoteOutput[];
     funding: FundingSource;
     deadline?: bigint;
 }
 interface PreparedOutput {
-    note: Note;
+    context: NoteOutputContext;
+    recipient: NoteOutputRecipient;
+    amount: bigint;
+    note?: Note;
     commitment: Hex$1;
     identity: Hex$1;
     delivery: Delivery;
+    /** Only offline encrypted EVM outputs may await registry-key resolution. */
+    deliveryPending?: true;
     address: string;
     change: boolean;
 }
 interface CreateCreditPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     /** Version-specific application data. Omission uses built-in v1 with no data. */
     payload?: Uint8Array;
     singleLimit?: bigint;
@@ -179,6 +221,10 @@ interface DrawCreditPreparation {
     deadline?: bigint;
 }
 interface TopUpCreditPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     /** Version-specific application data. Omission uses built-in v1 with no data. */
     payload?: Uint8Array;
     /** Omission inherits the previous limit; zero disables it without clearing usage. */
@@ -193,6 +239,10 @@ interface TopUpCreditPreparation {
     deadline?: bigint;
 }
 interface CancelCreditPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     tokenAddress: Address;
     credit: Hex$1;
     deadline?: bigint;
@@ -217,6 +267,7 @@ interface CreditPlan {
     amounts?: bigint[];
 }
 interface OperationPlan {
+    intent?: PreparationIntent;
     version: 1;
     id: string;
     kind: "transfer" | "shield" | "create-credit" | "draw-credit" | "top-up-credit" | "cancel-credit";
@@ -243,7 +294,7 @@ interface WalletSessionInfrastructure {
     gasBenchmarks?: readonly GasBenchmarkProfile[];
     /** Optional ethers gas/funding signer; distinct from the Invisi wallet authority. */
     signer?: Signer;
-    viewing?: Pick<ViewingCapability, "walletIdentity" | "decryptNote" | "decryptCredit">;
+    viewing?: Pick<ViewingCapability, "ownerAddress" | "decryptNote" | "decryptCredit">;
     wallet: Wallet | PublicWallet;
     protocol: Protocol;
     namespace?: string;
@@ -254,7 +305,8 @@ interface WalletSessionInfrastructure {
     prover?: Prover;
     fundingSigner?: FundingSigner;
     fundingVerifier?: FundingAuthorizationVerifier;
-    addressResolver?: ReceivingKeyLookup;
+    /** Optional ethers provider used by per-output direct-chain receiving-key lookup. */
+    provider?: Provider;
     coinSelector?: CoinSelector;
     transactionTTL?: bigint;
 }
@@ -272,4 +324,75 @@ interface OperationAggregateMember extends AggregateMember {
     request: TransactRequest;
 }
 
-export { type CancelCreditPreparation as C, type DrawCreditPreparation as D, type FundingAuthorizationVerifier as F, type GasReference as G, type OperationRuntime as O, type PaymentOutput as P, type ShieldPreparation as S, type TransactionProveOptions as T, type WalletSessionOptions as W, type OperationPlan as a, type OperationAggregateMember as b, type CreateCreditPreparation as c, type TopUpCreditPreparation as d, type TransferPreparation as e, type WalletSessionInfrastructure as f, type CoinSelector as g, type FundingSigner as h, type FundingSource as i, type FundingTypedData as j, type GasBenchmarkCircuit as k, type GasBenchmarkDeployment as l, type GasBenchmarkProfile as m, type GasBenchmarkSample as n, type GasBenchmarkShape as o, type TransactionExecution as p, defineGasBenchmarks as q };
+type AddressLookup = "chain" | "protocol-rpc";
+
+interface NoteOutputContext {
+    chainId: bigint;
+    protocolAddress: Hex$1;
+    tokenAddress: Hex$1;
+}
+type NoteOutputRecipient = {
+    type: "evm";
+    address: string;
+    envelope?: boolean;
+    addressLookup?: AddressLookup;
+    nonce?: bigint | undefined;
+} | {
+    type: "invisi";
+    address: string;
+    nonce?: bigint | undefined;
+} | {
+    type: "identity";
+    identity: Hex$1;
+};
+type EncryptedRecipient = {
+    type: "evm";
+    address: string;
+    envelope?: true;
+    addressLookup?: AddressLookup;
+    nonce?: bigint | undefined;
+} | {
+    type: "invisi";
+    address: string;
+    nonce?: bigint | undefined;
+};
+type NoteOutputOptions = NoteOutputContext & {
+    amount: bigint;
+} & ({
+    recipient: EncryptedRecipient;
+    payload?: Uint8Array;
+} | {
+    recipient: {
+        type: "evm";
+        address: string;
+        envelope: false;
+        addressLookup?: AddressLookup;
+        nonce?: bigint | undefined;
+    } | {
+        type: "identity";
+        identity: Hex$1;
+    };
+    payload?: never;
+});
+/** Immutable output statement and optional recoverable opening. */
+declare class NoteOutput {
+    readonly to: string;
+    readonly amount: bigint;
+    readonly identity: Hex$1;
+    readonly commitment: Hex$1;
+    readonly deliveryFingerprint: Hex$1;
+    /** Encrypted EVM delivery is resolved by preparation; the original offline intent stays pending. */
+    readonly deliveryPending: boolean;
+    readonly context: NoteOutputContext;
+    readonly recipient: NoteOutputRecipient;
+    readonly nonce: bigint | undefined;
+    readonly payload: Uint8Array;
+    readonly preparedOutput: PreparedOutput;
+    private constructor();
+    static create(options: NoteOutputOptions): Promise<NoteOutput>;
+    assertCommitment(expectedHex: Hex$1): void;
+    get note(): Note | undefined;
+    get delivery(): Delivery;
+}
+
+export { type BroadcasterFeeSource as B, type CancelCreditPreparation as C, type DrawCreditPreparation as D, type FundingAuthorizationVerifier as F, type GasReference as G, NoteOutput as N, type OperationRuntime as O, type PreparationIntent as P, type ShieldPreparation as S, type TransactionProveOptions as T, type WithBroadcasterOptions as W, type OperationPlan as a, type OperationAggregateMember as b, type CreateCreditPreparation as c, type TopUpCreditPreparation as d, type TransferPreparation as e, type WalletSessionOptions as f, type WalletSessionInfrastructure as g, type CoinSelector as h, type FundingSigner as i, type FundingSource as j, type FundingTypedData as k, type GasBenchmarkCircuit as l, type GasBenchmarkDeployment as m, type GasBenchmarkProfile as n, type GasBenchmarkSample as o, type GasBenchmarkShape as p, type NoteOutputContext as q, type NoteOutputOptions as r, type NoteOutputRecipient as s, type TransactionExecution as t, defineGasBenchmarks as u };

package/dist/{operation-types-D7I405FX.d.ts → NoteOutput-DpDC6T2O.d.ts}

@@ -1,10 +1,40 @@
-import { c as StoredNote, W as WalletScope, b as WalletStore } from './state-AUnz7TG7.js';
-import { TransactionContext, CanonicalBlock, NoteMembership, FundingInput, TransactRequestParams, CreditMembership, Protocol, ChainReader, ProtocolDataProvider, TokenProtocol } from '@invisi-labs/protocol';
+import { Hex, Note, CreditDeliveryState, ViewingCapability, Wallet, PublicWallet, WalletAuthorizationProvider } from '@invisi-labs/core';
+import { Address, Hex as Hex$1, Delivery, ShieldParams, ShieldOutput, CreateCreditParams, CreditDrawParams, CancelCreditParams, TopUpCreditParams, TransactRequest } from '@invisi-labs/protocol/contracts';
+import { c as StoredNote, W as WalletScope, b as WalletStore } from './state-C4HZFotm.js';
+import { FundingInput, TransactionContext, CanonicalBlock, NoteMembership, TransactRequestParams, CreditMembership, Protocol, ChainReader, ProtocolDataProvider, TokenProtocol } from '@invisi-labs/protocol';
+import { Signer, Provider } from 'ethers';
 import * as _invisi_labs_prover from '@invisi-labs/prover';
 import { Prover, ProverOptions, AggregateMember } from '@invisi-labs/prover';
-import { Hex, Note, CreditDeliveryState, ViewingCapability, Wallet, PublicWallet, WalletAuthorizationProvider, ReceivingKeyLookup } from '@invisi-labs/core';
-import { Signer } from 'ethers';
-import { Address, Hex as Hex$1, Delivery, ShieldParams, ShieldOutput, CreateCreditParams, CreditDrawParams, CancelCreditParams, TopUpCreditParams, TransactRequest } from '@invisi-labs/protocol/contracts';
+
+type PreparationIntent = {
+    kind: "transfer";
+    options: TransferPreparation;
+} | {
+    kind: "shield";
+    options: ShieldPreparation;
+} | {
+    kind: "create-credit";
+    options: CreateCreditPreparation;
+} | {
+    kind: "top-up-credit";
+    options: TopUpCreditPreparation;
+} | {
+    kind: "cancel-credit";
+    options: CancelCreditPreparation;
+};
+type BroadcasterFeeSource = "public-funding" | "private-inputs" | "payout";
+interface WithBroadcasterOptions {
+    maxFeeAmount: bigint;
+    feeSource?: BroadcasterFeeSource;
+    maxAttempts?: number;
+    /** Optional app-owned permit signing, requested once for the final gross funding amount. */
+    fundingPermit?: (request: {
+        payer: `0x${string}`;
+        amount: bigint;
+        tokenAddress: `0x${string}`;
+        protocolAddress: `0x${string}`;
+    }) => Promise<NonNullable<TransferPreparation["funding"]>["permit"]>;
+}
 
 interface GasBenchmarkShape {
     kind: OperationPlan["kind"];
@@ -117,12 +147,6 @@ interface FundingSource {
     deadline?: bigint;
     permit?: NonNullable<FundingInput["permit"]>;
 }
-interface PaymentOutput {
-    /** Version-specific application data. Omission uses built-in v1 with no data. */
-    payload?: Uint8Array;
-    to: string;
-    amount: bigint;
-}
 /** Public submission mode; backend proof targets are selected internally. */
 type TransactionExecution = "single" | "aggregate";
 interface TransactionProveOptions extends ProverOptions {
@@ -138,25 +162,43 @@ interface TransferPreparation {
         to: Address;
         amount: bigint;
     };
-    outputs: readonly PaymentOutput[];
+    /** Immediate public fee paid from this operation's token. */
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
+    outputs: readonly NoteOutput[];
     funding?: FundingSource;
     deadline?: bigint;
 }
 interface ShieldPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     tokenAddress: Address;
-    outputs: readonly PaymentOutput[];
+    outputs: readonly NoteOutput[];
     funding: FundingSource;
     deadline?: bigint;
 }
 interface PreparedOutput {
-    note: Note;
+    context: NoteOutputContext;
+    recipient: NoteOutputRecipient;
+    amount: bigint;
+    note?: Note;
     commitment: Hex$1;
     identity: Hex$1;
     delivery: Delivery;
+    /** Only offline encrypted EVM outputs may await registry-key resolution. */
+    deliveryPending?: true;
     address: string;
     change: boolean;
 }
 interface CreateCreditPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     /** Version-specific application data. Omission uses built-in v1 with no data. */
     payload?: Uint8Array;
     singleLimit?: bigint;
@@ -179,6 +221,10 @@ interface DrawCreditPreparation {
     deadline?: bigint;
 }
 interface TopUpCreditPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     /** Version-specific application data. Omission uses built-in v1 with no data. */
     payload?: Uint8Array;
     /** Omission inherits the previous limit; zero disables it without clearing usage. */
@@ -193,6 +239,10 @@ interface TopUpCreditPreparation {
     deadline?: bigint;
 }
 interface CancelCreditPreparation {
+    fee?: {
+        recipient: Address;
+        amount: bigint;
+    };
     tokenAddress: Address;
     credit: Hex$1;
     deadline?: bigint;
@@ -217,6 +267,7 @@ interface CreditPlan {
     amounts?: bigint[];
 }
 interface OperationPlan {
+    intent?: PreparationIntent;
     version: 1;
     id: string;
     kind: "transfer" | "shield" | "create-credit" | "draw-credit" | "top-up-credit" | "cancel-credit";
@@ -243,7 +294,7 @@ interface WalletSessionInfrastructure {
     gasBenchmarks?: readonly GasBenchmarkProfile[];
     /** Optional ethers gas/funding signer; distinct from the Invisi wallet authority. */
     signer?: Signer;
-    viewing?: Pick<ViewingCapability, "walletIdentity" | "decryptNote" | "decryptCredit">;
+    viewing?: Pick<ViewingCapability, "ownerAddress" | "decryptNote" | "decryptCredit">;
     wallet: Wallet | PublicWallet;
     protocol: Protocol;
     namespace?: string;
@@ -254,7 +305,8 @@ interface WalletSessionInfrastructure {
     prover?: Prover;
     fundingSigner?: FundingSigner;
     fundingVerifier?: FundingAuthorizationVerifier;
-    addressResolver?: ReceivingKeyLookup;
+    /** Optional ethers provider used by per-output direct-chain receiving-key lookup. */
+    provider?: Provider;
     coinSelector?: CoinSelector;
     transactionTTL?: bigint;
 }
@@ -272,4 +324,75 @@ interface OperationAggregateMember extends AggregateMember {
     request: TransactRequest;
 }
 
-export { type CancelCreditPreparation as C, type DrawCreditPreparation as D, type FundingAuthorizationVerifier as F, type GasReference as G, type OperationRuntime as O, type PaymentOutput as P, type ShieldPreparation as S, type TransactionProveOptions as T, type WalletSessionOptions as W, type OperationPlan as a, type OperationAggregateMember as b, type CreateCreditPreparation as c, type TopUpCreditPreparation as d, type TransferPreparation as e, type WalletSessionInfrastructure as f, type CoinSelector as g, type FundingSigner as h, type FundingSource as i, type FundingTypedData as j, type GasBenchmarkCircuit as k, type GasBenchmarkDeployment as l, type GasBenchmarkProfile as m, type GasBenchmarkSample as n, type GasBenchmarkShape as o, type TransactionExecution as p, defineGasBenchmarks as q };
+type AddressLookup = "chain" | "protocol-rpc";
+
+interface NoteOutputContext {
+    chainId: bigint;
+    protocolAddress: Hex$1;
+    tokenAddress: Hex$1;
+}
+type NoteOutputRecipient = {
+    type: "evm";
+    address: string;
+    envelope?: boolean;
+    addressLookup?: AddressLookup;
+    nonce?: bigint | undefined;
+} | {
+    type: "invisi";
+    address: string;
+    nonce?: bigint | undefined;
+} | {
+    type: "identity";
+    identity: Hex$1;
+};
+type EncryptedRecipient = {
+    type: "evm";
+    address: string;
+    envelope?: true;
+    addressLookup?: AddressLookup;
+    nonce?: bigint | undefined;
+} | {
+    type: "invisi";
+    address: string;
+    nonce?: bigint | undefined;
+};
+type NoteOutputOptions = NoteOutputContext & {
+    amount: bigint;
+} & ({
+    recipient: EncryptedRecipient;
+    payload?: Uint8Array;
+} | {
+    recipient: {
+        type: "evm";
+        address: string;
+        envelope: false;
+        addressLookup?: AddressLookup;
+        nonce?: bigint | undefined;
+    } | {
+        type: "identity";
+        identity: Hex$1;
+    };
+    payload?: never;
+});
+/** Immutable output statement and optional recoverable opening. */
+declare class NoteOutput {
+    readonly to: string;
+    readonly amount: bigint;
+    readonly identity: Hex$1;
+    readonly commitment: Hex$1;
+    readonly deliveryFingerprint: Hex$1;
+    /** Encrypted EVM delivery is resolved by preparation; the original offline intent stays pending. */
+    readonly deliveryPending: boolean;
+    readonly context: NoteOutputContext;
+    readonly recipient: NoteOutputRecipient;
+    readonly nonce: bigint | undefined;
+    readonly payload: Uint8Array;
+    readonly preparedOutput: PreparedOutput;
+    private constructor();
+    static create(options: NoteOutputOptions): Promise<NoteOutput>;
+    assertCommitment(expectedHex: Hex$1): void;
+    get note(): Note | undefined;
+    get delivery(): Delivery;
+}
+
+export { type BroadcasterFeeSource as B, type CancelCreditPreparation as C, type DrawCreditPreparation as D, type FundingAuthorizationVerifier as F, type GasReference as G, NoteOutput as N, type OperationRuntime as O, type PreparationIntent as P, type ShieldPreparation as S, type TransactionProveOptions as T, type WithBroadcasterOptions as W, type OperationPlan as a, type OperationAggregateMember as b, type CreateCreditPreparation as c, type TopUpCreditPreparation as d, type TransferPreparation as e, type WalletSessionOptions as f, type WalletSessionInfrastructure as g, type CoinSelector as h, type FundingSigner as i, type FundingSource as j, type FundingTypedData as k, type GasBenchmarkCircuit as l, type GasBenchmarkDeployment as m, type GasBenchmarkProfile as n, type GasBenchmarkSample as o, type GasBenchmarkShape as p, type NoteOutputContext as q, type NoteOutputOptions as r, type NoteOutputRecipient as s, type TransactionExecution as t, defineGasBenchmarks as u };

package/dist/broadcaster-preparation-QVL62KM6.js

@@ -0,0 +1,128 @@
+import {
+  TransactionPreparation,
+  exportBroadcasterIntent
+} from "./chunk-FL4TIGWW.js";
+import "./chunk-QC6TQR3R.js";
+
+// src/broadcaster-preparation.ts
+import { getAddress } from "ethers";
+async function prepareIntent(runtime, intent) {
+  const preparation = new TransactionPreparation(runtime);
+  switch (intent.kind) {
+    case "transfer":
+      return preparation.prepareTransfer(intent.options);
+    case "shield":
+      return preparation.prepareShield(intent.options);
+    case "create-credit":
+      return preparation.prepareCreateCredit(intent.options);
+    case "top-up-credit":
+      return preparation.prepareTopUpCredit(intent.options);
+    case "cancel-credit":
+      return preparation.prepareCancelCredit(intent.options);
+  }
+}
+async function prepareBroadcasterPlan(plan, reprepare, client, options) {
+  if (!plan.intent) throw new Error("operation has no supported preparation intent");
+  const intent = structuredClone(plan.intent);
+  intent.options.deadline = plan.deadline;
+  const maxFee = options.maxFeeAmount;
+  const attempts = options.maxAttempts ?? 4;
+  if (typeof maxFee !== "bigint" || maxFee <= 0n || maxFee >= 1n << 128n)
+    throw new Error("maxFeeAmount must be a positive uint128");
+  if (!Number.isInteger(attempts) || attempts < 1 || attempts > 16)
+    throw new Error("maxAttempts must be 1..16");
+  const funding = "funding" in intent.options ? intent.options.funding : void 0;
+  let source = options.feeSource ?? (intent.kind === "cancel-credit" ? "payout" : funding ? "public-funding" : "private-inputs");
+  if (!["public-funding", "private-inputs", "payout"].includes(source))
+    throw new Error("unsupported fee source");
+  if (intent.kind === "cancel-credit" ? source !== "payout" : source === "payout" || intent.kind === "shield" && source !== "public-funding")
+    throw new Error("fee source is unavailable for this operation");
+  if (source === "public-funding" && !funding)
+    throw new Error("public funding fee requires an explicit payer");
+  const permitCallback = options.fundingPermit;
+  let schedule = await client.fee(plan.context.tokenAddress, exportBroadcasterIntent(plan).data);
+  let previousAmount = 0n;
+  for (let i = 0; i < attempts; i++) {
+    const minimum = BigInt(schedule.feeAmount);
+    const amount = minimum > previousAmount ? minimum : previousAmount;
+    const recipient = getAddress(schedule.feeRecipient);
+    if (amount <= 0n || amount > maxFee || amount >= 1n << 128n || BigInt(recipient) === 0n)
+      throw new Error("broadcaster fee exceeds user limit or is invalid");
+    if (options.feeSource === void 0 && funding && plan.inputs.length > 0 && (intent.kind === "transfer" || intent.kind === "create-credit" || intent.kind === "top-up-credit")) {
+      const business = intent.kind === "transfer" ? intent.options.outputs.reduce(
+        (sum, output) => sum + output.amount,
+        intent.options.withdrawal?.amount ?? 0n
+      ) : intent.kind === "create-credit" ? intent.options.amount : intent.options.additionalAmount;
+      const change = plan.inputs.reduce((sum, input) => sum + input.note.amount, funding.amount) - business;
+      source = change >= amount ? "private-inputs" : "public-funding";
+    }
+    if (source === "public-funding" && funding?.permit && funding.permit.deadline !== 0n && !permitCallback)
+      throw new Error(
+        "existing permit cannot fund an increased amount; provide fundingPermit for final gross funding or approve separately"
+      );
+    if (source === "payout" && amount >= plan.credit.cancel.amount)
+      throw new Error("fee must be less than the cancellation refund");
+    const request = structuredClone(intent);
+    request.options.fee = { recipient, amount };
+    if (funding && "funding" in request.options) {
+      const signedFunding = { ...funding };
+      if (funding.authorization === "caller") {
+        delete signedFunding.sigNonce;
+        delete signedFunding.deadline;
+      }
+      request.options.funding = {
+        ...signedFunding,
+        amount: funding.amount + (source === "public-funding" ? amount : 0n),
+        authorization: "signature"
+      };
+    }
+    const next = await reprepare(request);
+    if (source === "private-inputs" && next.inputs.length === 0)
+      throw new Error("private-inputs fee requires private funds");
+    const recalculated = await client.fee(
+      plan.context.tokenAddress,
+      exportBroadcasterIntent(next).data
+    );
+    const required = BigInt(recalculated.feeAmount);
+    if (getAddress(recalculated.feeRecipient) !== recipient || required <= 0n || required > maxFee)
+      throw new Error("broadcaster fee exceeds user limit or recipient changed");
+    if (amount >= required) {
+      let final = next;
+      if (permitCallback) {
+        if (!funding || !("funding" in request.options))
+          throw new Error("fundingPermit requires public funding");
+        const permit = await permitCallback({
+          payer: funding.payer,
+          amount: request.options.funding.amount,
+          tokenAddress: plan.context.tokenAddress,
+          protocolAddress: plan.context.protocolAddress
+        });
+        if (!permit) throw new Error("fundingPermit did not return a permit");
+        request.options.funding = { ...request.options.funding, permit };
+        final = await reprepare(request);
+        const permitted = await client.fee(
+          plan.context.tokenAddress,
+          exportBroadcasterIntent(final).data
+        );
+        if (getAddress(permitted.feeRecipient) !== recipient || BigInt(permitted.feeAmount) > amount)
+          throw new Error("permit changed the required fee; prepare again");
+      }
+      final.intent = structuredClone(intent);
+      return {
+        plan: final,
+        quote: await client.quote(exportBroadcasterIntent(final).data, {
+          chainId: final.context.chainId,
+          protocol: final.context.protocolAddress
+        })
+      };
+    }
+    previousAmount = amount;
+    schedule = recalculated;
+  }
+  throw new Error("broadcaster fee did not stabilize within the preparation limit");
+}
+export {
+  prepareBroadcasterPlan,
+  prepareIntent
+};
+//# sourceMappingURL=broadcaster-preparation-QVL62KM6.js.map

package/dist/broadcaster-preparation-QVL62KM6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/broadcaster-preparation.ts"],"sourcesContent":["import { getAddress } from \"ethers\";\nimport type { BroadcasterClient, SignedBroadcasterQuote } from \"./broadcaster\";\nimport type {\n    OperationPlan,\n    PreparationRuntime,\n    TransferPreparation,\n    ShieldPreparation,\n    CreateCreditPreparation,\n    TopUpCreditPreparation,\n    CancelCreditPreparation,\n} from \"./session/operation-types\";\nimport { TransactionPreparation } from \"./session/transaction-preparation\";\nimport { exportBroadcasterIntent } from \"./session/operation-protocol\";\nexport type PreparationIntent =\n    | { kind: \"transfer\"; options: TransferPreparation }\n    | { kind: \"shield\"; options: ShieldPreparation }\n    | { kind: \"create-credit\"; options: CreateCreditPreparation }\n    | { kind: \"top-up-credit\"; options: TopUpCreditPreparation }\n    | { kind: \"cancel-credit\"; options: CancelCreditPreparation };\nexport type BroadcasterFeeSource = \"public-funding\" | \"private-inputs\" | \"payout\";\nexport interface WithBroadcasterOptions {\n    maxFeeAmount: bigint;\n    feeSource?: BroadcasterFeeSource;\n    maxAttempts?: number;\n    /** Optional app-owned permit signing, requested once for the final gross funding amount. */\n    fundingPermit?: (request: {\n        payer: `0x${string}`;\n        amount: bigint;\n        tokenAddress: `0x${string}`;\n        protocolAddress: `0x${string}`;\n    }) => Promise<NonNullable<TransferPreparation[\"funding\"]>[\"permit\"]>;\n}\nexport async function prepareIntent(\n    runtime: PreparationRuntime<OperationPlan>,\n    intent: PreparationIntent\n): Promise<OperationPlan> {\n    const preparation = new TransactionPreparation(runtime);\n    switch (intent.kind) {\n        case \"transfer\":\n            return preparation.prepareTransfer(intent.options);\n        case \"shield\":\n            return preparation.prepareShield(intent.options);\n        case \"create-credit\":\n            return preparation.prepareCreateCredit(intent.options);\n        case \"top-up-credit\":\n            return preparation.prepareTopUpCredit(intent.options);\n        case \"cancel-credit\":\n            return preparation.prepareCancelCredit(intent.options);\n    }\n}\nexport async function prepareBroadcasterPlan(\n    plan: OperationPlan,\n    reprepare: (intent: PreparationIntent) => Promise<OperationPlan>,\n    client: BroadcasterClient,\n    options: WithBroadcasterOptions\n): Promise<{ plan: OperationPlan; quote: SignedBroadcasterQuote }> {\n    if (!plan.intent) throw new Error(\"operation has no supported preparation intent\");\n    const intent = structuredClone(plan.intent);\n    intent.options.deadline = plan.deadline;\n    const maxFee = options.maxFeeAmount;\n    const attempts = options.maxAttempts ?? 4;\n    if (typeof maxFee !== \"bigint\" || maxFee <= 0n || maxFee >= 1n << 128n)\n        throw new Error(\"maxFeeAmount must be a positive uint128\");\n    if (!Number.isInteger(attempts) || attempts < 1 || attempts > 16)\n        throw new Error(\"maxAttempts must be 1..16\");\n    const funding = \"funding\" in intent.options ? intent.options.funding : undefined;\n    let source =\n        options.feeSource ??\n        (intent.kind === \"cancel-credit\"\n            ? \"payout\"\n            : funding\n              ? \"public-funding\"\n              : \"private-inputs\");\n    if (![\"public-funding\", \"private-inputs\", \"payout\"].includes(source))\n        throw new Error(\"unsupported fee source\");\n    if (\n        intent.kind === \"cancel-credit\"\n            ? source !== \"payout\"\n            : source === \"payout\" || (intent.kind === \"shield\" && source !== \"public-funding\")\n    )\n        throw new Error(\"fee source is unavailable for this operation\");\n    if (source === \"public-funding\" && !funding)\n        throw new Error(\"public funding fee requires an explicit payer\");\n    const permitCallback = options.fundingPermit;\n    let schedule = await client.fee(plan.context.tokenAddress, exportBroadcasterIntent(plan).data);\n    let previousAmount = 0n;\n    for (let i = 0; i < attempts; i++) {\n        const minimum = BigInt(schedule.feeAmount);\n        const amount = minimum > previousAmount ? minimum : previousAmount;\n        const recipient = getAddress(schedule.feeRecipient) as `0x${string}`;\n        if (amount <= 0n || amount > maxFee || amount >= 1n << 128n || BigInt(recipient) === 0n)\n            throw new Error(\"broadcaster fee exceeds user limit or is invalid\");\n        // Prefer already available private change; never add a payer implicitly.\n        if (\n            options.feeSource === undefined &&\n            funding &&\n            plan.inputs.length > 0 &&\n            (intent.kind === \"transfer\" ||\n                intent.kind === \"create-credit\" ||\n                intent.kind === \"top-up-credit\")\n        ) {\n            const business =\n                intent.kind === \"transfer\"\n                    ? intent.options.outputs.reduce(\n                          (sum, output) => sum + output.amount,\n                          intent.options.withdrawal?.amount ?? 0n\n                      )\n                    : intent.kind === \"create-credit\"\n                      ? intent.options.amount\n                      : intent.options.additionalAmount;\n            const change =\n                plan.inputs.reduce((sum, input) => sum + input.note.amount, funding.amount) -\n                business;\n            source = change >= amount ? \"private-inputs\" : \"public-funding\";\n        }\n        if (\n            source === \"public-funding\" &&\n            funding?.permit &&\n            funding.permit.deadline !== 0n &&\n            !permitCallback\n        )\n            throw new Error(\n                \"existing permit cannot fund an increased amount; provide fundingPermit for final gross funding or approve separately\"\n            );\n        if (source === \"payout\" && amount >= plan.credit!.cancel!.amount)\n            throw new Error(\"fee must be less than the cancellation refund\");\n        const request = structuredClone(intent);\n        request.options.fee = { recipient, amount };\n        if (funding && \"funding\" in request.options) {\n            const signedFunding = { ...funding };\n            if (funding.authorization === \"caller\") {\n                delete signedFunding.sigNonce;\n                delete signedFunding.deadline;\n            }\n            request.options.funding = {\n                ...signedFunding,\n                amount: funding.amount + (source === \"public-funding\" ? amount : 0n),\n                authorization: \"signature\",\n            };\n        }\n        const next = await reprepare(request);\n        if (source === \"private-inputs\" && next.inputs.length === 0)\n            throw new Error(\"private-inputs fee requires private funds\");\n        const recalculated = await client.fee(\n            plan.context.tokenAddress,\n            exportBroadcasterIntent(next).data\n        );\n        const required = BigInt(recalculated.feeAmount);\n        if (\n            getAddress(recalculated.feeRecipient) !== recipient ||\n            required <= 0n ||\n            required > maxFee\n        )\n            throw new Error(\"broadcaster fee exceeds user limit or recipient changed\");\n        if (amount >= required) {\n            let final = next;\n            if (permitCallback) {\n                if (!funding || !(\"funding\" in request.options))\n                    throw new Error(\"fundingPermit requires public funding\");\n                const permit = await permitCallback({\n                    payer: funding.payer,\n                    amount: request.options.funding!.amount,\n                    tokenAddress: plan.context.tokenAddress,\n                    protocolAddress: plan.context.protocolAddress,\n                });\n                if (!permit) throw new Error(\"fundingPermit did not return a permit\");\n                request.options.funding = { ...request.options.funding!, permit };\n                final = await reprepare(request);\n                const permitted = await client.fee(\n                    plan.context.tokenAddress,\n                    exportBroadcasterIntent(final).data\n                );\n                if (\n                    getAddress(permitted.feeRecipient) !== recipient ||\n                    BigInt(permitted.feeAmount) > amount\n                )\n                    throw new Error(\"permit changed the required fee; prepare again\");\n            }\n            final.intent = structuredClone(intent);\n            return {\n                plan: final,\n                quote: await client.quote(exportBroadcasterIntent(final).data, {\n                    chainId: final.context.chainId,\n                    protocol: final.context.protocolAddress,\n                }),\n            };\n        }\n        previousAmount = amount;\n        schedule = recalculated;\n    }\n    throw new Error(\"broadcaster fee did not stabilize within the preparation limit\");\n}\n"],"mappings":"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","names":[]}