@trufnetwork/sdk-js 0.6.0 → 0.6.1

package/dist/cjs/client/client.cjs

@@ -341,6 +341,25 @@ var BaseTNClient = class {
     const action = this.loadAction();
     return action.getWithdrawalProof(bridgeIdentifier, walletAddress);
   }
+  /**
+   * Retrieves the transaction history for a wallet on a specific bridge.
+   *
+   * @param bridgeIdentifier - The name of the bridge instance (e.g., "hoodi_tt", "sepolia_bridge")
+   * @param walletAddress - The wallet address to query
+   * @param limit - Max number of records to return (default 20)
+   * @param offset - Number of records to skip (default 0)
+   * @returns Promise resolving to an array of BridgeHistory records
+   *
+   * @example
+   * ```typescript
+   * const history = await client.getHistory("sepolia_bridge", "0x123...");
+   * console.log(history);
+   * ```
+   */
+  async getHistory(bridgeIdentifier, walletAddress, limit = 20, offset = 0) {
+    const action = this.loadAction();
+    return action.getHistory(bridgeIdentifier, walletAddress, limit, offset);
+  }
   /**
    * Gets taxonomies for specific streams in batch.
    * High-level wrapper for ComposedAction.getTaxonomiesForStreams()

package/dist/cjs/client/client.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/client.ts"],
-  "sourcesContent": ["import { Client, KwilSigner, NodeKwil, WebKwil, Types, EnvironmentType } from \"@trufnetwork/kwil-js\";\nimport { ComposedAction, ListTaxonomiesByHeightParams, GetTaxonomiesForStreamsParams, TaxonomyQueryResult } from \"../contracts-api/composedAction\";\nimport { deployStream } from \"../contracts-api/deployStream\";\nimport { deleteStream } from \"../contracts-api/deleteStream\";\nimport { PrimitiveAction } from \"../contracts-api/primitiveAction\";\nimport { Action, ListMetadataByHeightParams, MetadataQueryResult } from \"../contracts-api/action\";\nimport { StreamType } from \"../contracts-api/contractValues\";\nimport { WithdrawalProof } from \"../types/bridge\";\nimport { StreamLocator, TNStream } from \"../types/stream\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { StreamId } from \"../util/StreamId\";\nimport { listStreams } from \"./listStreams\";\nimport { getLastTransactions } from \"./getLastTransactions\";\nimport { RoleManagement } from \"../contracts-api/roleManagement\";\nimport { AttestationAction } from \"../contracts-api/attestationAction\";\nimport { TransactionAction } from \"../contracts-api/transactionAction\";\nimport { OrderbookAction } from \"../contracts-api/orderbookAction\";\nimport { OwnerIdentifier } from \"../types/role\";\n\nexport interface SignerInfo {\n  // we need to have the address upfront to create the KwilSigner, instead of relying on the signer to return it asynchronously\n  address: string;\n  signer: Types.EthSigner;\n}\n\nexport type TNClientOptions = {\n  endpoint: string;\n  signerInfo: SignerInfo;\n} & Omit<Types.KwilConfig, \"kwilProvider\">;\n\nexport interface ListStreamsInput {\n    dataProvider?: string;\n    limit?: number;\n    offset?: number;\n    orderBy?: string;\n    blockHeight?: number;\n}\n\n/**\n * @param dataProvider optional address; when omitted or null, returns for all providers\n * @param limitSize max rows to return (default 6, max 100)\n */\nexport interface GetLastTransactionsInput {\n  dataProvider?: string;\n  limitSize?: number;\n}\n\nexport abstract class BaseTNClient<T extends EnvironmentType> {\n  protected kwilClient: Types.Kwil<T> | undefined;\n  protected signerInfo: SignerInfo;\n\n  protected constructor(options: TNClientOptions) {\n    this.signerInfo = options.signerInfo;\n  }\n\n  /**\n   * Waits for a transaction to be mined by TN.\n   * @param txHash - The transaction hash to wait for.\n   * @param timeout - The timeout in milliseconds.\n   * @returns A promise that resolves to the transaction info receipt.\n   */\n  async waitForTx(txHash: string, timeout = 12000): Promise<Types.TxInfoReceipt> {\n    return new Promise<Types.TxInfoReceipt>(async (resolve, reject) => {\n      const interval = setInterval(async () => {\n        const receipt = await this.getKwilClient()\n          [\"txInfoClient\"](txHash)\n          .catch(() => ({ data: undefined, status: undefined }));\n        switch (receipt.status) {\n          case 200:\n            if (receipt.data?.tx_result?.log !== undefined && receipt.data?.tx_result?.log.includes(\"ERROR\")) {\n              reject(\n                  new Error(\n                      `Transaction failed: status ${receipt.status} : log message ${receipt.data?.tx_result.log}`,\n                  ))\n            } else {\n              resolve(receipt.data!);\n            }\n            break;\n          case undefined:\n            break;\n          default:\n            reject(\n              new Error(\n                `Transaction failed: status ${receipt.status} : log message ${receipt.data?.tx_result.log}`,\n              ),\n            );\n        }\n      }, 1000);\n      setTimeout(() => {\n        clearInterval(interval);\n        reject(new Error(\"Transaction failed: Timeout\"));\n      }, timeout);\n    });\n  }\n\n  /**\n   * Returns the Kwil signer used by the client.\n   * @returns An instance of KwilSigner.\n   */\n  getKwilSigner(): KwilSigner {\n    return new KwilSigner(\n      this.signerInfo.signer,\n      this.address().getAddress(),\n    );\n  }\n\n  /**\n   * Returns the Kwil client used by the client.\n   * @returns An instance of Kwil.\n   * @throws If the Kwil client is not initialized.\n   */\n  getKwilClient(): Types.Kwil<EnvironmentType> {\n    if (!this.kwilClient) {\n      throw new Error(\"Kwil client not initialized\");\n    }\n    return this.kwilClient;\n  }\n\n  /**\n   * Deploys a new stream.\n   * @param streamId - The ID of the stream to deploy.\n   * @param streamType - The type of the stream.\n   * @param synchronous - Whether the deployment should be synchronous.\n   * @param contractVersion\n   * @returns A promise that resolves to a generic response containing the transaction receipt.\n   */\n  async deployStream(\n    streamId: StreamId,\n    streamType: StreamType,\n    synchronous?: boolean,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await deployStream({\n      streamId,\n      streamType,\n      synchronous,\n      kwilClient: this.getKwilClient(),\n      kwilSigner: this.getKwilSigner(),\n    });\n  }\n\n  /**\n   * Destroys a stream.\n   * @param stream - The StreamLocator of the stream to destroy.\n   * @param synchronous - Whether the destruction should be synchronous.\n   * @returns A promise that resolves to a generic response containing the transaction receipt.\n   */\n  async destroyStream(\n    stream: StreamLocator,\n    synchronous?: boolean,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await deleteStream({\n      stream,\n      synchronous,\n      kwilClient: this.getKwilClient(),\n      kwilSigner: this.getKwilSigner(),\n    });\n  }\n\n  /**\n   * Loads an already deployed stream, permitting its API usage.\n   * @returns An instance of IStream.\n   */\n  loadAction(): Action {\n    return new Action(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads a primitive stream.\n   * @returns An instance of IPrimitiveStream.\n   */\n  loadPrimitiveAction(): PrimitiveAction {\n    return PrimitiveAction.fromStream(this.loadAction());\n  }\n\n  /**\n   * Loads a composed stream.\n   * @returns An instance of IComposedStream.\n   */\n  loadComposedAction(): ComposedAction {\n    return ComposedAction.fromStream(this.loadAction());\n  }\n\n  /**\n   * Loads the role management contract API, permitting its RBAC usage.\n   */\n  loadRoleManagementAction(): RoleManagement {\n    return RoleManagement.fromClient(\n        this.getKwilClient() as WebKwil | NodeKwil,\n        this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads the attestation action API, permitting attestation operations.\n   * @returns An instance of AttestationAction.\n   */\n  loadAttestationAction(): AttestationAction {\n    return new AttestationAction(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads the transaction action API, permitting transaction ledger queries.\n   * @returns An instance of TransactionAction.\n   */\n  loadTransactionAction(): TransactionAction {\n    return new TransactionAction(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads the order book action API, permitting prediction market operations.\n   * @returns An instance of OrderbookAction.\n   */\n  loadOrderbookAction(): OrderbookAction {\n    return new OrderbookAction(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Creates a new stream locator.\n   * @param streamId - The ID of the stream.\n   * @returns A StreamLocator object.\n   */\n  ownStreamLocator(streamId: StreamId): StreamLocator {\n    return {\n      streamId,\n      dataProvider: this.address(),\n    };\n  }\n\n  /**\n   * Returns the address of the signer used by the client.\n   * @returns An instance of EthereumAddress.\n   */\n  address(): EthereumAddress {\n    return new EthereumAddress(this.signerInfo.address);\n  }\n\n  /**\n   * Returns all streams from the TN network.\n   * @param input - The input parameters for listing streams.\n   * @returns A promise that resolves to a list of stream locators.\n   */\n  async getListStreams(input: ListStreamsInput): Promise<TNStream[]> {\n    return listStreams(this.getKwilClient() as WebKwil | NodeKwil,this.getKwilSigner(),input);\n  }\n\n    /**\n     * Returns the last write activity across streams.\n     * @param input - The input parameters for getting last transactions.\n     * @returns A promise that resolves to a list of last transactions.\n     */\n    async getLastTransactions(input: GetLastTransactionsInput): Promise<any[]> {\n        return getLastTransactions(this.getKwilClient() as WebKwil | NodeKwil,this.getKwilSigner(),input);\n    }\n\n  /**\n   * Lists taxonomies by height range for incremental synchronization.\n   * High-level wrapper for ComposedAction.listTaxonomiesByHeight()\n   * \n   * @param params Height range and pagination parameters  \n   * @returns Promise resolving to taxonomy query results\n   * \n   * @example\n   * ```typescript\n   * const taxonomies = await client.listTaxonomiesByHeight({\n   *   fromHeight: 1000,\n   *   toHeight: 2000,\n   *   limit: 100,\n   *   latestOnly: true\n   * });\n   * ```\n   */\n  async listTaxonomiesByHeight(params: ListTaxonomiesByHeightParams = {}): Promise<TaxonomyQueryResult[]> {\n    const composedAction = this.loadComposedAction();\n    return composedAction.listTaxonomiesByHeight(params);\n  }\n\n  async listMetadataByHeight(params: ListMetadataByHeightParams = {}): Promise<MetadataQueryResult[]> {\n    const action = this.loadAction();\n    return action.listMetadataByHeight(params);\n  }\n\n  /**\n   * Gets the wallet balance for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\", \"ethereum\")\n   * @param walletAddress The wallet address to check balance for\n   * @returns Promise that resolves to the balance as a string (in wei)\n   */\n  async getWalletBalance(bridgeIdentifier: string, walletAddress: string) {\n    const action = this.loadAction();\n    return action.getWalletBalance(bridgeIdentifier, walletAddress);\n  }\n\n  /**\n   * Performs a withdrawal operation by bridging tokens from TN to a destination chain\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\")\n   * @param amount The amount to withdraw (in wei)\n   * @param recipient The recipient address on the destination chain\n   * @returns Promise that resolves to the transaction hash, or throws on error\n   */\n  async withdraw(bridgeIdentifier: string, amount: string, recipient: string): Promise<string> {\n    const action = this.loadAction();\n\n    // Bridge tokens in a single operation\n    const bridgeResult = await action.bridgeTokens(bridgeIdentifier, amount, recipient);\n    if (!bridgeResult.data?.tx_hash) {\n      throw new Error(\"Bridge tokens operation failed: no transaction hash returned\");\n    }\n\n    // Wait for bridge transaction to be mined - let waitForTx errors bubble up\n    try {\n      await this.waitForTx(bridgeResult.data.tx_hash);\n    } catch (error) {\n      throw new Error(`Bridge tokens transaction failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n\n    // Return the transaction hash\n    return bridgeResult.data.tx_hash;\n  }\n\n  /**\n   * Lists wallet rewards for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\")\n   * @param wallet The wallet address to list rewards for\n   * @param withPending Whether to include pending rewards\n   * @returns Promise that resolves to an array of rewards data\n   * @deprecated This method uses the extension namespace directly. Most users should use getWithdrawalProof instead.\n   */\n  async listWalletRewards(bridgeIdentifier: string, wallet: string, withPending: boolean): Promise<any[]> {\n    const action = this.loadAction();\n    return action.listWalletRewards(bridgeIdentifier, wallet, withPending);\n  }\n\n  /**\n   * Gets withdrawal proof for a specific bridge instance\n   * Returns merkle proofs and validator signatures needed for claiming withdrawals on the destination chain\n   *\n   * This method is used for non-custodial bridge withdrawals where users need to\n   * manually claim their withdrawals by submitting proofs to the destination chain contract.\n   * The proof includes validator signatures, merkle root, block hash, and amount.\n   *\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"hoodi_tt\", \"sepolia\", \"ethereum\")\n   * @param walletAddress The wallet address to get withdrawal proof for\n   * @returns Promise that resolves to an array of withdrawal proof data (empty array if no unclaimed withdrawals)\n   *\n   * @example\n   * ```typescript\n   * // Get withdrawal proofs for Hoodi Test Token bridge\n   * const proofs = await client.getWithdrawalProof(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   *\n   * // Proofs will be an array like:\n   * // [{\n   * //   chain: \"hoodi\",\n   * //   chain_id: \"3639\",\n   * //   contract: \"0x878D6aaeB6e746033f50B8dC268d54B4631554E7\",\n   * //   created_at: 3080,\n   * //   recipient: \"0x...\",\n   * //   amount: \"100000000000000000000\",\n   * //   block_hash: <base64-encoded>,\n   * //   root: <base64-encoded>,\n   * //   proofs: [],\n   * //   signatures: [<base64-encoded-signatures>]\n   * // }]\n   *\n   * // Use the proofs to claim withdrawal on destination chain\n   * if (proofs.length > 0) {\n   *   const proof = proofs[0];\n   *   await bridgeContract.claimWithdrawal(proof.recipient, proof.amount, proof.root, proof.proofs, proof.signatures);\n   * }\n   * ```\n   *\n   * @note This method has been tested via integration tests in the node repository.\n   * See: https://github.com/trufnetwork/kwil-db/blob/main/node/exts/erc20-bridge/erc20/meta_extension_withdrawal_test.go\n   */\n  async getWithdrawalProof(bridgeIdentifier: string, walletAddress: string): Promise<WithdrawalProof[]> {\n    const action = this.loadAction();\n    return action.getWithdrawalProof(bridgeIdentifier, walletAddress);\n  }\n\n  /**\n   * Gets taxonomies for specific streams in batch.\n   * High-level wrapper for ComposedAction.getTaxonomiesForStreams()\n   * \n   * @param params Stream locators and options\n   * @returns Promise resolving to taxonomy query results\n   * \n   * @example\n   * ```typescript\n   * const streams = [\n   *   { dataProvider: provider1, streamId: streamId1 },\n   *   { dataProvider: provider2, streamId: streamId2 }\n   * ];\n   * const taxonomies = await client.getTaxonomiesForStreams({\n   *   streams,\n   *   latestOnly: true\n   * });\n   * ```\n   */\n  async getTaxonomiesForStreams(params: GetTaxonomiesForStreamsParams): Promise<TaxonomyQueryResult[]> {\n    const composedAction = this.loadComposedAction();\n    return composedAction.getTaxonomiesForStreams(params);\n  }\n\n  /**\n   * Get the default chain id for a provider. Use with caution, as this decreases the security of the TN.\n   * @param provider - The provider URL.\n   * @returns A promise that resolves to the chain ID.\n   */\n  public static async getDefaultChainId(provider: string) {\n    const kwilClient = new Client({\n      kwilProvider: provider,\n    });\n    const chainInfo = await kwilClient[\"chainInfoClient\"]();\n    return chainInfo.data?.chain_id;\n  }\n\n  /*\n   * High-level role-management helpers. These wrap the lower-level\n   * RoleManagement contract calls and expose a simpler API on the\n   * TN client.\n   */\n\n  /** Grants a role to one or more wallets. */\n  async grantRole(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    wallets: EthereumAddress | EthereumAddress[];\n    synchronous?: boolean;\n  }): Promise<string> {\n    const rm = this.loadRoleManagementAction();\n    const walletsArr: EthereumAddress[] = Array.isArray(input.wallets)\n      ? input.wallets\n      : [input.wallets];\n    const tx = await rm.grantRole(\n      {\n        owner: input.owner,\n        roleName: input.roleName,\n        wallets: walletsArr,\n      },\n      input.synchronous,\n    );\n    return tx.data?.tx_hash as unknown as string;\n  }\n\n  /** Revokes a role from one or more wallets. */\n  async revokeRole(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    wallets: EthereumAddress | EthereumAddress[];\n    synchronous?: boolean;\n  }): Promise<string> {\n    const rm = this.loadRoleManagementAction();\n    const walletsArr: EthereumAddress[] = Array.isArray(input.wallets)\n      ? input.wallets\n      : [input.wallets];\n    const tx = await rm.revokeRole(\n      {\n        owner: input.owner,\n        roleName: input.roleName,\n        wallets: walletsArr,\n      },\n      input.synchronous,\n    );\n    return tx.data?.tx_hash as unknown as string;\n  }\n\n  /**\n   * Checks if a wallet is member of a role.\n   * Returns true if the wallet is a member.\n   */\n  async isMemberOf(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    wallet: EthereumAddress;\n  }): Promise<boolean> {\n    const rm = this.loadRoleManagementAction();\n    const res = await rm.areMembersOf({\n      owner: input.owner,\n      roleName: input.roleName,\n      wallets: [input.wallet],\n    });\n    return res.length > 0 && res[0].isMember;\n  }\n\n  /**\n   * Lists role members \u2013 currently unsupported in the\n   * smart-contract layer.\n   */\n  async listRoleMembers(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<import(\"../types/role\").RoleMember[]> {\n    const rm = this.loadRoleManagementAction();\n    return rm.listRoleMembers({\n      owner: input.owner,\n      roleName: input.roleName,\n      limit: input.limit,\n      offset: input.offset,\n    });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Client, KwilSigner, NodeKwil, WebKwil, Types, EnvironmentType } from \"@trufnetwork/kwil-js\";\nimport { ComposedAction, ListTaxonomiesByHeightParams, GetTaxonomiesForStreamsParams, TaxonomyQueryResult } from \"../contracts-api/composedAction\";\nimport { deployStream } from \"../contracts-api/deployStream\";\nimport { deleteStream } from \"../contracts-api/deleteStream\";\nimport { PrimitiveAction } from \"../contracts-api/primitiveAction\";\nimport { Action, ListMetadataByHeightParams, MetadataQueryResult } from \"../contracts-api/action\";\nimport { StreamType } from \"../contracts-api/contractValues\";\nimport { WithdrawalProof, BridgeHistory } from \"../types/bridge\";\nimport { StreamLocator, TNStream } from \"../types/stream\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { StreamId } from \"../util/StreamId\";\nimport { listStreams } from \"./listStreams\";\nimport { getLastTransactions } from \"./getLastTransactions\";\nimport { RoleManagement } from \"../contracts-api/roleManagement\";\nimport { AttestationAction } from \"../contracts-api/attestationAction\";\nimport { TransactionAction } from \"../contracts-api/transactionAction\";\nimport { OrderbookAction } from \"../contracts-api/orderbookAction\";\nimport { OwnerIdentifier } from \"../types/role\";\n\nexport interface SignerInfo {\n  // we need to have the address upfront to create the KwilSigner, instead of relying on the signer to return it asynchronously\n  address: string;\n  signer: Types.EthSigner;\n}\n\nexport type TNClientOptions = {\n  endpoint: string;\n  signerInfo: SignerInfo;\n} & Omit<Types.KwilConfig, \"kwilProvider\">;\n\nexport interface ListStreamsInput {\n    dataProvider?: string;\n    limit?: number;\n    offset?: number;\n    orderBy?: string;\n    blockHeight?: number;\n}\n\n/**\n * @param dataProvider optional address; when omitted or null, returns for all providers\n * @param limitSize max rows to return (default 6, max 100)\n */\nexport interface GetLastTransactionsInput {\n  dataProvider?: string;\n  limitSize?: number;\n}\n\nexport abstract class BaseTNClient<T extends EnvironmentType> {\n  protected kwilClient: Types.Kwil<T> | undefined;\n  protected signerInfo: SignerInfo;\n\n  protected constructor(options: TNClientOptions) {\n    this.signerInfo = options.signerInfo;\n  }\n\n  /**\n   * Waits for a transaction to be mined by TN.\n   * @param txHash - The transaction hash to wait for.\n   * @param timeout - The timeout in milliseconds.\n   * @returns A promise that resolves to the transaction info receipt.\n   */\n  async waitForTx(txHash: string, timeout = 12000): Promise<Types.TxInfoReceipt> {\n    return new Promise<Types.TxInfoReceipt>(async (resolve, reject) => {\n      const interval = setInterval(async () => {\n        const receipt = await this.getKwilClient()\n          [\"txInfoClient\"](txHash)\n          .catch(() => ({ data: undefined, status: undefined }));\n        switch (receipt.status) {\n          case 200:\n            if (receipt.data?.tx_result?.log !== undefined && receipt.data?.tx_result?.log.includes(\"ERROR\")) {\n              reject(\n                  new Error(\n                      `Transaction failed: status ${receipt.status} : log message ${receipt.data?.tx_result.log}`,\n                  ))\n            } else {\n              resolve(receipt.data!);\n            }\n            break;\n          case undefined:\n            break;\n          default:\n            reject(\n              new Error(\n                `Transaction failed: status ${receipt.status} : log message ${receipt.data?.tx_result.log}`,\n              ),\n            );\n        }\n      }, 1000);\n      setTimeout(() => {\n        clearInterval(interval);\n        reject(new Error(\"Transaction failed: Timeout\"));\n      }, timeout);\n    });\n  }\n\n  /**\n   * Returns the Kwil signer used by the client.\n   * @returns An instance of KwilSigner.\n   */\n  getKwilSigner(): KwilSigner {\n    return new KwilSigner(\n      this.signerInfo.signer,\n      this.address().getAddress(),\n    );\n  }\n\n  /**\n   * Returns the Kwil client used by the client.\n   * @returns An instance of Kwil.\n   * @throws If the Kwil client is not initialized.\n   */\n  getKwilClient(): Types.Kwil<EnvironmentType> {\n    if (!this.kwilClient) {\n      throw new Error(\"Kwil client not initialized\");\n    }\n    return this.kwilClient;\n  }\n\n  /**\n   * Deploys a new stream.\n   * @param streamId - The ID of the stream to deploy.\n   * @param streamType - The type of the stream.\n   * @param synchronous - Whether the deployment should be synchronous.\n   * @param contractVersion\n   * @returns A promise that resolves to a generic response containing the transaction receipt.\n   */\n  async deployStream(\n    streamId: StreamId,\n    streamType: StreamType,\n    synchronous?: boolean,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await deployStream({\n      streamId,\n      streamType,\n      synchronous,\n      kwilClient: this.getKwilClient(),\n      kwilSigner: this.getKwilSigner(),\n    });\n  }\n\n  /**\n   * Destroys a stream.\n   * @param stream - The StreamLocator of the stream to destroy.\n   * @param synchronous - Whether the destruction should be synchronous.\n   * @returns A promise that resolves to a generic response containing the transaction receipt.\n   */\n  async destroyStream(\n    stream: StreamLocator,\n    synchronous?: boolean,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await deleteStream({\n      stream,\n      synchronous,\n      kwilClient: this.getKwilClient(),\n      kwilSigner: this.getKwilSigner(),\n    });\n  }\n\n  /**\n   * Loads an already deployed stream, permitting its API usage.\n   * @returns An instance of IStream.\n   */\n  loadAction(): Action {\n    return new Action(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads a primitive stream.\n   * @returns An instance of IPrimitiveStream.\n   */\n  loadPrimitiveAction(): PrimitiveAction {\n    return PrimitiveAction.fromStream(this.loadAction());\n  }\n\n  /**\n   * Loads a composed stream.\n   * @returns An instance of IComposedStream.\n   */\n  loadComposedAction(): ComposedAction {\n    return ComposedAction.fromStream(this.loadAction());\n  }\n\n  /**\n   * Loads the role management contract API, permitting its RBAC usage.\n   */\n  loadRoleManagementAction(): RoleManagement {\n    return RoleManagement.fromClient(\n        this.getKwilClient() as WebKwil | NodeKwil,\n        this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads the attestation action API, permitting attestation operations.\n   * @returns An instance of AttestationAction.\n   */\n  loadAttestationAction(): AttestationAction {\n    return new AttestationAction(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads the transaction action API, permitting transaction ledger queries.\n   * @returns An instance of TransactionAction.\n   */\n  loadTransactionAction(): TransactionAction {\n    return new TransactionAction(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Loads the order book action API, permitting prediction market operations.\n   * @returns An instance of OrderbookAction.\n   */\n  loadOrderbookAction(): OrderbookAction {\n    return new OrderbookAction(\n      this.getKwilClient() as WebKwil | NodeKwil,\n      this.getKwilSigner(),\n    );\n  }\n\n  /**\n   * Creates a new stream locator.\n   * @param streamId - The ID of the stream.\n   * @returns A StreamLocator object.\n   */\n  ownStreamLocator(streamId: StreamId): StreamLocator {\n    return {\n      streamId,\n      dataProvider: this.address(),\n    };\n  }\n\n  /**\n   * Returns the address of the signer used by the client.\n   * @returns An instance of EthereumAddress.\n   */\n  address(): EthereumAddress {\n    return new EthereumAddress(this.signerInfo.address);\n  }\n\n  /**\n   * Returns all streams from the TN network.\n   * @param input - The input parameters for listing streams.\n   * @returns A promise that resolves to a list of stream locators.\n   */\n  async getListStreams(input: ListStreamsInput): Promise<TNStream[]> {\n    return listStreams(this.getKwilClient() as WebKwil | NodeKwil,this.getKwilSigner(),input);\n  }\n\n    /**\n     * Returns the last write activity across streams.\n     * @param input - The input parameters for getting last transactions.\n     * @returns A promise that resolves to a list of last transactions.\n     */\n    async getLastTransactions(input: GetLastTransactionsInput): Promise<any[]> {\n        return getLastTransactions(this.getKwilClient() as WebKwil | NodeKwil,this.getKwilSigner(),input);\n    }\n\n  /**\n   * Lists taxonomies by height range for incremental synchronization.\n   * High-level wrapper for ComposedAction.listTaxonomiesByHeight()\n   * \n   * @param params Height range and pagination parameters  \n   * @returns Promise resolving to taxonomy query results\n   * \n   * @example\n   * ```typescript\n   * const taxonomies = await client.listTaxonomiesByHeight({\n   *   fromHeight: 1000,\n   *   toHeight: 2000,\n   *   limit: 100,\n   *   latestOnly: true\n   * });\n   * ```\n   */\n  async listTaxonomiesByHeight(params: ListTaxonomiesByHeightParams = {}): Promise<TaxonomyQueryResult[]> {\n    const composedAction = this.loadComposedAction();\n    return composedAction.listTaxonomiesByHeight(params);\n  }\n\n  async listMetadataByHeight(params: ListMetadataByHeightParams = {}): Promise<MetadataQueryResult[]> {\n    const action = this.loadAction();\n    return action.listMetadataByHeight(params);\n  }\n\n  /**\n   * Gets the wallet balance for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\", \"ethereum\")\n   * @param walletAddress The wallet address to check balance for\n   * @returns Promise that resolves to the balance as a string (in wei)\n   */\n  async getWalletBalance(bridgeIdentifier: string, walletAddress: string) {\n    const action = this.loadAction();\n    return action.getWalletBalance(bridgeIdentifier, walletAddress);\n  }\n\n  /**\n   * Performs a withdrawal operation by bridging tokens from TN to a destination chain\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\")\n   * @param amount The amount to withdraw (in wei)\n   * @param recipient The recipient address on the destination chain\n   * @returns Promise that resolves to the transaction hash, or throws on error\n   */\n  async withdraw(bridgeIdentifier: string, amount: string, recipient: string): Promise<string> {\n    const action = this.loadAction();\n\n    // Bridge tokens in a single operation\n    const bridgeResult = await action.bridgeTokens(bridgeIdentifier, amount, recipient);\n    if (!bridgeResult.data?.tx_hash) {\n      throw new Error(\"Bridge tokens operation failed: no transaction hash returned\");\n    }\n\n    // Wait for bridge transaction to be mined - let waitForTx errors bubble up\n    try {\n      await this.waitForTx(bridgeResult.data.tx_hash);\n    } catch (error) {\n      throw new Error(`Bridge tokens transaction failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n\n    // Return the transaction hash\n    return bridgeResult.data.tx_hash;\n  }\n\n  /**\n   * Lists wallet rewards for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\")\n   * @param wallet The wallet address to list rewards for\n   * @param withPending Whether to include pending rewards\n   * @returns Promise that resolves to an array of rewards data\n   * @deprecated This method uses the extension namespace directly. Most users should use getWithdrawalProof instead.\n   */\n  async listWalletRewards(bridgeIdentifier: string, wallet: string, withPending: boolean): Promise<any[]> {\n    const action = this.loadAction();\n    return action.listWalletRewards(bridgeIdentifier, wallet, withPending);\n  }\n\n  /**\n   * Gets withdrawal proof for a specific bridge instance\n   * Returns merkle proofs and validator signatures needed for claiming withdrawals on the destination chain\n   *\n   * This method is used for non-custodial bridge withdrawals where users need to\n   * manually claim their withdrawals by submitting proofs to the destination chain contract.\n   * The proof includes validator signatures, merkle root, block hash, and amount.\n   *\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"hoodi_tt\", \"sepolia\", \"ethereum\")\n   * @param walletAddress The wallet address to get withdrawal proof for\n   * @returns Promise that resolves to an array of withdrawal proof data (empty array if no unclaimed withdrawals)\n   *\n   * @example\n   * ```typescript\n   * // Get withdrawal proofs for Hoodi Test Token bridge\n   * const proofs = await client.getWithdrawalProof(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   *\n   * // Proofs will be an array like:\n   * // [{\n   * //   chain: \"hoodi\",\n   * //   chain_id: \"3639\",\n   * //   contract: \"0x878D6aaeB6e746033f50B8dC268d54B4631554E7\",\n   * //   created_at: 3080,\n   * //   recipient: \"0x...\",\n   * //   amount: \"100000000000000000000\",\n   * //   block_hash: <base64-encoded>,\n   * //   root: <base64-encoded>,\n   * //   proofs: [],\n   * //   signatures: [<base64-encoded-signatures>]\n   * // }]\n   *\n   * // Use the proofs to claim withdrawal on destination chain\n   * if (proofs.length > 0) {\n   *   const proof = proofs[0];\n   *   await bridgeContract.claimWithdrawal(proof.recipient, proof.amount, proof.root, proof.proofs, proof.signatures);\n   * }\n   * ```\n   *\n   * @note This method has been tested via integration tests in the node repository.\n   * See: https://github.com/trufnetwork/kwil-db/blob/main/node/exts/erc20-bridge/erc20/meta_extension_withdrawal_test.go\n   */\n  async getWithdrawalProof(bridgeIdentifier: string, walletAddress: string): Promise<WithdrawalProof[]> {\n    const action = this.loadAction();\n    return action.getWithdrawalProof(bridgeIdentifier, walletAddress);\n  }\n\n  /**\n   * Retrieves the transaction history for a wallet on a specific bridge.\n   *\n   * @param bridgeIdentifier - The name of the bridge instance (e.g., \"hoodi_tt\", \"sepolia_bridge\")\n   * @param walletAddress - The wallet address to query\n   * @param limit - Max number of records to return (default 20)\n   * @param offset - Number of records to skip (default 0)\n   * @returns Promise resolving to an array of BridgeHistory records\n   *\n   * @example\n   * ```typescript\n   * const history = await client.getHistory(\"sepolia_bridge\", \"0x123...\");\n   * console.log(history);\n   * ```\n   */\n  async getHistory(bridgeIdentifier: string, walletAddress: string, limit: number = 20, offset: number = 0): Promise<BridgeHistory[]> {\n    const action = this.loadAction();\n    return action.getHistory(bridgeIdentifier, walletAddress, limit, offset);\n  }\n\n  /**\n   * Gets taxonomies for specific streams in batch.\n   * High-level wrapper for ComposedAction.getTaxonomiesForStreams()\n   * \n   * @param params Stream locators and options\n   * @returns Promise resolving to taxonomy query results\n   * \n   * @example\n   * ```typescript\n   * const streams = [\n   *   { dataProvider: provider1, streamId: streamId1 },\n   *   { dataProvider: provider2, streamId: streamId2 }\n   * ];\n   * const taxonomies = await client.getTaxonomiesForStreams({\n   *   streams,\n   *   latestOnly: true\n   * });\n   * ```\n   */\n  async getTaxonomiesForStreams(params: GetTaxonomiesForStreamsParams): Promise<TaxonomyQueryResult[]> {\n    const composedAction = this.loadComposedAction();\n    return composedAction.getTaxonomiesForStreams(params);\n  }\n\n  /**\n   * Get the default chain id for a provider. Use with caution, as this decreases the security of the TN.\n   * @param provider - The provider URL.\n   * @returns A promise that resolves to the chain ID.\n   */\n  public static async getDefaultChainId(provider: string) {\n    const kwilClient = new Client({\n      kwilProvider: provider,\n    });\n    const chainInfo = await kwilClient[\"chainInfoClient\"]();\n    return chainInfo.data?.chain_id;\n  }\n\n  /*\n   * High-level role-management helpers. These wrap the lower-level\n   * RoleManagement contract calls and expose a simpler API on the\n   * TN client.\n   */\n\n  /** Grants a role to one or more wallets. */\n  async grantRole(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    wallets: EthereumAddress | EthereumAddress[];\n    synchronous?: boolean;\n  }): Promise<string> {\n    const rm = this.loadRoleManagementAction();\n    const walletsArr: EthereumAddress[] = Array.isArray(input.wallets)\n      ? input.wallets\n      : [input.wallets];\n    const tx = await rm.grantRole(\n      {\n        owner: input.owner,\n        roleName: input.roleName,\n        wallets: walletsArr,\n      },\n      input.synchronous,\n    );\n    return tx.data?.tx_hash as unknown as string;\n  }\n\n  /** Revokes a role from one or more wallets. */\n  async revokeRole(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    wallets: EthereumAddress | EthereumAddress[];\n    synchronous?: boolean;\n  }): Promise<string> {\n    const rm = this.loadRoleManagementAction();\n    const walletsArr: EthereumAddress[] = Array.isArray(input.wallets)\n      ? input.wallets\n      : [input.wallets];\n    const tx = await rm.revokeRole(\n      {\n        owner: input.owner,\n        roleName: input.roleName,\n        wallets: walletsArr,\n      },\n      input.synchronous,\n    );\n    return tx.data?.tx_hash as unknown as string;\n  }\n\n  /**\n   * Checks if a wallet is member of a role.\n   * Returns true if the wallet is a member.\n   */\n  async isMemberOf(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    wallet: EthereumAddress;\n  }): Promise<boolean> {\n    const rm = this.loadRoleManagementAction();\n    const res = await rm.areMembersOf({\n      owner: input.owner,\n      roleName: input.roleName,\n      wallets: [input.wallet],\n    });\n    return res.length > 0 && res[0].isMember;\n  }\n\n  /**\n   * Lists role members \u2013 currently unsupported in the\n   * smart-contract layer.\n   */\n  async listRoleMembers(input: {\n    owner: OwnerIdentifier;\n    roleName: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<import(\"../types/role\").RoleMember[]> {\n    const rm = this.loadRoleManagementAction();\n    return rm.listRoleMembers({\n      owner: input.owner,\n      roleName: input.roleName,\n      limit: input.limit,\n      offset: input.offset,\n    });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/contracts-api/action.cjs

@@ -801,5 +801,27 @@ var Action = class _Action {
       return rows || [];
     }).throw();
   }
+  /**
+   * Retrieves the unified transaction history for a wallet on a specific bridge.
+   *
+   * @param bridgeIdentifier - The name of the bridge instance (e.g., "hoodi_tt", "sepolia_bridge")
+   * @param walletAddress - The wallet address to query
+   * @param limit - Max number of records to return (default 20)
+   * @param offset - Number of records to skip (default 0)
+   * @returns Array of BridgeHistory records
+   */
+  async getHistory(bridgeIdentifier, walletAddress, limit = 20, offset = 0) {
+    const result = await this.call(
+      `${bridgeIdentifier}_get_history`,
+      {
+        $wallet_address: walletAddress,
+        $limit: limit,
+        $offset: offset
+      }
+    );
+    return result.mapRight((rows) => {
+      return rows || [];
+    }).throw();
+  }
 };
 //# sourceMappingURL=action.cjs.map

package/dist/cjs/contracts-api/action.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/contracts-api/action.ts"],
-  "sourcesContent": ["import {KwilSigner, NodeKwil, WebKwil, Types} from \"@trufnetwork/kwil-js\";\nimport { Either } from \"monads-io\";\nimport { WithdrawalProof } from \"../types/bridge\";\nimport { DateString } from \"../types/other\";\nimport { StreamLocator } from \"../types/stream\";\nimport { CacheAwareResponse, GetRecordOptions, GetIndexOptions, GetIndexChangeOptions, GetFirstRecordOptions } from \"../types/cache\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { head } from \"../util/head\";\nimport { StreamId } from \"../util/StreamId\";\nimport { toVisibilityEnum, VisibilityEnum } from \"../util/visibility\";\nimport { CacheMetadataParser } from \"../util/cacheMetadataParser\";\nimport { CacheValidation } from \"../util/cacheValidation\";\nimport {\n  MetadataKey,\n  MetadataKeyValueMap,\n  MetadataTableKey,\n  MetadataValueTypeForKey,\n  StreamType,\n} from \"./contractValues\";\n// ValueType is available as Types.ValueType\n\nexport interface GetRecordInput {\n  stream: StreamLocator;\n  from?: number;\n  to?: number;\n  frozenAt?: number;\n  baseTime?: DateString | number;\n  prefix?: string;\n}\n\nexport interface GetFirstRecordInput {\n  stream: StreamLocator;\n  after?: number;\n  frozenAt?: number;\n}\n\nexport interface StreamRecord {\n  eventTime: number;\n  value: string;\n}\n\nexport interface GetIndexChangeInput extends GetRecordInput {\n  timeInterval: number;\n}\n\nexport interface ListMetadataByHeightParams {\n  /** Key reference filter. Default: empty string */\n  key?: string;\n  /** Value reference filter. Default: null */\n  value?: string;\n  /** Start height (inclusive). If null, uses earliest available. */\n  fromHeight?: number;\n  /** End height (inclusive). If null, uses current height. */\n  toHeight?: number;\n  /** Maximum number of results to return. Default: 1000 */\n  limit?: number;\n  /** Number of results to skip for pagination. Default: 0 */\n  offset?: number;\n}\n\nexport interface MetadataQueryResult {\n  streamId: string;\n  dataProvider: string;\n  rowId: string;\n  valueInt: number | null;\n  valueFloat: string | null;\n  valueBoolean: boolean | null;\n  valueString: string | null;\n  valueRef: string | null;\n  createdAt: number;\n}\n\nexport class Action {\n  protected kwilClient: WebKwil | NodeKwil;\n  protected kwilSigner: KwilSigner;\n  /** Track if deprecation warnings were already emitted */\n  private static _legacyWarnEmitted: Record<string, boolean> = {\n    getRecord: false,\n    getIndex: false,\n    getFirstRecord: false,\n    getIndexChange: false,\n  };\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n  ) {\n    this.kwilClient = kwilClient;\n    this.kwilSigner = kwilSigner;\n  }\n\n  /**\n   * Executes a stream method with named parameters\n   * @param method - The action name to execute\n   * @param inputs - Named parameters for the action\n   * @param types - Optional type specifications for parameters (e.g., NUMERIC)\n   * @returns Transaction receipt\n   */\n  protected async executeWithNamedParams(\n    method: string,\n    inputs: Types.NamedParams[],\n    types?: Record<string, any>,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return this.kwilClient.execute({\n          namespace: \"main\",\n          name: method,\n          inputs,\n          types,\n          description: `TN SDK - Executing method on stream: ${method}`,\n        },\n        this.kwilSigner,\n        );\n  }\n\n  /**\n   * Executes a stream action with a complete ActionBody\n   * @param inputs - Complete action body with all execution parameters\n   * @param synchronous - Whether to wait for transaction to be mined\n   * @returns Transaction receipt\n   */\n  protected async executeWithActionBody(\n    inputs: Types.ActionBody,\n    synchronous: boolean = false,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return this.kwilClient.execute(inputs, this.kwilSigner, synchronous);\n  }\n\n  /**\n   * Calls a method on the stream\n   */\n  protected async call<T>(\n    method: string,\n    inputs: Types.NamedParams,\n  ): Promise<Either<number, T>> {\n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: method,\n        inputs: inputs,\n      },\n      this.kwilSigner,\n    );\n\n    if (result.status !== 200) {\n      return Either.left(result.status);\n    }\n\n    return Either.right(result.data?.result as T);\n  }\n\n  /**\n   * @deprecated Use getRecord(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getRecord(input: GetRecordInput): Promise<StreamRecord[]>;\n  public async getRecord(stream: StreamLocator, options?: GetRecordOptions): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getRecord(\n    inputOrStream: GetRecordInput | StreamLocator,\n    options?: GetRecordOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetRecordInput;\n      // emit deprecation warning once\n      if (!Action._legacyWarnEmitted.getRecord) {\n        Action._legacyWarnEmitted.getRecord = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getRecord(input). Use getRecord(stream, options?) instead.');\n        }\n      }\n      const prefix = input.prefix ? input.prefix : \"\"\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          prefix + \"get_record\",\n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n          }\n      );\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetRecordOptions(options);\n      CacheValidation.validateTimeRange(options.from, options.to);\n    }\n    \n    const prefix = options?.prefix ? options.prefix : \"\"\n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options?.from,\n      $to: options?.to,\n      $frozen_at: options?.frozenAt,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: prefix + \"get_record\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get record: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options?.from,\n        to: options?.to,\n        frozenAt: options?.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined,\n    };\n  }\n\n  /**\n   * Returns the index of the stream within the given date range\n   * @deprecated Use getIndex(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getIndex(input: GetRecordInput): Promise<StreamRecord[]>;\n  public async getIndex(stream: StreamLocator, options?: GetIndexOptions): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getIndex(\n    inputOrStream: GetRecordInput | StreamLocator,\n    options?: GetIndexOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetRecordInput;\n      if (!Action._legacyWarnEmitted.getIndex) {\n        Action._legacyWarnEmitted.getIndex = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getIndex(input). Use getIndex(stream, options?) instead.');\n        }\n      }\n      const prefix = input.prefix ? input.prefix : \"\"\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        prefix + \"get_index\",\n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n            $base_time: input.baseTime,\n          }\n      );\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetIndexOptions(options);\n      CacheValidation.validateTimeRange(options.from, options.to);\n    }\n    \n    const prefix = options?.prefix ? options.prefix : \"\"\n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options?.from,\n      $to: options?.to,\n      $frozen_at: options?.frozenAt,\n      $base_time: options?.baseTime,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: prefix + \"get_index\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get index: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options?.from,\n        to: options?.to,\n        frozenAt: options?.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  /**\n   * Returns the type of the stream\n   */\n  public async getType(\n      stream: StreamLocator,\n  ): Promise<StreamType> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.TypeKey);\n\n    if (!result) {\n      throw new Error(\"Failed to get stream type\");\n    }\n\n    const type = head(result).unwrapOrElse(() => {\n      throw new Error(\n        \"Failed to get stream type. Check if the stream is initialized.\",\n      );\n    });\n\n    const validTypes = [StreamType.Primitive, StreamType.Composed];\n\n    if (!validTypes.includes(type.value as StreamType)) {\n      throw new Error(`Invalid stream type: ${type.value}`);\n    }\n\n    return type.value as StreamType;\n  }\n\n  /**\n   * Returns the first record of the stream\n   * @deprecated Use getFirstRecord(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getFirstRecord(\n    input: GetFirstRecordInput,\n  ): Promise<StreamRecord | null>;\n  public async getFirstRecord(\n    stream: StreamLocator,\n    options?: GetFirstRecordOptions\n  ): Promise<CacheAwareResponse<StreamRecord | null>>;\n  public async getFirstRecord(\n    inputOrStream: GetFirstRecordInput | StreamLocator,\n    options?: GetFirstRecordOptions\n  ): Promise<StreamRecord | null | CacheAwareResponse<StreamRecord | null>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetFirstRecordInput;\n      if (!Action._legacyWarnEmitted.getFirstRecord) {\n        Action._legacyWarnEmitted.getFirstRecord = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getFirstRecord(input). Use getFirstRecord(stream, options?) instead.');\n        }\n      }\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        \"get_first_record\",\n          {\n              $data_provider: input.stream.dataProvider.getAddress(),\n              $stream_id: input.stream.streamId.getId(),\n              $after: input.after,\n              $frozen_at: input.frozenAt,\n          }\n      );\n\n      return result\n        .mapRight(head)\n        .mapRight((result) =>\n          result\n            .map((result) => ({\n              eventTime: result.event_time,\n              value: result.value,\n            }))\n            .unwrapOr(null),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetFirstRecordOptions(options);\n    }\n    \n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $after: options?.after,\n      $frozen_at: options?.frozenAt,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: \"get_first_record\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get first record: ${result.status}`);\n    }\n    \n    const rawData = result.data?.result as { event_time: number; value: string }[];\n    const data = rawData && rawData.length > 0 ? {\n      eventTime: rawData[0].event_time,\n      value: rawData[0].value,\n    } : null;\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        frozenAt: options?.frozenAt,\n        rowsServed: data ? 1 : 0\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  protected async setMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    value: MetadataValueTypeForKey<K>,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.executeWithNamedParams(\"insert_metadata\", [{\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $value: value,\n        $val_type: MetadataKeyValueMap[key],\n        },\n    ]);\n  }\n\n  protected async getMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    // onlyLatest: boolean = true,\n    filteredRef?: string,\n    limit?: number,\n    offset?: number,\n    orderBy?: string,\n  ): Promise<\n    { rowId: string; value: MetadataValueTypeForKey<K>; createdAt: number }[]\n  > {\n    const result = await this.call<\n      {\n        row_id: string;\n        value_i: number;\n        value_f: string;\n        value_b: boolean;\n        value_s: string;\n        value_ref: string;\n        created_at: number;\n      }[]\n    >(\"get_metadata\", {\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $ref: filteredRef,\n        $limit: limit,\n        $offset: offset,\n        $order_by: orderBy,\n        },\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          rowId: row.row_id,\n          value: row[\n            MetadataTableKey[MetadataKeyValueMap[key as MetadataKey]]\n          ] as MetadataValueTypeForKey<K>,\n          createdAt: row.created_at,\n        })),\n      )\n      .throw();\n  }\n\n  public async listMetadataByHeight<K extends MetadataKey>(\n    params: ListMetadataByHeightParams = {},\n  ): Promise<MetadataQueryResult[]> {\n     type MetadataRawResult = {\n        stream_id: string;\n        data_provider: string;\n        row_id: string;\n        value_i: number | null;\n        value_f: string | null;\n        value_b: boolean | null;\n        value_s: string | null;\n        value_ref: string | null;\n        created_at: number;\n    }[];\n    const result = await this.call<MetadataRawResult>(\n      \"list_metadata_by_height\",\n      {\n        $key: params.key ?? \"\",\n        $ref: params.value ?? null,\n        $from_height: params.fromHeight ?? null,\n        $to_height: params.toHeight ?? null,\n        $limit: params.limit ?? null,\n        $offset: params.offset ?? null,\n      },\n    );\n\n    return result\n      .mapRight((records) => \n        records.map(record => ({\n          streamId: record.stream_id,\n          dataProvider: record.data_provider,\n          rowId: record.row_id,\n          valueInt: record.value_i,\n          valueFloat: record.value_f,\n          valueBoolean: record.value_b,\n          valueString: record.value_s,\n          valueRef: record.value_ref,\n          createdAt: record.created_at,\n        }))\n      )\n      .throw();\n  }\n\n  /**\n   * Sets the read visibility of the stream\n   */\n  public async setReadVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n        stream,\n      MetadataKey.ReadVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the read visibility of the stream\n   */\n  public async getReadVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.ReadVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Sets the compose visibility of the stream\n   */\n  public async setComposeVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the compose visibility of the stream\n   */\n  public async getComposeVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Allows a wallet to read the stream\n   */\n  public async allowReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n  }\n\n  /**\n   * Disables a wallet from reading the stream\n   */\n  public async disableReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Wallet not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  /**\n   * Allows a stream to use this stream as child\n   */\n  public async allowComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.streamId.getId(),\n    );\n  }\n\n  /**\n   * Disables a stream from using this stream as child\n   */\n  public async disableComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.toString(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Stream not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  protected async disableMetadata(\n    stream: StreamLocator,\n    rowId: string,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.executeWithNamedParams(\"disable_metadata\", [{\n            $data_provider: stream.dataProvider.getAddress(),\n            $stream_id: stream.streamId.getId(),\n            $row_id: rowId,\n    }]);\n  }\n\n  /**\n   * Returns the wallets allowed to read the stream\n   */\n  public async getAllowedReadWallets(\n    stream: StreamLocator,\n  ): Promise<EthereumAddress[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowReadWalletKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => new EthereumAddress(row.value));\n  }\n\n  /**\n   * Returns the streams allowed to compose the stream\n   */\n  public async getAllowedComposeStreams(\n    stream: StreamLocator,\n  ): Promise<StreamLocator[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowComposeStreamKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => {\n        const [streamId, dataProvider] = row.value.split(\":\");\n        return {\n          streamId: StreamId.fromString(streamId).throw(),\n          dataProvider: new EthereumAddress(dataProvider),\n        };\n      });\n  }\n\n  /**\n   * Returns the index change of the stream within the given date range\n   * @deprecated Use getIndexChange(stream, options) to leverage cache support and future-proof parameter handling.\n   */\n  public async getIndexChange(\n    input: GetIndexChangeInput,\n  ): Promise<StreamRecord[]>;\n  public async getIndexChange(\n    stream: StreamLocator,\n    options: GetIndexChangeOptions\n  ): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getIndexChange(\n    inputOrStream: GetIndexChangeInput | StreamLocator,\n    options?: GetIndexChangeOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetIndexChangeInput;\n      if (!Action._legacyWarnEmitted.getIndexChange) {\n        Action._legacyWarnEmitted.getIndexChange = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getIndexChange(input). Use getIndexChange(stream, options?) instead.');\n        }\n      }\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        \"get_index_change\", \n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n            $base_time: input.baseTime,\n            $time_interval: input.timeInterval,\n          }\n      );\n\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    if (!options) {\n      throw new Error('Options parameter is required for cache-aware getIndexChange');\n    }\n    \n    // Validate options\n    CacheValidation.validateGetIndexChangeOptions(options);\n    CacheValidation.validateTimeRange(options.from, options.to);\n    \n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options.from,\n      $to: options.to,\n      $frozen_at: options.frozenAt,\n      $base_time: options.baseTime,\n      $time_interval: options.timeInterval,\n    };\n    \n    if (options.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: \"get_index_change\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get index change: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options.from,\n        to: options.to,\n        frozenAt: options.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  /**\n   * A custom method that accepts the procedure name and the input of GetRecordInput\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_price\" that returns a list of date_value and value\n   * can be called with customGetProcedure(\"get_price\", { dateFrom: \"2021-01-01\", dateTo: \"2021-01-31\" })\n   */\n  public async customGetProcedure(\n    procedure: string,\n    input: GetRecordInput,\n  ): Promise<StreamRecord[]> {\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      procedure,\n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt\n        }\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n\n  /**\n   * A custom method that accepts the procedure name and custom input of type Record<string, any>\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_custom_index\" that returns a list of date_value and value\n   * can be called with customProcedureWithArgs(\"get_custom_index\", { $customArg1: \"value1\", $customArg2: \"value2\" })\n   * where $customArg1 and $customArg2 are the arguments of the procedure\n   * @param procedure\n   * @param args\n   */\n  public async customProcedureWithArgs(\n    procedure: string,\n    args: Record<string, Types.ValueType | Types.ValueType[]>,\n  ){\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          procedure,\n          args\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the size of database\n   */\n  public async getDatabaseSize(): Promise<BigInt> {\n    const result = await this.call<{ database_size: BigInt }[]>(\"get_database_size_v2\", {})\n    return result\n      .map((rows) => {\n        const raw = rows[0].database_size;\n        const asBigInt = BigInt(raw.toString());\n        return asBigInt;\n      }).throw();\n  }\n\n  /**\n   * Returns the size of database in human-readable format (e.g., \"22 GB\", \"1.5 TB\")\n   */\n  public async getDatabaseSizePretty(): Promise<string> {\n    const result = await this.call<{ database_size_pretty: string }[]>(\"get_database_size_v2_pretty\", {})\n    return result\n      .map((rows) => rows[0].database_size_pretty)\n      .throw();\n  }\n\n  /**\n   * Gets the wallet balance for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\", \"ethereum\")\n   *                         This corresponds to the bridge instance name in TN (e.g., hoodi_tt for Hoodi Test Token bridge)\n   * @param walletAddress The wallet address to check balance for\n   * @returns Promise that resolves to the balance as a string (in wei), or throws on error\n   * @example\n   * ```typescript\n   * // Simple case - identifier matches network name\n   * const balance = await action.getWalletBalance(\"sepolia\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   *\n   * // Multi-token bridge - specify bridge instance explicitly\n   * const balance = await action.getWalletBalance(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   * ```\n   */\n  public async getWalletBalance(\n    bridgeIdentifier: string,\n    walletAddress: string\n  ): Promise<string> {\n    const result = await this.call<{ balance?: string; }[]>(\n      `${bridgeIdentifier}_wallet_balance`,\n      {\n        $wallet_address: walletAddress,\n      }\n    );\n\n    return result\n      .mapRight((rows) => {\n        if (rows.length === 0) {\n          throw new Error(\"You don't have necessary permissions to execute this query\");\n        }\n\n        const row = rows[0];\n\n        if (row.balance === undefined) {\n          throw new Error(\"No balance returned from wallet balance query\");\n        }\n\n        return row.balance;\n      })\n      .throw();\n  }\n\n  /**\n   * Calls the whoami action to get the caller's wallet address\n   * This is useful for verifying wallet authentication with TN\n   * @returns Promise that resolves to the caller's wallet address\n   */\n  public async whoami(): Promise<string> {\n    const result = await this.call<{ caller: string }[]>(\n      \"whoami\",\n      {}\n    );\n\n    return result\n      .mapRight((rows) => {\n        if (rows.length === 0) {\n          throw new Error(\"No response from whoami action\");\n        }\n        \n        const row = rows[0];\n        \n        if (!row.caller) {\n          throw new Error(\"No caller address returned from whoami\");\n        }\n        \n        return row.caller;\n      })\n      .throw();\n  }\n\n  /**\n   * Bridges tokens by initiating a withdrawal from TN to a blockchain network\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\", \"ethereum\")\n   * @param amount The amount to bridge in wei (as string to preserve precision)\n   * @param recipient The recipient address on the destination chain\n   * @returns Promise that resolves to transaction receipt\n   * @example\n   * ```typescript\n   * // Bridge 100 tokens from TN to Sepolia\n   * const receipt = await action.bridgeTokens(\"sepolia\", \"100000000000000000000\", \"0x742d35Cc...\");\n   *\n   * // Bridge from TN to Hoodi Test Token bridge\n   * const receipt = await action.bridgeTokens(\"hoodi_tt\", \"50000000000000000000\", \"0x742d35Cc...\");\n   * ```\n   */\n  public async bridgeTokens(\n    bridgeIdentifier: string,\n    amount: string,\n    recipient: string\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    // Validate amount is greater than 0\n    const numAmount = parseFloat(amount);\n    if (isNaN(numAmount) || numAmount <= 0) {\n      throw new Error(`Invalid amount: ${amount}. Amount must be greater than 0.`);\n    }\n\n    return await this.executeWithNamedParams(`${bridgeIdentifier}_bridge_tokens`, [{\n      $recipient: recipient,\n      $amount: amount\n    }]);\n  }\n\n  /**\n   * Lists wallet rewards for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\")\n   * @param wallet The wallet address to list rewards for\n   * @param withPending Whether to include pending rewards\n   * @returns Promise that resolves to array of reward records\n   * @deprecated This method uses the extension namespace directly. Most users should use getWithdrawalProof instead.\n   */\n  public async listWalletRewards(\n    bridgeIdentifier: string,\n    wallet: string,\n    withPending: boolean\n  ): Promise<any[]> {\n    const result = await this.kwilClient.call(\n      {\n        namespace: `${bridgeIdentifier}_bridge`,\n        name: \"list_wallet_rewards\",\n        inputs: {\n          $param_1: wallet,\n          $param_2: withPending,\n        },\n      },\n      this.kwilSigner,\n    );\n\n    if (result.status !== 200) {\n      throw new Error(`Failed to list wallet rewards: ${result.status}`);\n    }\n\n    return result.data?.result || [];\n  }\n\n  /**\n   * Gets withdrawal proof for a wallet address on a specific bridge instance\n   * Returns merkle proofs and validator signatures needed for claiming withdrawals on the destination chain\n   *\n   * This method is used for non-custodial bridge withdrawals where users need to\n   * manually claim their withdrawals by submitting proofs to the destination chain contract.\n   *\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"hoodi_tt\", \"sepolia\", \"ethereum\")\n   * @param walletAddress The wallet address to get withdrawal proof for\n   * @returns Promise that resolves to array of withdrawal proofs (empty array if no unclaimed withdrawals)\n   *\n   * @example\n   * ```typescript\n   * // Get withdrawal proofs for Hoodi Test Token bridge\n   * const proofs = await action.getWithdrawalProof(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   * // Returns: [{ chain: \"hoodi\", recipient: \"0x...\", amount: \"100000000000000000000\", proofs: [...], signatures: [...] }]\n   *\n   * // Use the proofs to claim withdrawal on destination chain\n   * if (proofs.length > 0) {\n   *   const proof = proofs[0];\n   *   await bridgeContract.claimWithdrawal(proof.recipient, proof.amount, proof.root, proof.proofs, proof.signatures);\n   * }\n   * ```\n   *\n   * @note This method has been tested via integration tests in the node repository.\n   * See: https://github.com/trufnetwork/kwil-db/blob/main/node/exts/erc20-bridge/erc20/meta_extension_withdrawal_test.go\n   */\n  public async getWithdrawalProof(\n    bridgeIdentifier: string,\n    walletAddress: string\n  ): Promise<WithdrawalProof[]> {\n    const result = await this.call<WithdrawalProof[]>(\n      `${bridgeIdentifier}_get_withdrawal_proof`,\n      {\n        $wallet_address: walletAddress,\n      }\n    );\n\n    return result\n      .mapRight((rows) => {\n        // Return the array of withdrawal proofs\n        // May be empty if no unclaimed withdrawals\n        return rows || [];\n      })\n      .throw();\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {KwilSigner, NodeKwil, WebKwil, Types} from \"@trufnetwork/kwil-js\";\nimport { Either } from \"monads-io\";\nimport { WithdrawalProof, BridgeHistory } from \"../types/bridge\";\nimport { DateString } from \"../types/other\";\nimport { StreamLocator } from \"../types/stream\";\nimport { CacheAwareResponse, GetRecordOptions, GetIndexOptions, GetIndexChangeOptions, GetFirstRecordOptions } from \"../types/cache\";\nimport { EthereumAddress } from \"../util/EthereumAddress\";\nimport { head } from \"../util/head\";\nimport { StreamId } from \"../util/StreamId\";\nimport { toVisibilityEnum, VisibilityEnum } from \"../util/visibility\";\nimport { CacheMetadataParser } from \"../util/cacheMetadataParser\";\nimport { CacheValidation } from \"../util/cacheValidation\";\nimport {\n  MetadataKey,\n  MetadataKeyValueMap,\n  MetadataTableKey,\n  MetadataValueTypeForKey,\n  StreamType,\n} from \"./contractValues\";\n// ValueType is available as Types.ValueType\n\nexport interface GetRecordInput {\n  stream: StreamLocator;\n  from?: number;\n  to?: number;\n  frozenAt?: number;\n  baseTime?: DateString | number;\n  prefix?: string;\n}\n\nexport interface GetFirstRecordInput {\n  stream: StreamLocator;\n  after?: number;\n  frozenAt?: number;\n}\n\nexport interface StreamRecord {\n  eventTime: number;\n  value: string;\n}\n\nexport interface GetIndexChangeInput extends GetRecordInput {\n  timeInterval: number;\n}\n\nexport interface ListMetadataByHeightParams {\n  /** Key reference filter. Default: empty string */\n  key?: string;\n  /** Value reference filter. Default: null */\n  value?: string;\n  /** Start height (inclusive). If null, uses earliest available. */\n  fromHeight?: number;\n  /** End height (inclusive). If null, uses current height. */\n  toHeight?: number;\n  /** Maximum number of results to return. Default: 1000 */\n  limit?: number;\n  /** Number of results to skip for pagination. Default: 0 */\n  offset?: number;\n}\n\nexport interface MetadataQueryResult {\n  streamId: string;\n  dataProvider: string;\n  rowId: string;\n  valueInt: number | null;\n  valueFloat: string | null;\n  valueBoolean: boolean | null;\n  valueString: string | null;\n  valueRef: string | null;\n  createdAt: number;\n}\n\nexport class Action {\n  protected kwilClient: WebKwil | NodeKwil;\n  protected kwilSigner: KwilSigner;\n  /** Track if deprecation warnings were already emitted */\n  private static _legacyWarnEmitted: Record<string, boolean> = {\n    getRecord: false,\n    getIndex: false,\n    getFirstRecord: false,\n    getIndexChange: false,\n  };\n  constructor(\n    kwilClient: WebKwil | NodeKwil,\n    kwilSigner: KwilSigner,\n  ) {\n    this.kwilClient = kwilClient;\n    this.kwilSigner = kwilSigner;\n  }\n\n  /**\n   * Executes a stream method with named parameters\n   * @param method - The action name to execute\n   * @param inputs - Named parameters for the action\n   * @param types - Optional type specifications for parameters (e.g., NUMERIC)\n   * @returns Transaction receipt\n   */\n  protected async executeWithNamedParams(\n    method: string,\n    inputs: Types.NamedParams[],\n    types?: Record<string, any>,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return this.kwilClient.execute({\n          namespace: \"main\",\n          name: method,\n          inputs,\n          types,\n          description: `TN SDK - Executing method on stream: ${method}`,\n        },\n        this.kwilSigner,\n        );\n  }\n\n  /**\n   * Executes a stream action with a complete ActionBody\n   * @param inputs - Complete action body with all execution parameters\n   * @param synchronous - Whether to wait for transaction to be mined\n   * @returns Transaction receipt\n   */\n  protected async executeWithActionBody(\n    inputs: Types.ActionBody,\n    synchronous: boolean = false,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return this.kwilClient.execute(inputs, this.kwilSigner, synchronous);\n  }\n\n  /**\n   * Calls a method on the stream\n   */\n  protected async call<T>(\n    method: string,\n    inputs: Types.NamedParams,\n  ): Promise<Either<number, T>> {\n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: method,\n        inputs: inputs,\n      },\n      this.kwilSigner,\n    );\n\n    if (result.status !== 200) {\n      return Either.left(result.status);\n    }\n\n    return Either.right(result.data?.result as T);\n  }\n\n  /**\n   * @deprecated Use getRecord(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getRecord(input: GetRecordInput): Promise<StreamRecord[]>;\n  public async getRecord(stream: StreamLocator, options?: GetRecordOptions): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getRecord(\n    inputOrStream: GetRecordInput | StreamLocator,\n    options?: GetRecordOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetRecordInput;\n      // emit deprecation warning once\n      if (!Action._legacyWarnEmitted.getRecord) {\n        Action._legacyWarnEmitted.getRecord = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getRecord(input). Use getRecord(stream, options?) instead.');\n        }\n      }\n      const prefix = input.prefix ? input.prefix : \"\"\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          prefix + \"get_record\",\n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n          }\n      );\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetRecordOptions(options);\n      CacheValidation.validateTimeRange(options.from, options.to);\n    }\n    \n    const prefix = options?.prefix ? options.prefix : \"\"\n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options?.from,\n      $to: options?.to,\n      $frozen_at: options?.frozenAt,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: prefix + \"get_record\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get record: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options?.from,\n        to: options?.to,\n        frozenAt: options?.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined,\n    };\n  }\n\n  /**\n   * Returns the index of the stream within the given date range\n   * @deprecated Use getIndex(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getIndex(input: GetRecordInput): Promise<StreamRecord[]>;\n  public async getIndex(stream: StreamLocator, options?: GetIndexOptions): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getIndex(\n    inputOrStream: GetRecordInput | StreamLocator,\n    options?: GetIndexOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetRecordInput;\n      if (!Action._legacyWarnEmitted.getIndex) {\n        Action._legacyWarnEmitted.getIndex = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getIndex(input). Use getIndex(stream, options?) instead.');\n        }\n      }\n      const prefix = input.prefix ? input.prefix : \"\"\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        prefix + \"get_index\",\n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n            $base_time: input.baseTime,\n          }\n      );\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetIndexOptions(options);\n      CacheValidation.validateTimeRange(options.from, options.to);\n    }\n    \n    const prefix = options?.prefix ? options.prefix : \"\"\n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options?.from,\n      $to: options?.to,\n      $frozen_at: options?.frozenAt,\n      $base_time: options?.baseTime,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: prefix + \"get_index\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get index: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options?.from,\n        to: options?.to,\n        frozenAt: options?.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  /**\n   * Returns the type of the stream\n   */\n  public async getType(\n      stream: StreamLocator,\n  ): Promise<StreamType> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.TypeKey);\n\n    if (!result) {\n      throw new Error(\"Failed to get stream type\");\n    }\n\n    const type = head(result).unwrapOrElse(() => {\n      throw new Error(\n        \"Failed to get stream type. Check if the stream is initialized.\",\n      );\n    });\n\n    const validTypes = [StreamType.Primitive, StreamType.Composed];\n\n    if (!validTypes.includes(type.value as StreamType)) {\n      throw new Error(`Invalid stream type: ${type.value}`);\n    }\n\n    return type.value as StreamType;\n  }\n\n  /**\n   * Returns the first record of the stream\n   * @deprecated Use getFirstRecord(stream, options?) to leverage cache support and future-proof parameter handling.\n   */\n  public async getFirstRecord(\n    input: GetFirstRecordInput,\n  ): Promise<StreamRecord | null>;\n  public async getFirstRecord(\n    stream: StreamLocator,\n    options?: GetFirstRecordOptions\n  ): Promise<CacheAwareResponse<StreamRecord | null>>;\n  public async getFirstRecord(\n    inputOrStream: GetFirstRecordInput | StreamLocator,\n    options?: GetFirstRecordOptions\n  ): Promise<StreamRecord | null | CacheAwareResponse<StreamRecord | null>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetFirstRecordInput;\n      if (!Action._legacyWarnEmitted.getFirstRecord) {\n        Action._legacyWarnEmitted.getFirstRecord = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getFirstRecord(input). Use getFirstRecord(stream, options?) instead.');\n        }\n      }\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        \"get_first_record\",\n          {\n              $data_provider: input.stream.dataProvider.getAddress(),\n              $stream_id: input.stream.streamId.getId(),\n              $after: input.after,\n              $frozen_at: input.frozenAt,\n          }\n      );\n\n      return result\n        .mapRight(head)\n        .mapRight((result) =>\n          result\n            .map((result) => ({\n              eventTime: result.event_time,\n              value: result.value,\n            }))\n            .unwrapOr(null),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    \n    // Validate options if provided\n    if (options) {\n      CacheValidation.validateGetFirstRecordOptions(options);\n    }\n    \n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $after: options?.after,\n      $frozen_at: options?.frozenAt,\n    };\n    \n    if (options?.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: \"get_first_record\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get first record: ${result.status}`);\n    }\n    \n    const rawData = result.data?.result as { event_time: number; value: string }[];\n    const data = rawData && rawData.length > 0 ? {\n      eventTime: rawData[0].event_time,\n      value: rawData[0].value,\n    } : null;\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        frozenAt: options?.frozenAt,\n        rowsServed: data ? 1 : 0\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  protected async setMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    value: MetadataValueTypeForKey<K>,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.executeWithNamedParams(\"insert_metadata\", [{\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $value: value,\n        $val_type: MetadataKeyValueMap[key],\n        },\n    ]);\n  }\n\n  protected async getMetadata<K extends MetadataKey>(\n    stream: StreamLocator,\n    key: K,\n    // onlyLatest: boolean = true,\n    filteredRef?: string,\n    limit?: number,\n    offset?: number,\n    orderBy?: string,\n  ): Promise<\n    { rowId: string; value: MetadataValueTypeForKey<K>; createdAt: number }[]\n  > {\n    const result = await this.call<\n      {\n        row_id: string;\n        value_i: number;\n        value_f: string;\n        value_b: boolean;\n        value_s: string;\n        value_ref: string;\n        created_at: number;\n      }[]\n    >(\"get_metadata\", {\n        $data_provider: stream.dataProvider.getAddress(),\n        $stream_id: stream.streamId.getId(),\n        $key: key,\n        $ref: filteredRef,\n        $limit: limit,\n        $offset: offset,\n        $order_by: orderBy,\n        },\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          rowId: row.row_id,\n          value: row[\n            MetadataTableKey[MetadataKeyValueMap[key as MetadataKey]]\n          ] as MetadataValueTypeForKey<K>,\n          createdAt: row.created_at,\n        })),\n      )\n      .throw();\n  }\n\n  public async listMetadataByHeight<K extends MetadataKey>(\n    params: ListMetadataByHeightParams = {},\n  ): Promise<MetadataQueryResult[]> {\n     type MetadataRawResult = {\n        stream_id: string;\n        data_provider: string;\n        row_id: string;\n        value_i: number | null;\n        value_f: string | null;\n        value_b: boolean | null;\n        value_s: string | null;\n        value_ref: string | null;\n        created_at: number;\n    }[];\n    const result = await this.call<MetadataRawResult>(\n      \"list_metadata_by_height\",\n      {\n        $key: params.key ?? \"\",\n        $ref: params.value ?? null,\n        $from_height: params.fromHeight ?? null,\n        $to_height: params.toHeight ?? null,\n        $limit: params.limit ?? null,\n        $offset: params.offset ?? null,\n      },\n    );\n\n    return result\n      .mapRight((records) => \n        records.map(record => ({\n          streamId: record.stream_id,\n          dataProvider: record.data_provider,\n          rowId: record.row_id,\n          valueInt: record.value_i,\n          valueFloat: record.value_f,\n          valueBoolean: record.value_b,\n          valueString: record.value_s,\n          valueRef: record.value_ref,\n          createdAt: record.created_at,\n        }))\n      )\n      .throw();\n  }\n\n  /**\n   * Sets the read visibility of the stream\n   */\n  public async setReadVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n        stream,\n      MetadataKey.ReadVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the read visibility of the stream\n   */\n  public async getReadVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.ReadVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Sets the compose visibility of the stream\n   */\n  public async setComposeVisibility(\n    stream: StreamLocator,\n    visibility: VisibilityEnum,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey,\n      visibility.toString(),\n    );\n  }\n\n  /**\n   * Returns the compose visibility of the stream\n   */\n  public async getComposeVisibility(\n      stream: StreamLocator,\n  ): Promise<VisibilityEnum | null> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.ComposeVisibilityKey);\n\n    return head(result)\n      .map((row) => toVisibilityEnum(row.value))\n      .unwrapOr(null);\n  }\n\n  /**\n   * Allows a wallet to read the stream\n   */\n  public async allowReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n  }\n\n  /**\n   * Disables a wallet from reading the stream\n   */\n  public async disableReadWallet(\n    stream: StreamLocator,\n    wallet: EthereumAddress,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowReadWalletKey,\n      wallet.getAddress(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Wallet not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  /**\n   * Allows a stream to use this stream as child\n   */\n  public async allowComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.setMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.streamId.getId(),\n    );\n  }\n\n  /**\n   * Disables a stream from using this stream as child\n   */\n  public async disableComposeStream(\n    stream: StreamLocator,\n    wallet: StreamLocator,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    const result = await this.getMetadata(\n      stream,\n      MetadataKey.AllowComposeStreamKey,\n      wallet.toString(),\n    );\n\n    const row_id = head(result)\n      .map((row) => row.rowId)\n      .unwrapOr(null);\n\n    if (!row_id) {\n      throw new Error(\"Stream not found in allowed list\");\n    }\n\n    return await this.disableMetadata(stream, row_id);\n  }\n\n  protected async disableMetadata(\n    stream: StreamLocator,\n    rowId: string,\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    return await this.executeWithNamedParams(\"disable_metadata\", [{\n            $data_provider: stream.dataProvider.getAddress(),\n            $stream_id: stream.streamId.getId(),\n            $row_id: rowId,\n    }]);\n  }\n\n  /**\n   * Returns the wallets allowed to read the stream\n   */\n  public async getAllowedReadWallets(\n    stream: StreamLocator,\n  ): Promise<EthereumAddress[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowReadWalletKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => new EthereumAddress(row.value));\n  }\n\n  /**\n   * Returns the streams allowed to compose the stream\n   */\n  public async getAllowedComposeStreams(\n    stream: StreamLocator,\n  ): Promise<StreamLocator[]> {\n    const result = await this.getMetadata(\n        stream,\n        MetadataKey.AllowComposeStreamKey);\n\n    return result\n      .filter((row) => row.value)\n      .map((row) => {\n        const [streamId, dataProvider] = row.value.split(\":\");\n        return {\n          streamId: StreamId.fromString(streamId).throw(),\n          dataProvider: new EthereumAddress(dataProvider),\n        };\n      });\n  }\n\n  /**\n   * Returns the index change of the stream within the given date range\n   * @deprecated Use getIndexChange(stream, options) to leverage cache support and future-proof parameter handling.\n   */\n  public async getIndexChange(\n    input: GetIndexChangeInput,\n  ): Promise<StreamRecord[]>;\n  public async getIndexChange(\n    stream: StreamLocator,\n    options: GetIndexChangeOptions\n  ): Promise<CacheAwareResponse<StreamRecord[]>>;\n  public async getIndexChange(\n    inputOrStream: GetIndexChangeInput | StreamLocator,\n    options?: GetIndexChangeOptions\n  ): Promise<StreamRecord[] | CacheAwareResponse<StreamRecord[]>> {\n    // Handle backward compatibility\n    if ('stream' in inputOrStream) {\n      // Legacy call format\n      const input = inputOrStream as GetIndexChangeInput;\n      if (!Action._legacyWarnEmitted.getIndexChange) {\n        Action._legacyWarnEmitted.getIndexChange = true;\n        if (typeof console !== 'undefined' && console.warn) {\n          console.warn('[TN SDK] Deprecated signature: getIndexChange(input). Use getIndexChange(stream, options?) instead.');\n        }\n      }\n      const result = await this.call<{ event_time: number; value: string }[]>(\n        \"get_index_change\", \n          {\n            $data_provider: input.stream.dataProvider.getAddress(),\n            $stream_id: input.stream.streamId.getId(),\n            $from: input.from,\n            $to: input.to,\n            $frozen_at: input.frozenAt,\n            $base_time: input.baseTime,\n            $time_interval: input.timeInterval,\n          }\n      );\n\n      return result\n        .mapRight((result) =>\n          result.map((row) => ({\n            eventTime: row.event_time,\n            value: row.value,\n          })),\n        )\n        .throw();\n    }\n    \n    // New cache-aware call format\n    const stream = inputOrStream as StreamLocator;\n    if (!options) {\n      throw new Error('Options parameter is required for cache-aware getIndexChange');\n    }\n    \n    // Validate options\n    CacheValidation.validateGetIndexChangeOptions(options);\n    CacheValidation.validateTimeRange(options.from, options.to);\n    \n    const params: any = {\n      $data_provider: stream.dataProvider.getAddress(),\n      $stream_id: stream.streamId.getId(),\n      $from: options.from,\n      $to: options.to,\n      $frozen_at: options.frozenAt,\n      $base_time: options.baseTime,\n      $time_interval: options.timeInterval,\n    };\n    \n    if (options.useCache !== undefined) {\n      params.$use_cache = options.useCache;\n    }\n    \n    const result = await this.kwilClient.call(\n      {\n        namespace: \"main\",\n        name: \"get_index_change\",\n        inputs: params,\n      },\n      this.kwilSigner,\n    );\n    \n    if (result.status !== 200) {\n      throw new Error(`Failed to get index change: ${result.status}`);\n    }\n    \n    const data = (result.data?.result as { event_time: number; value: string }[]).map((row) => ({\n      eventTime: row.event_time,\n      value: row.value,\n    }));\n    \n    let cache = CacheMetadataParser.extractFromResponse(result);\n    \n    // Enhance cache metadata with SDK-provided context\n    if (cache) {\n      cache = {\n        ...cache,\n        streamId: stream.streamId.getId(),\n        dataProvider: stream.dataProvider.getAddress(),\n        from: options.from,\n        to: options.to,\n        frozenAt: options.frozenAt,\n        rowsServed: data.length\n      };\n    }\n    \n    return {\n      data,\n      cache: cache || undefined,\n      logs: result.data?.logs ? CacheMetadataParser.parseLogsForMetadata(result.data.logs) : undefined\n    };\n  }\n\n  /**\n   * A custom method that accepts the procedure name and the input of GetRecordInput\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_price\" that returns a list of date_value and value\n   * can be called with customGetProcedure(\"get_price\", { dateFrom: \"2021-01-01\", dateTo: \"2021-01-31\" })\n   */\n  public async customGetProcedure(\n    procedure: string,\n    input: GetRecordInput,\n  ): Promise<StreamRecord[]> {\n    const result = await this.call<{ event_time: number; value: string }[]>(\n      procedure,\n        {\n          $data_provider: input.stream.dataProvider.getAddress(),\n          $stream_id: input.stream.streamId.getId(),\n          $from: input.from,\n          $to: input.to,\n          $frozen_at: input.frozenAt\n        }\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n\n  /**\n   * A custom method that accepts the procedure name and custom input of type Record<string, any>\n   * Returns the result of the procedure in the same format as StreamRecord\n   * I.e. a custom procedure named \"get_custom_index\" that returns a list of date_value and value\n   * can be called with customProcedureWithArgs(\"get_custom_index\", { $customArg1: \"value1\", $customArg2: \"value2\" })\n   * where $customArg1 and $customArg2 are the arguments of the procedure\n   * @param procedure\n   * @param args\n   */\n  public async customProcedureWithArgs(\n    procedure: string,\n    args: Record<string, Types.ValueType | Types.ValueType[]>,\n  ){\n      const result = await this.call<{ event_time: number; value: string }[]>(\n          procedure,\n          args\n    );\n    return result\n      .mapRight((result) =>\n        result.map((row) => ({\n          eventTime: row.event_time,\n          value: row.value,\n        })),\n      )\n      .throw();\n  }\n\n  /**\n   * Returns the size of database\n   */\n  public async getDatabaseSize(): Promise<BigInt> {\n    const result = await this.call<{ database_size: BigInt }[]>(\"get_database_size_v2\", {})\n    return result\n      .map((rows) => {\n        const raw = rows[0].database_size;\n        const asBigInt = BigInt(raw.toString());\n        return asBigInt;\n      }).throw();\n  }\n\n  /**\n   * Returns the size of database in human-readable format (e.g., \"22 GB\", \"1.5 TB\")\n   */\n  public async getDatabaseSizePretty(): Promise<string> {\n    const result = await this.call<{ database_size_pretty: string }[]>(\"get_database_size_v2_pretty\", {})\n    return result\n      .map((rows) => rows[0].database_size_pretty)\n      .throw();\n  }\n\n  /**\n   * Gets the wallet balance for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\", \"ethereum\")\n   *                         This corresponds to the bridge instance name in TN (e.g., hoodi_tt for Hoodi Test Token bridge)\n   * @param walletAddress The wallet address to check balance for\n   * @returns Promise that resolves to the balance as a string (in wei), or throws on error\n   * @example\n   * ```typescript\n   * // Simple case - identifier matches network name\n   * const balance = await action.getWalletBalance(\"sepolia\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   *\n   * // Multi-token bridge - specify bridge instance explicitly\n   * const balance = await action.getWalletBalance(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   * ```\n   */\n  public async getWalletBalance(\n    bridgeIdentifier: string,\n    walletAddress: string\n  ): Promise<string> {\n    const result = await this.call<{ balance?: string; }[]>(\n      `${bridgeIdentifier}_wallet_balance`,\n      {\n        $wallet_address: walletAddress,\n      }\n    );\n\n    return result\n      .mapRight((rows) => {\n        if (rows.length === 0) {\n          throw new Error(\"You don't have necessary permissions to execute this query\");\n        }\n\n        const row = rows[0];\n\n        if (row.balance === undefined) {\n          throw new Error(\"No balance returned from wallet balance query\");\n        }\n\n        return row.balance;\n      })\n      .throw();\n  }\n\n  /**\n   * Calls the whoami action to get the caller's wallet address\n   * This is useful for verifying wallet authentication with TN\n   * @returns Promise that resolves to the caller's wallet address\n   */\n  public async whoami(): Promise<string> {\n    const result = await this.call<{ caller: string }[]>(\n      \"whoami\",\n      {}\n    );\n\n    return result\n      .mapRight((rows) => {\n        if (rows.length === 0) {\n          throw new Error(\"No response from whoami action\");\n        }\n        \n        const row = rows[0];\n        \n        if (!row.caller) {\n          throw new Error(\"No caller address returned from whoami\");\n        }\n        \n        return row.caller;\n      })\n      .throw();\n  }\n\n  /**\n   * Bridges tokens by initiating a withdrawal from TN to a blockchain network\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\", \"ethereum\")\n   * @param amount The amount to bridge in wei (as string to preserve precision)\n   * @param recipient The recipient address on the destination chain\n   * @returns Promise that resolves to transaction receipt\n   * @example\n   * ```typescript\n   * // Bridge 100 tokens from TN to Sepolia\n   * const receipt = await action.bridgeTokens(\"sepolia\", \"100000000000000000000\", \"0x742d35Cc...\");\n   *\n   * // Bridge from TN to Hoodi Test Token bridge\n   * const receipt = await action.bridgeTokens(\"hoodi_tt\", \"50000000000000000000\", \"0x742d35Cc...\");\n   * ```\n   */\n  public async bridgeTokens(\n    bridgeIdentifier: string,\n    amount: string,\n    recipient: string\n  ): Promise<Types.GenericResponse<Types.TxReceipt>> {\n    // Validate amount is greater than 0\n    const numAmount = parseFloat(amount);\n    if (isNaN(numAmount) || numAmount <= 0) {\n      throw new Error(`Invalid amount: ${amount}. Amount must be greater than 0.`);\n    }\n\n    return await this.executeWithNamedParams(`${bridgeIdentifier}_bridge_tokens`, [{\n      $recipient: recipient,\n      $amount: amount\n    }]);\n  }\n\n  /**\n   * Lists wallet rewards for a specific bridge instance\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"sepolia\", \"hoodi_tt\")\n   * @param wallet The wallet address to list rewards for\n   * @param withPending Whether to include pending rewards\n   * @returns Promise that resolves to array of reward records\n   * @deprecated This method uses the extension namespace directly. Most users should use getWithdrawalProof instead.\n   */\n  public async listWalletRewards(\n    bridgeIdentifier: string,\n    wallet: string,\n    withPending: boolean\n  ): Promise<any[]> {\n    const result = await this.kwilClient.call(\n      {\n        namespace: `${bridgeIdentifier}_bridge`,\n        name: \"list_wallet_rewards\",\n        inputs: {\n          $param_1: wallet,\n          $param_2: withPending,\n        },\n      },\n      this.kwilSigner,\n    );\n\n    if (result.status !== 200) {\n      throw new Error(`Failed to list wallet rewards: ${result.status}`);\n    }\n\n    return result.data?.result || [];\n  }\n\n  /**\n   * Gets withdrawal proof for a wallet address on a specific bridge instance\n   * Returns merkle proofs and validator signatures needed for claiming withdrawals on the destination chain\n   *\n   * This method is used for non-custodial bridge withdrawals where users need to\n   * manually claim their withdrawals by submitting proofs to the destination chain contract.\n   *\n   * @param bridgeIdentifier The bridge instance identifier (e.g., \"hoodi_tt\", \"sepolia\", \"ethereum\")\n   * @param walletAddress The wallet address to get withdrawal proof for\n   * @returns Promise that resolves to array of withdrawal proofs (empty array if no unclaimed withdrawals)\n   *\n   * @example\n   * ```typescript\n   * // Get withdrawal proofs for Hoodi Test Token bridge\n   * const proofs = await action.getWithdrawalProof(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n   * // Returns: [{ chain: \"hoodi\", recipient: \"0x...\", amount: \"100000000000000000000\", proofs: [...], signatures: [...] }]\n   *\n   * // Use the proofs to claim withdrawal on destination chain\n   * if (proofs.length > 0) {\n   *   const proof = proofs[0];\n   *   await bridgeContract.claimWithdrawal(proof.recipient, proof.amount, proof.root, proof.proofs, proof.signatures);\n   * }\n   * ```\n   *\n   * @note This method has been tested via integration tests in the node repository.\n   * See: https://github.com/trufnetwork/kwil-db/blob/main/node/exts/erc20-bridge/erc20/meta_extension_withdrawal_test.go\n   */\n  public async getWithdrawalProof(\n    bridgeIdentifier: string,\n    walletAddress: string\n  ): Promise<WithdrawalProof[]> {\n    const result = await this.call<WithdrawalProof[]>(\n      `${bridgeIdentifier}_get_withdrawal_proof`,\n      {\n        $wallet_address: walletAddress,\n      }\n    );\n\n    return result\n      .mapRight((rows) => {\n        // Return the array of withdrawal proofs\n        // May be empty if no unclaimed withdrawals\n        return rows || [];\n      })\n      .throw();\n  }\n\n  /**\n   * Retrieves the unified transaction history for a wallet on a specific bridge.\n   *\n   * @param bridgeIdentifier - The name of the bridge instance (e.g., \"hoodi_tt\", \"sepolia_bridge\")\n   * @param walletAddress - The wallet address to query\n   * @param limit - Max number of records to return (default 20)\n   * @param offset - Number of records to skip (default 0)\n   * @returns Array of BridgeHistory records\n   */\n  public async getHistory(\n    bridgeIdentifier: string,\n    walletAddress: string,\n    limit: number = 20,\n    offset: number = 0\n  ): Promise<BridgeHistory[]> {\n    const result = await this.call<BridgeHistory[]>(\n      `${bridgeIdentifier}_get_history`,\n      {\n        $wallet_address: walletAddress,\n        $limit: limit,\n        $offset: offset\n      }\n    );\n\n    return result\n      .mapRight((rows) => {\n        return rows || [];\n      })\n      .throw();\n  }\n}\n"],
+  "mappings": "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",
   "names": ["prefix", "result"]
 }

package/dist/cjs/contracts-api/action.test.cjs

@@ -0,0 +1,63 @@
+"use strict";
+
+// src/contracts-api/action.test.ts
+var import_action = require("./action.cjs");
+var import_monads_io = require("monads-io");
+var import_vitest = require("vitest");
+(0, import_vitest.describe)("Action", () => {
+  const mockKwil = {
+    call: import_vitest.vi.fn()
+  };
+  const mockSigner = {
+    signatureType: "secp256k1_ep"
+  };
+  (0, import_vitest.it)("should call get_history with correct parameters", async () => {
+    const action = new import_action.Action(mockKwil, mockSigner);
+    const callSpy = import_vitest.vi.spyOn(action, "call");
+    const mockHistory = [{
+      type: "deposit",
+      amount: "100",
+      from_address: null,
+      to_address: "0x123",
+      internal_tx_hash: null,
+      external_tx_hash: "0xabc",
+      status: "completed",
+      block_height: 10,
+      block_timestamp: 1e3,
+      external_block_height: 5
+    }];
+    callSpy.mockResolvedValue(import_monads_io.Either.right(mockHistory));
+    const result = await action.getHistory("sepolia_bridge", "0x123", 10, 5);
+    (0, import_vitest.expect)(callSpy).toHaveBeenCalledWith(
+      "sepolia_bridge_get_history",
+      {
+        $wallet_address: "0x123",
+        $limit: 10,
+        $offset: 5
+      }
+    );
+    (0, import_vitest.expect)(result).toEqual(mockHistory);
+  });
+  (0, import_vitest.it)("should handle null results from get_history", async () => {
+    const action = new import_action.Action(mockKwil, mockSigner);
+    const callSpy = import_vitest.vi.spyOn(action, "call");
+    callSpy.mockResolvedValue(import_monads_io.Either.right(null));
+    const result = await action.getHistory("bridge", "0x123");
+    (0, import_vitest.expect)(result).toEqual([]);
+  });
+  (0, import_vitest.it)("should use default parameters for getHistory", async () => {
+    const action = new import_action.Action(mockKwil, mockSigner);
+    const callSpy = import_vitest.vi.spyOn(action, "call");
+    callSpy.mockResolvedValue(import_monads_io.Either.right([]));
+    await action.getHistory("bridge", "0x123");
+    (0, import_vitest.expect)(callSpy).toHaveBeenCalledWith(
+      "bridge_get_history",
+      {
+        $wallet_address: "0x123",
+        $limit: 20,
+        $offset: 0
+      }
+    );
+  });
+});
+//# sourceMappingURL=action.test.cjs.map

package/dist/cjs/contracts-api/action.test.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contracts-api/action.test.ts"],
+  "sourcesContent": ["import { Action } from \"./action\";\nimport { BridgeHistory } from \"../types/bridge\";\nimport { KwilSigner, NodeKwil } from \"@trufnetwork/kwil-js\";\nimport { Either } from \"monads-io\";\nimport { vi, describe, it, expect } from \"vitest\";\n\ndescribe(\"Action\", () => {\n    // Mock dependencies\n    const mockKwil = {\n        call: vi.fn(),\n    } as unknown as NodeKwil;\n\n    const mockSigner = {\n        signatureType: \"secp256k1_ep\",\n    } as unknown as KwilSigner;\n\n    it(\"should call get_history with correct parameters\", async () => {\n        const action = new Action(mockKwil, mockSigner);\n        \n        // Spy on the 'call' method of the action instance\n        const callSpy = vi.spyOn(action as any, \"call\");\n        \n        const mockHistory: BridgeHistory[] = [{\n            type: \"deposit\",\n            amount: \"100\",\n            from_address: null,\n            to_address: \"0x123\",\n            internal_tx_hash: null,\n            external_tx_hash: \"0xabc\",\n            status: \"completed\",\n            block_height: 10,\n            block_timestamp: 1000,\n            external_block_height: 5\n        }];\n\n        callSpy.mockResolvedValue(Either.right(mockHistory));\n\n        const result = await action.getHistory(\"sepolia_bridge\", \"0x123\", 10, 5);\n\n        expect(callSpy).toHaveBeenCalledWith(\n            \"sepolia_bridge_get_history\",\n            {\n                $wallet_address: \"0x123\",\n                $limit: 10,\n                $offset: 5\n            }\n        );\n        \n        expect(result).toEqual(mockHistory);\n    });\n\n    it(\"should handle null results from get_history\", async () => {\n        const action = new Action(mockKwil, mockSigner);\n        const callSpy = vi.spyOn(action as any, \"call\");\n        \n        callSpy.mockResolvedValue(Either.right(null));\n\n        const result = await action.getHistory(\"bridge\", \"0x123\");\n\n        expect(result).toEqual([]);\n    });\n\n    it(\"should use default parameters for getHistory\", async () => {\n        const action = new Action(mockKwil, mockSigner);\n        const callSpy = vi.spyOn(action as any, \"call\");\n        \n        callSpy.mockResolvedValue(Either.right([]));\n\n        await action.getHistory(\"bridge\", \"0x123\");\n\n        expect(callSpy).toHaveBeenCalledWith(\n            \"bridge_get_history\",\n            {\n                $wallet_address: \"0x123\",\n                $limit: 20,\n                $offset: 0\n            }\n        );\n    });\n});\n"],
+  "mappings": ";;;AAAA,oBAAuB;AAGvB,uBAAuB;AACvB,oBAAyC;AAAA,IAEzC,wBAAS,UAAU,MAAM;AAErB,QAAM,WAAW;AAAA,IACb,MAAM,iBAAG,GAAG;AAAA,EAChB;AAEA,QAAM,aAAa;AAAA,IACf,eAAe;AAAA,EACnB;AAEA,wBAAG,mDAAmD,YAAY;AAC9D,UAAM,SAAS,IAAI,qBAAO,UAAU,UAAU;AAG9C,UAAM,UAAU,iBAAG,MAAM,QAAe,MAAM;AAE9C,UAAM,cAA+B,CAAC;AAAA,MAClC,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,YAAY;AAAA,MACZ,kBAAkB;AAAA,MAClB,kBAAkB;AAAA,MAClB,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,uBAAuB;AAAA,IAC3B,CAAC;AAED,YAAQ,kBAAkB,wBAAO,MAAM,WAAW,CAAC;AAEnD,UAAM,SAAS,MAAM,OAAO,WAAW,kBAAkB,SAAS,IAAI,CAAC;AAEvE,8BAAO,OAAO,EAAE;AAAA,MACZ;AAAA,MACA;AAAA,QACI,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,SAAS;AAAA,MACb;AAAA,IACJ;AAEA,8BAAO,MAAM,EAAE,QAAQ,WAAW;AAAA,EACtC,CAAC;AAED,wBAAG,+CAA+C,YAAY;AAC1D,UAAM,SAAS,IAAI,qBAAO,UAAU,UAAU;AAC9C,UAAM,UAAU,iBAAG,MAAM,QAAe,MAAM;AAE9C,YAAQ,kBAAkB,wBAAO,MAAM,IAAI,CAAC;AAE5C,UAAM,SAAS,MAAM,OAAO,WAAW,UAAU,OAAO;AAExD,8BAAO,MAAM,EAAE,QAAQ,CAAC,CAAC;AAAA,EAC7B,CAAC;AAED,wBAAG,gDAAgD,YAAY;AAC3D,UAAM,SAAS,IAAI,qBAAO,UAAU,UAAU;AAC9C,UAAM,UAAU,iBAAG,MAAM,QAAe,MAAM;AAE9C,YAAQ,kBAAkB,wBAAO,MAAM,CAAC,CAAC,CAAC;AAE1C,UAAM,OAAO,WAAW,UAAU,OAAO;AAEzC,8BAAO,OAAO,EAAE;AAAA,MACZ;AAAA,MACA;AAAA,QACI,iBAAiB;AAAA,QACjB,QAAQ;AAAA,QACR,SAAS;AAAA,MACb;AAAA,IACJ;AAAA,EACJ,CAAC;AACL,CAAC;",
+  "names": []
+}

package/dist/cjs/types/bridge.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/bridge.ts"],
-  "sourcesContent": ["/**\n * Types for bridge-related operations\n */\n\n/**\n * Withdrawal proof returned from getWithdrawalProof()\n *\n * This proof contains all the data needed for a user to claim their withdrawal\n * on the destination chain by submitting a transaction to the bridge contract.\n *\n * @example\n * ```typescript\n * const proofs = await client.getWithdrawalProof(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n * const proof = proofs[0];\n *\n * // Decode base64 data to use in smart contract call\n * const blockHash = Buffer.from(proof.block_hash, 'base64').toString('hex');\n * const root = Buffer.from(proof.root, 'base64').toString('hex');\n * const signatures = proof.signatures.map(sig => Buffer.from(sig, 'base64'));\n * ```\n */\nexport interface WithdrawalProof {\n  /**\n   * The source chain name (e.g., \"hoodi\", \"sepolia\")\n   * Note: This is the chain name, not the bridge identifier\n   */\n  chain: string;\n\n  /**\n   * The numeric chain ID (e.g., \"3639\" for Hoodi)\n   */\n  chain_id: string;\n\n  /**\n   * The bridge contract address on the destination chain\n   */\n  contract: string;\n\n  /**\n   * The block number when the epoch was created\n   */\n  created_at: number;\n\n  /**\n   * The recipient wallet address\n   */\n  recipient: string;\n\n  /**\n   * The withdrawal amount in wei (as string to handle large numbers)\n   */\n  amount: string;\n\n  /**\n   * The Kwil block hash (base64-encoded bytes)\n   * Decode to bytes32 for smart contract call\n   */\n  block_hash: string;\n\n  /**\n   * The merkle root (base64-encoded bytes)\n   * Decode to bytes32 for smart contract call\n   */\n  root: string;\n\n  /**\n   * Array of merkle proofs (base64-encoded bytes)\n   * Usually empty for single withdrawals\n   */\n  proofs: string[];\n\n  /**\n   * Array of validator signatures (base64-encoded bytes)\n   * Each signature is 65 bytes: r[32] || s[32] || v[1]\n   * Decode and split into (v, r, s) for smart contract call\n   */\n  signatures: string[];\n}\n"],
+  "sourcesContent": ["/**\n * Types for bridge-related operations\n */\n\n/**\n * Withdrawal proof returned from getWithdrawalProof()\n *\n * This proof contains all the data needed for a user to claim their withdrawal\n * on the destination chain by submitting a transaction to the bridge contract.\n *\n * @example\n * ```typescript\n * const proofs = await client.getWithdrawalProof(\"hoodi_tt\", \"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb\");\n * const proof = proofs[0];\n *\n * // Decode base64 data to use in smart contract call\n * const blockHash = Buffer.from(proof.block_hash, 'base64').toString('hex');\n * const root = Buffer.from(proof.root, 'base64').toString('hex');\n * const signatures = proof.signatures.map(sig => Buffer.from(sig, 'base64'));\n * ```\n */\nexport interface WithdrawalProof {\n  /**\n   * The source chain name (e.g., \"hoodi\", \"sepolia\")\n   * Note: This is the chain name, not the bridge identifier\n   */\n  chain: string;\n\n  /**\n   * The numeric chain ID (e.g., \"3639\" for Hoodi)\n   */\n  chain_id: string;\n\n  /**\n   * The bridge contract address on the destination chain\n   */\n  contract: string;\n\n  /**\n   * The block number when the epoch was created\n   */\n  created_at: number;\n\n  /**\n   * The recipient wallet address\n   */\n  recipient: string;\n\n  /**\n   * The withdrawal amount in wei (as string to handle large numbers)\n   */\n  amount: string;\n\n  /**\n   * The Kwil block hash (base64-encoded bytes)\n   * Decode to bytes32 for smart contract call\n   */\n  block_hash: string;\n\n  /**\n   * The merkle root (base64-encoded bytes)\n   * Decode to bytes32 for smart contract call\n   */\n  root: string;\n\n  /**\n   * Array of merkle proofs (base64-encoded bytes)\n   * Usually empty for single withdrawals\n   */\n  proofs: string[];\n\n  /**\n   * Array of validator signatures (base64-encoded bytes)\n   * Each signature is 65 bytes: r[32] || s[32] || v[1]\n   * Decode and split into (v, r, s) for smart contract call\n   */\n  signatures: string[];\n}\n\n/**\n * Transaction history record from the bridge extension.\n */\nexport interface BridgeHistory {\n  /**\n   * The type of transaction ('deposit', 'withdrawal', 'transfer')\n   */\n  type: string;\n\n  /**\n   * The amount transferred/deposited/withdrawn\n   */\n  amount: string;\n\n  /**\n   * The sender address (null for deposits)\n   */\n  from_address: string | null;\n\n  /**\n   * The recipient address\n   */\n  to_address: string;\n\n  /**\n   * The Kwil transaction hash (null for deposits, if not linked)\n   */\n  internal_tx_hash: string | null;\n\n  /**\n   * The external transaction hash (null for internal transfers)\n   */\n  external_tx_hash: string | null;\n\n  /**\n   * The status of the transaction ('completed', 'pending_epoch', 'claimed')\n   */\n  status: string;\n\n  /**\n   * The Kwil block height\n   */\n  block_height: number;\n\n  /**\n   * The timestamp of the block (Unix timestamp)\n   */\n  block_timestamp: number;\n\n  /**\n   * The external block height (if applicable)\n   */\n  external_block_height: number | null;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

package/dist/esm/client/client.mjs

@@ -321,6 +321,25 @@ var BaseTNClient = class {
     const action = this.loadAction();
     return action.getWithdrawalProof(bridgeIdentifier, walletAddress);
   }
+  /**
+   * Retrieves the transaction history for a wallet on a specific bridge.
+   *
+   * @param bridgeIdentifier - The name of the bridge instance (e.g., "hoodi_tt", "sepolia_bridge")
+   * @param walletAddress - The wallet address to query
+   * @param limit - Max number of records to return (default 20)
+   * @param offset - Number of records to skip (default 0)
+   * @returns Promise resolving to an array of BridgeHistory records
+   *
+   * @example
+   * ```typescript
+   * const history = await client.getHistory("sepolia_bridge", "0x123...");
+   * console.log(history);
+   * ```
+   */
+  async getHistory(bridgeIdentifier, walletAddress, limit = 20, offset = 0) {
+    const action = this.loadAction();
+    return action.getHistory(bridgeIdentifier, walletAddress, limit, offset);
+  }
   /**
    * Gets taxonomies for specific streams in batch.
    * High-level wrapper for ComposedAction.getTaxonomiesForStreams()