@kasufinance/kasu-sdk 2.6.0 → 2.7.0

package/dist/facade/flows.js

@@ -0,0 +1,116 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { DepositFlow, WithdrawFlow, } from '../flows';
+import { READ_ONLY_MESSAGE } from './read-only';
+/**
+ * Builds `DepositFlow` / `WithdrawFlow` instances wired to THIS Kasu instance:
+ * its chain's stable token, its `LendingPoolManager`, its signer.
+ *
+ * ```ts
+ * const flow = kasu.connect(signer).flows.deposit({
+ *   signMessage: (m) => signer.signMessage(m),
+ *   generateContract: (req) => postToMyProxy(req),
+ *   getKycSignature: (p) => postToMyBackend(p),
+ * });
+ * ```
+ *
+ * A flow built from a read-only instance constructs fine and reads fine — the
+ * write ports throw `READ_ONLY_MESSAGE` when the run reaches them, exactly as
+ * `kasu.deposits.deposit` does. Constructing is not the mistake; submitting is.
+ *
+ * It holds the `DepositsFacade` and NOTHING the facade already owns: no
+ * `UserLending`, no chain id, no signer. Two paths to one behaviour is how the
+ * KYC params a flow built came to differ from the ones `kasu.deposits`
+ * built — the same class of drift the flows themselves exist to end.
+ */
+export class FlowsFacade {
+    constructor(_deposits, 
+    /**
+     * The chain's stable token, bound to whatever the Kasu instance holds.
+     * A factory rather than a contract: it is one `new Contract`, and a
+     * cached binding would outlive the config it was built from.
+     */
+    _erc20, 
+    /** The read-only flag `Kasu` already computed — never re-derived here. */
+    _isReadOnly, 
+    /**
+     * The ERC-20 spender every deposit run approves: this chain's
+     * `LendingPoolManager`, which is the only contract the default deposit
+     * port calls. Passed to the flow so a consumer never has to hand-wire
+     * an address whose only wrong value grants an approval to the wrong
+     * contract.
+     */
+    _spender) {
+        this._deposits = _deposits;
+        this._erc20 = _erc20;
+        this._isReadOnly = _isReadOnly;
+        this._spender = _spender;
+    }
+    /**
+     * A deposit pipeline. `readAllowance`, `approve`, `deposit` and
+     * `buildKycParams` default to the SDK's own implementations; pass any of
+     * them to override (kasu-ui approves through its sponsored-gas path, for
+     * one).
+     *
+     * Each default is applied per key with `??`, not by spreading `ports` over
+     * them: `{ ...defaults, ...ports }` lets an EXPLICITLY undefined value
+     * delete the default it was meant to keep, and
+     * `approve: sponsoredGas ? sponsoredApprove : undefined` is exactly how a
+     * consumer writes a conditional override.
+     */
+    deposit(ports, opts) {
+        var _a, _b, _c, _d, _e;
+        return new DepositFlow({
+            signMessage: ports.signMessage,
+            generateContract: ports.generateContract,
+            getKycSignature: ports.getKycSignature,
+            buildKycParams: (_a = ports.buildKycParams) !== null && _a !== void 0 ? _a : ((userAddress) => this._deposits.buildKycParams(userAddress)),
+            readAllowance: (_b = ports.readAllowance) !== null && _b !== void 0 ? _b : ((owner, spender) => this._erc20().allowance(owner, spender)),
+            approve: (_c = ports.approve) !== null && _c !== void 0 ? _c : ((spender, amount) => __awaiter(this, void 0, void 0, function* () {
+                this._assertWritable();
+                // The EXACT amount the flow asked for. Nothing here
+                // rounds it up, and nothing here substitutes
+                // MaxUint256.
+                return yield this._erc20().approve(spender, amount);
+            })),
+            deposit: (_d = ports.deposit) !== null && _d !== void 0 ? _d : ((params) => this._deposits.deposit(params)),
+            now: ports.now,
+        }, {
+            contractTtlMs: opts === null || opts === void 0 ? void 0 : opts.contractTtlMs,
+            // Per key here too, for the same reason the ports are: an
+            // explicit `spender: undefined` must not delete the default.
+            spender: (_e = opts === null || opts === void 0 ? void 0 : opts.spender) !== null && _e !== void 0 ? _e : this._spender,
+        });
+    }
+    /**
+     * A withdrawal pipeline. Both write ports and `buildKycParams` default to
+     * this instance; supplying `getKycSignature` turns the KYC pre-check on.
+     * Defaults are applied per key, for the reason `deposit()` gives.
+     */
+    withdraw(ports = {}) {
+        var _a, _b, _c;
+        return new WithdrawFlow({
+            buildKycParams: (_a = ports.buildKycParams) !== null && _a !== void 0 ? _a : ((userAddress) => this._deposits.buildKycParams(userAddress)),
+            getKycSignature: ports.getKycSignature,
+            withdraw: (_b = ports.withdraw) !== null && _b !== void 0 ? _b : ((params) => this._deposits.withdraw({
+                poolId: params.poolId,
+                trancheId: params.trancheId,
+                amount: params.amount,
+            })),
+            withdrawMax: (_c = ports.withdrawMax) !== null && _c !== void 0 ? _c : ((poolId, trancheId, userAddress) => this._deposits.withdrawMax(poolId, trancheId, userAddress)),
+        });
+    }
+    _assertWritable() {
+        if (this._isReadOnly) {
+            throw new Error(READ_ONLY_MESSAGE);
+        }
+    }
+}
+//# sourceMappingURL=flows.js.map

package/dist/facade/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/facade/flows.ts"],"names":[],"mappings":"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"}

package/dist/facade/index.d.ts

@@ -2,6 +2,9 @@ export { Kasu } from './kasu';
 export { StrategiesFacade } from './strategies';
 export { DepositsFacade } from './deposits';
 export { PortfolioFacade } from './user-portfolio';
+export { FlowsFacade } from './flows';
+export type { DepositFlowPortOverrides, WithdrawFlowPortOverrides, } from './flows';
+export { READ_ONLY_MESSAGE } from './read-only';
 export { CHAIN_CONFIGS } from './chain-configs';
 export { fetchUnusedPoolIds } from './unused-pool-ids';
 export type { SupportedChain, ChainConfigEntry, StableAsset, KasuOptions, Strategy, StrategyTranche, FixedTermOption, DepositParams, WithdrawParams, DepositLimits, KycParams, UserPositions, PlatformStats, } from './types';

package/dist/facade/index.js

@@ -4,6 +4,9 @@ export { Kasu } from './kasu';
 export { StrategiesFacade } from './strategies';
 export { DepositsFacade } from './deposits';
 export { PortfolioFacade } from './user-portfolio';
+export { FlowsFacade } from './flows';
+// The one refusal every write path shares
+export { READ_ONLY_MESSAGE } from './read-only';
 // Chain configurations
 export { CHAIN_CONFIGS } from './chain-configs';
 // Directus-backed helpers (I/O — not part of `domain/`)

package/dist/facade/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/facade/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,gDAAgD;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,wDAAwD;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/facade/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,gDAAgD;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAMtC,0CAA0C;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,wDAAwD;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/facade/kasu.d.ts

@@ -2,14 +2,16 @@ import { Provider } from '@ethersproject/providers';
 import { Signer } from 'ethers';
 import { KasuSdk } from '../kasu-sdk';
 import { DepositsFacade } from './deposits';
+import { FlowsFacade } from './flows';
 import { StrategiesFacade } from './strategies';
 import { ChainConfigEntry, KasuOptions } from './types';
 import { PortfolioFacade } from './user-portfolio';
 /**
  * High-level entry point for external integrators.
  *
- * Provides three domain facades — `strategies`, `deposits`, `portfolio` — and
- * exposes the underlying `KasuSdk` services via `.services` for power-users.
+ * Provides four domain facades — `strategies`, `deposits`, `portfolio`,
+ * `flows` — and exposes the underlying `KasuSdk` services via `.services` for
+ * power-users.
  *
  * ```ts
  * import { Kasu } from '@kasufinance/kasu-sdk';
@@ -33,6 +35,8 @@ export declare class Kasu {
     readonly deposits: DepositsFacade;
     /** User positions, yields, transaction history. */
     readonly portfolio: PortfolioFacade;
+    /** Headless deposit / withdraw state machines. */
+    readonly flows: FlowsFacade;
     private readonly _sdk;
     private readonly _chainConfig;
     private readonly _signerOrProvider;

package/dist/facade/kasu.js

@@ -1,15 +1,18 @@
 import { providers, Signer } from 'ethers';
+import { IERC20MetadataAbi__factory } from '../contracts';
 import { KasuSdk } from '../kasu-sdk';
 import { SdkConfig } from '../sdk-config';
 import { CHAIN_CONFIGS } from './chain-configs';
 import { DepositsFacade } from './deposits';
+import { FlowsFacade } from './flows';
 import { StrategiesFacade } from './strategies';
 import { PortfolioFacade } from './user-portfolio';
 /**
  * High-level entry point for external integrators.
  *
- * Provides three domain facades — `strategies`, `deposits`, `portfolio` — and
- * exposes the underlying `KasuSdk` services via `.services` for power-users.
+ * Provides four domain facades — `strategies`, `deposits`, `portfolio`,
+ * `flows` — and exposes the underlying `KasuSdk` services via `.services` for
+ * power-users.
  *
  * ```ts
  * import { Kasu } from '@kasufinance/kasu-sdk';
@@ -33,8 +36,13 @@ export class Kasu {
         this._signerOrProvider = signerOrProvider;
         this._configOverrides = configOverrides;
         this.strategies = new StrategiesFacade(sdk.DataService, sdk.UserLending);
-        this.deposits = new DepositsFacade(sdk.UserLending, chainConfig.chainId.toString(), !Signer.isSigner(signerOrProvider));
+        // Derived ONCE and handed to every facade that needs it. Each of them
+        // re-deriving `Signer.isSigner` is how two facades come to disagree
+        // about whether the same instance can write.
+        const isReadOnly = !Signer.isSigner(signerOrProvider);
+        this.deposits = new DepositsFacade(sdk.UserLending, chainConfig.chainId.toString(), isReadOnly);
         this.portfolio = new PortfolioFacade(sdk.DataService, sdk.UserLending, sdk.Portfolio);
+        this.flows = new FlowsFacade(this.deposits, () => erc20Of(chainConfig, signerOrProvider), isReadOnly, chainConfig.contracts.LendingPoolManager);
     }
     /**
      * Create a Kasu instance with built-in chain config.
@@ -166,6 +174,23 @@ function rpcUrlsOf(chainConfig) {
     var _a;
     return (_a = chainConfig.rpcUrls) !== null && _a !== void 0 ? _a : [];
 }
+/**
+ * The chain's stable token, bound to whatever this instance holds.
+ *
+ * Built per call rather than cached: it is one `new Contract`, and a cached
+ * binding would outlive the signer a `connect()` replaced. A config with no
+ * `stableAsset` (a hand-written entry from before 2.5.0) throws here rather
+ * than inside ethers, naming the two ports that make the flow work without
+ * one.
+ */
+function erc20Of(chainConfig, signerOrProvider) {
+    var _a;
+    const address = (_a = stableAssetOf(chainConfig)) === null || _a === void 0 ? void 0 : _a.address;
+    if (!address) {
+        throw new Error('Kasu: this chain config has no stableAsset; pass readAllowance and approve ports explicitly');
+    }
+    return IERC20MetadataAbi__factory.connect(address, signerOrProvider);
+}
 /**
  * The read-only provider used when the caller passes no `signerOrProvider`.
  *

package/dist/facade/kasu.js.map

@@ -1 +1 @@
-{"version":3,"file":"kasu.js","sourceRoot":"","sources":["../../src/facade/kasu.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kasu.js","sourceRoot":"","sources":["../../src/facade/kasu.ts"],"names":[],"mappings":"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"}

package/dist/facade/read-only.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The refusal every write path shares when the instance holds a Provider
+ * rather than a Signer.
+ *
+ * One constant, because the message's job is to name the fix — `kasu.connect`
+ * — and three near-identical wordings across the facades would be three
+ * different pieces of advice for one problem. ethers' own
+ * "sending a transaction requires a signer" arrives several frames deeper,
+ * after the params have been encoded, and says nothing about how to get a
+ * signer onto THIS object.
+ */
+export declare const READ_ONLY_MESSAGE = "Kasu: this instance is read-only; call kasu.connect(signer) first";

package/dist/facade/read-only.js

@@ -0,0 +1,13 @@
+/**
+ * The refusal every write path shares when the instance holds a Provider
+ * rather than a Signer.
+ *
+ * One constant, because the message's job is to name the fix — `kasu.connect`
+ * — and three near-identical wordings across the facades would be three
+ * different pieces of advice for one problem. ethers' own
+ * "sending a transaction requires a signer" arrives several frames deeper,
+ * after the params have been encoded, and says nothing about how to get a
+ * signer onto THIS object.
+ */
+export const READ_ONLY_MESSAGE = 'Kasu: this instance is read-only; call kasu.connect(signer) first';
+//# sourceMappingURL=read-only.js.map

package/dist/facade/read-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only.js","sourceRoot":"","sources":["../../src/facade/read-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC1B,mEAAmE,CAAC"}

package/dist/flows/deposit-flow.d.ts

@@ -0,0 +1,301 @@
+import { BigNumber } from 'ethers';
+import { GenerateContractResponse } from '../domain/loan-contract';
+import { DepositParams, KycParams } from '../facade/types';
+import { Flow } from './flow';
+import { WaitableTransaction } from './observable';
+/**
+ * The KYC-gated deposit pipeline, headless.
+ *
+ * This is the state machine kasu-ui and kasu-mobile each hand-wrote and then
+ * had to keep in step by hand: sign an auth message, generate the loan
+ * agreement, park while the lender reads it, sign it, approve the EXACT amount,
+ * fetch the KYC signature, submit, wait. Two implementations of one money path
+ * is one too many, so it lives here once and each application drives it from
+ * its own UI.
+ *
+ * **No React, no copy, no I/O of its own.** Every side effect is an injected
+ * port and every observable state is a code — `{ step: 'approve', reason:
+ * 'cancelled' }`, never "USDC approval was cancelled in your wallet". The
+ * applications keep their own `DEPOSIT_STEP_ERRORS` tables and map the codes to
+ * their words, in their design system and their language. Nothing in this file
+ * may be shown to a lender.
+ *
+ * ## Order, and why each step is where it is
+ *
+ * 1. **Allowance pre-check** — before anything is signed, because it decides
+ *    `approvalRequired`, which decides `stepTotal`. A badge that said "3 of 4"
+ *    and then silently became "3 of 3" would be describing a pipeline the
+ *    lender is not in. A failed read assumes an approve IS needed: the safe
+ *    default is a redundant approval, never a reverted deposit.
+ * 2. **`generating-sign`** — the lender signs the auth message
+ *    (`buildLoanAgreementSignMessage`, or the legacy builder). kasu-backend
+ *    reconstructs that string byte-for-byte to verify the signature.
+ * 3. **`generating-fetch`** — the agreements service returns the contract.
+ * 4. **`awaiting-accept`** — the run PARKS on a promise the consumer settles
+ *    with `acceptContract()` or `declineContract()`. This is the only point at
+ *    which a lender is committing to anything.
+ * 5. **`accepting-sign`** — the acceptance signature, which becomes the
+ *    on-chain `depositData` via `encodeDepositData`.
+ * 6. **The 5-minute TTL guard** — checked AFTER the accept, because that is
+ *    where the idling happens. An expired agreement is refused here rather than
+ *    broadcast as a transaction that cannot succeed.
+ * 7. **`approve`** — the EXACT amount, never `MaxUint256`. House rule, and it
+ *    is why the allowance drops to zero after every deposit and why step 1
+ *    reads it fresh rather than trusting a cache.
+ * 8. **`request-sign` / `request-confirm`** — KYC signature, then the deposit,
+ *    then the receipt.
+ *
+ * ## Failure codes
+ *
+ * A wallet rejection (`isUserRejected`) is `'cancelled'` — the lender changed
+ * their mind, and telling them something broke would be a lie. Only a WALLET
+ * call is ever classified that way: the HTTP ports are always `'failed'`,
+ * because a backend that words a refusal "declined" did not involve the
+ * lender's wallet. A reverted gas estimate on the request step
+ * (`isUnpredictableGas`) is `'insufficient-balance'` — nothing was refused, the
+ * transaction simply cannot succeed as composed. Everything else is `'failed'`
+ * and carries the original error for the consumer's crash reporter.
+ *
+ * ```ts
+ * const flow = new DepositFlow(ports);
+ * const stop = flow.subscribe((s) => render(s));
+ * await flow.start({ poolId, trancheId, amount, userAddress, ... });
+ * // …the consumer shows `flow.state.contract` and calls:
+ * await flow.acceptContract();
+ * ```
+ */
+/**
+ * Where the run is. `success`, `declined` and `error` are terminal; everything
+ * else is in flight.
+ */
+export type DepositPhase = 'idle' | 'generating-sign' | 'generating-fetch' | 'awaiting-accept' | 'accepting-sign' | 'approve' | 'request-sign' | 'request-confirm' | 'success' | 'declined' | 'error';
+/**
+ * The four steps a lender sees as a badge. `approve` drops out of the sequence
+ * when the allowance already covers the deposit, which is why `stepIndex` and
+ * `stepTotal` are published rather than derived by each consumer.
+ */
+export type DepositStep = 'generate' | 'confirm' | 'approve' | 'request';
+/**
+ * Why a run did not reach `success`, as a code plus the step it happened on.
+ *
+ * The consumer maps this to its own words. `error` carries the underlying
+ * throw for a crash reporter — a `cancelled` and a `contract-expired` do not,
+ * because neither is a fault worth reporting.
+ */
+export type DepositFailure = {
+    step: DepositStep;
+    reason: 'cancelled';
+} | {
+    step: DepositStep;
+    reason: 'failed';
+    error: unknown;
+} | {
+    step: 'request';
+    reason: 'insufficient-balance';
+    error: unknown;
+} | {
+    step: 'request';
+    reason: 'contract-expired';
+};
+export type { WaitableTransaction };
+/** What the KYC signing service hands back. */
+export interface KycSignature {
+    signature: string;
+    blockExpiration: number | string;
+}
+/**
+ * The `/contract/generate` body, assembled by the flow and posted by the
+ * consumer's own port — through its server-side proxy (kasu-ui) or straight to
+ * the agreements service (kasu-mobile). The SDK never makes the call itself and
+ * never learns the URL or the key.
+ */
+export interface GenerateContractRequest {
+    /**
+     * The lender's address, LOWERCASED. The legacy message embeds this casing
+     * and kasu-backend rebuilds the string from the body, so the two must
+     * agree.
+     */
+    address: string;
+    /** Signature over `signedMessage`. */
+    signature: string;
+    /** ms-epoch. The same value `signedMessage` states — do not re-clock it. */
+    timestamp: number;
+    /**
+     * The exact text that was signed. Sent so a consumer can log or assert on
+     * it; the backend rebuilds it from the other fields rather than trusting
+     * this one.
+     */
+    signedMessage: string;
+    poolId: string;
+    trancheId: string;
+    /** `'0'` for a variable-rate deposit. */
+    fixedTermConfigId: string;
+    /**
+     * The deposit in DISPLAY units, forwarded verbatim from
+     * `DepositFlowInput.depositAmount`. kasu-backend cross-checks it against
+     * the leading number of `amountLabel`.
+     */
+    depositAmount?: number;
+    /** The four human-readable fields, present only on the new format. */
+    strategyName?: string;
+    region?: string;
+    optionName?: string;
+    amountLabel?: string;
+}
+/**
+ * The human-readable `/contract/generate` format (BD deck slide 19): the lender
+ * signs a statement naming the strategy, region, option and amount.
+ *
+ * `amountLabel` must be derived from the same value as `depositAmount` — the
+ * backend refuses a message that states an amount other than the one being
+ * executed. The SDK does not format it, because formatting is the
+ * application's (and its locale's) business.
+ */
+export interface LoanAgreementRequest {
+    format: 'loan-agreement';
+    strategyName: string;
+    region: string;
+    optionName: string;
+    amountLabel: string;
+}
+/**
+ * The legacy `I request contract content for {address} at {timestamp}.`
+ * format, which kasu-backend still accepts and `/contract/resolve` has no
+ * alternative to.
+ */
+export interface LegacyContractRequest {
+    format: 'legacy';
+}
+export type ContractMessageRequest = LoanAgreementRequest | LegacyContractRequest;
+/**
+ * Every side effect the pipeline needs, injected.
+ *
+ * `kasu.flows.deposit()` fills `readAllowance`, `approve`, `deposit` and
+ * `buildKycParams` from the SDK's own signer-bound implementations; the three
+ * that reach the consumer's own backend or wallet have no sensible default and
+ * are always supplied by the application.
+ */
+export interface DepositPorts {
+    /** EIP-191 personal sign. Rejects when the lender refuses. */
+    signMessage(message: string): Promise<string>;
+    /** POST the generate request; resolve with the agreements service's reply. */
+    generateContract(req: GenerateContractRequest): Promise<GenerateContractResponse>;
+    /** Build the Nexera KYC params. Defaults to `kasu.deposits.buildKycParams`. */
+    buildKycParams(userAddress: `0x${string}`): KycParams | Promise<KycParams>;
+    /** Exchange those params for a signature at the consumer's own backend. */
+    getKycSignature(params: KycParams): Promise<KycSignature>;
+    /** ERC-20 `allowance(owner, spender)`, in base units. */
+    readAllowance(owner: string, spender: string): Promise<BigNumber>;
+    /** ERC-20 `approve(spender, amount)`. The flow only ever passes the EXACT amount. */
+    approve(spender: string, amount: BigNumber): Promise<WaitableTransaction>;
+    /** `requestDepositWithKyc`. Defaults to `kasu.deposits.deposit`. */
+    deposit(params: DepositParams): Promise<WaitableTransaction>;
+    /** ms-epoch clock. Defaults to `Date.now`; injected so the TTL is testable. */
+    now?(): number;
+}
+/** Construction options. `kasu.flows.deposit()` fills `spender` in. */
+export interface DepositFlowOptions {
+    /** Agreement validity window; defaults to `CONTRACT_TTL_MS`. */
+    contractTtlMs?: number;
+    /**
+     * The ERC-20 spender every run approves and deposits through, when the
+     * input does not name one. `kasu.flows.deposit()` passes this chain's
+     * `contracts.LendingPoolManager`, which is the only contract the default
+     * deposit port calls.
+     */
+    spender?: string;
+}
+export interface DepositFlowInput {
+    poolId: string;
+    trancheId: string;
+    /** The deposit in BASE units (6dp for USDC and AUDD). */
+    amount: BigNumber;
+    /** `'0'` for a variable-rate deposit. */
+    fixedTermConfigId: string;
+    userAddress: `0x${string}`;
+    /**
+     * The ERC-20 spender, when it is NOT this chain's `LendingPoolManager`.
+     *
+     * Leave it out: `kasu.flows.deposit()` defaults it from the chain config,
+     * and the default deposit port calls no other contract. It exists for a
+     * consumer that replaced the `deposit` port with one that spends
+     * somewhere else — a wrong spender is an approval granted to the wrong
+     * contract and then a revert diagnosed as `insufficient-balance`.
+     */
+    spender?: string;
+    /** Which signed-message format to use, and its fields. */
+    contractMessage: ContractMessageRequest;
+    /**
+     * The deposit in DISPLAY units, for the generate request only.
+     *
+     * NOT derived from `amount`: turning base units back into a display number
+     * is formatting, and formatting is the application's job — it is also the
+     * application that produced `amountLabel`, and kasu-backend refuses the two
+     * if they disagree. Pass the same value both were built from.
+     */
+    depositAmount?: number;
+}
+export interface DepositState {
+    phase: DepositPhase;
+    /** The step `phase` belongs to; `null` only while idle. */
+    step: DepositStep | null;
+    /** 1-based badge position of `step`; `0` while idle. */
+    stepIndex: number;
+    /** `4`, or `3` when the allowance already covers the deposit. */
+    stepTotal: number;
+    /** Whether the approve step is in scope for this run. */
+    approvalRequired: boolean;
+    /** The generated agreement, from `generating-fetch` onwards. */
+    contract: GenerateContractResponse | null;
+    /** Set with `phase: 'error'`, cleared by `reset()`. */
+    failure: DepositFailure | null;
+}
+/** Generated agreements are valid for five minutes upstream. */
+export declare const CONTRACT_TTL_MS: number;
+/** What a run without a spender, from either source, fails with. */
+export declare const NO_SPENDER_MESSAGE = "DepositFlow: no ERC-20 spender; build the flow with kasu.flows.deposit() or pass `spender` on the input";
+export declare class DepositFlow extends Flow<DepositState, DepositFlowInput> {
+    private readonly _ports;
+    private readonly _ttlMs;
+    private readonly _defaultSpender;
+    private readonly _now;
+    /**
+     * The accept handshake. The run parks on this promise; `acceptContract`,
+     * `declineContract` and `reset` each settle it with an `AcceptOutcome`.
+     * Cleared the moment it settles so a stale resolver from an abandoned run
+     * can never leak into the next one.
+     */
+    private _accept;
+    /**
+     * The run token that is between `acceptContract()` and the wallet
+     * settling, or `null`.
+     *
+     * A token rather than a boolean, because the flag has to belong to the RUN
+     * that set it: after `reset()` out of a wallet prompt that never answers,
+     * the abandoned run's `finally` may not arrive for minutes, and a boolean
+     * left standing refuses both Accept and Decline on every run after it.
+     * A stale token simply is not the current generation.
+     */
+    private _acceptingFor;
+    constructor(_ports: DepositPorts, opts?: DepositFlowOptions);
+    /**
+     * Sign the agreement and resume the parked run. A no-op when nothing is
+     * parked, so a double tap cannot sign twice.
+     */
+    acceptContract(): Promise<void>;
+    /**
+     * Back out of the agreement. The run ends on `declined` — a legitimate
+     * choice, not a failure, and `state.failure` stays null.
+     *
+     * Ignored once `acceptContract()` has opened the wallet: an agreement in
+     * the middle of being signed cannot also be refused. `reset()` is the way
+     * out of a prompt that never answers.
+     */
+    declineContract(): void;
+    /** True only while THIS generation is waiting on the acceptance signature. */
+    private _isAccepting;
+    /** `reset()`: unpark the abandoned run and drop its handshake. */
+    protected _onAbandon(): void;
+    protected _run(input: DepositFlowInput, token: number): Promise<void>;
+    private _fail;
+}