@owney/sdk 0.7.25-beta.16 → 0.7.25-beta.17

package/dist/index.d.cts

@@ -145,6 +145,9 @@ interface IAgent {
     endFundingBalanceRefresh?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingHistory?(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getFundingWallet?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;
+    /** Verify the displayed remaining balance after a receipt-confirmed payout.
+     * Undefined means unknown; never substitute a failed read with zero. */
+    verifyWithdrawalBalance?(state: ConnectionState, evidence: FundingEvidence, balance: AgentBalance): Promise<AssetReadMetadata | undefined>;
     /** Read-only chain proof when indexed withdrawal components are incomplete.
      * Returns raw owner-withdrawable units; unavailable proof must throw.
      * minimumAmount is the raw liquidity required from this agent for a typed
@@ -381,6 +384,12 @@ interface AssetReadMetadata {
     snapshotId?: string;
     blockNumber?: string;
     netDepositsRaw?: string;
+    /** Display-only agreement with a post-payout read. Does not prove that
+     * provider accounting, history or allocations include the transaction. */
+    withdrawalCheck?: {
+        txHash: string;
+        blockNumber: string;
+    };
     positionsStatus: "available" | "unavailable";
 }
 interface OwneyDepositResult {
@@ -709,6 +718,7 @@ declare class OwneySDK {
     private cachedSponsoredCallsCallbacks;
     private readonly agentReads;
     private readonly recoveredFundingReads;
+    private fundingBalanceChecks;
     private readonly activationChecks;
     private readAgent;
     private initializingAgentsPromise;
@@ -882,6 +892,9 @@ declare class OwneySDK {
     /** Whether a foreground deposit can resume the same signed batch, never a
      * fresh authorization. The batch rail independently rechecks the exact plan. */
     canResumePendingDeposit(evidences: FundingEvidence[], amount: string): Promise<boolean>;
+    /** Optional post-payout display proof; receipt verification and the provider
+     * adapter must agree before attaching it to this exact balance object. */
+    verifyWithdrawalBalance(evidence: FundingEvidence, balance: AgentBalance): Promise<AgentBalance>;
     /** A display acknowledgement controls polling only; it never confirms a financial outcome. */
     endFundingBalanceRefresh(evidence: FundingEvidence, read: AssetReadMetadata): boolean;
     /** History lookup for receipt recovery; adapters may not authenticate or sign here. */
@@ -1086,6 +1099,8 @@ declare class YieldseekerAgent implements IAgent {
     private readonly transactionExecutor?;
     private readonly unwindReceiptWaiter?;
     private readonly agentContexts;
+    private readonly balanceContexts;
+    private readonly balanceVaults;
     private readonly users;
     private readonly pendingAgents;
     private readonly pendingWalletContexts;
@@ -1124,6 +1139,7 @@ declare class YieldseekerAgent implements IAgent {
     private readWithdrawalPositions;
     private resolveWithdrawalLiquidity;
     getBalances(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<AgentBalance>;
+    verifyWithdrawalBalance(state: ConnectionState, evidence: FundingEvidence, balance: AgentBalance): Promise<AssetReadMetadata | undefined>;
     invalidateFundingRead(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, refreshUntil?: number): void;
     endFundingBalanceRefresh(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingWallet(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;

package/dist/index.d.ts

@@ -145,6 +145,9 @@ interface IAgent {
     endFundingBalanceRefresh?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingHistory?(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
     getFundingWallet?(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;
+    /** Verify the displayed remaining balance after a receipt-confirmed payout.
+     * Undefined means unknown; never substitute a failed read with zero. */
+    verifyWithdrawalBalance?(state: ConnectionState, evidence: FundingEvidence, balance: AgentBalance): Promise<AssetReadMetadata | undefined>;
     /** Read-only chain proof when indexed withdrawal components are incomplete.
      * Returns raw owner-withdrawable units; unavailable proof must throw.
      * minimumAmount is the raw liquidity required from this agent for a typed
@@ -381,6 +384,12 @@ interface AssetReadMetadata {
     snapshotId?: string;
     blockNumber?: string;
     netDepositsRaw?: string;
+    /** Display-only agreement with a post-payout read. Does not prove that
+     * provider accounting, history or allocations include the transaction. */
+    withdrawalCheck?: {
+        txHash: string;
+        blockNumber: string;
+    };
     positionsStatus: "available" | "unavailable";
 }
 interface OwneyDepositResult {
@@ -709,6 +718,7 @@ declare class OwneySDK {
     private cachedSponsoredCallsCallbacks;
     private readonly agentReads;
     private readonly recoveredFundingReads;
+    private fundingBalanceChecks;
     private readonly activationChecks;
     private readAgent;
     private initializingAgentsPromise;
@@ -882,6 +892,9 @@ declare class OwneySDK {
     /** Whether a foreground deposit can resume the same signed batch, never a
      * fresh authorization. The batch rail independently rechecks the exact plan. */
     canResumePendingDeposit(evidences: FundingEvidence[], amount: string): Promise<boolean>;
+    /** Optional post-payout display proof; receipt verification and the provider
+     * adapter must agree before attaching it to this exact balance object. */
+    verifyWithdrawalBalance(evidence: FundingEvidence, balance: AgentBalance): Promise<AgentBalance>;
     /** A display acknowledgement controls polling only; it never confirms a financial outcome. */
     endFundingBalanceRefresh(evidence: FundingEvidence, read: AssetReadMetadata): boolean;
     /** History lookup for receipt recovery; adapters may not authenticate or sign here. */
@@ -1086,6 +1099,8 @@ declare class YieldseekerAgent implements IAgent {
     private readonly transactionExecutor?;
     private readonly unwindReceiptWaiter?;
     private readonly agentContexts;
+    private readonly balanceContexts;
+    private readonly balanceVaults;
     private readonly users;
     private readonly pendingAgents;
     private readonly pendingWalletContexts;
@@ -1124,6 +1139,7 @@ declare class YieldseekerAgent implements IAgent {
     private readWithdrawalPositions;
     private resolveWithdrawalLiquidity;
     getBalances(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<AgentBalance>;
+    verifyWithdrawalBalance(state: ConnectionState, evidence: FundingEvidence, balance: AgentBalance): Promise<AssetReadMetadata | undefined>;
     invalidateFundingRead(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, refreshUntil?: number): void;
     endFundingBalanceRefresh(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, read: AssetReadMetadata): boolean;
     getFundingWallet(state: ConnectionState, chainId: number, asset: OwneySupportedTokens): Promise<string>;