@trufnetwork/sdk-js 0.5.9 → 0.6.0

package/README.md

@@ -396,6 +396,46 @@ await primitiveAction.insertRecord({
 - ⚡ **High-throughput data insertion** (independent records)
 - ⚡ **Fire-and-forget operations** (with proper error handling)
 
+### Prediction Markets (Order Book)
+
+The SDK supports binary prediction markets through the Order Book API. Markets are settled automatically based on real-world data from trusted data providers.
+
+```typescript
+// Load the order book action
+const orderbook = client.loadOrderbookAction();
+
+// Get market info
+const market = await orderbook.getMarketInfo(queryId);
+console.log(`Settles at: ${new Date(market.settleTime * 1000)}`);
+
+// Place a buy order for YES shares at 55 cents
+const result = await orderbook.placeBuyOrder({
+  queryId: market.id,
+  outcome: true,  // YES
+  price: 55,      // 55 cents = 55% implied probability
+  amount: 100,    // 100 shares
+});
+await client.waitForTx(result.data!.tx_hash);
+
+// Get best prices
+const prices = await orderbook.getBestPrices(market.id, true);
+console.log(`YES: Bid=${prices.bestBid}c, Ask=${prices.bestAsk}c`);
+```
+
+#### Market Making with Split Limit Orders
+
+```typescript
+// Create YES/NO pairs and provide liquidity
+await orderbook.placeSplitLimitOrder({
+  queryId: market.id,
+  truePrice: 55,  // YES at 55c, NO at 45c
+  amount: 100,    // 100 pairs
+});
+// Result: 100 YES holdings + 100 NO sell orders at 45c
+```
+
+**📖 For complete documentation including market creation, order types, settlement, and examples, see the [Order Book Operations](./docs/api-reference.md#order-book-operations) section in the API Reference and [examples/orderbook](./examples/orderbook).**
+
 ### Using the SDK with Your Local Node
 
 If you are running your own TRUF.NETWORK node, you can configure the SDK to interact with your local instance by changing the `endpoint` in the client configuration, as shown in the [Basic Client Initialization](#basic-client-initialization) section. This is useful for development, testing, or when operating within a private network.
@@ -488,6 +528,11 @@ For other bundlers or serverless platforms, consult their documentation on modul
 | List attestations | `attestationAction.listAttestations({requester, limit, offset, orderBy})` |
 | Get transaction event | `transactionAction.getTransactionEvent({txId})` |
 | List transaction fees | `transactionAction.listTransactionFees({wallet, mode, limit, offset})` |
+| Create prediction market | `orderbook.createMarket({bridge, queryComponents, settleTime, ...})` |
+| Place buy order | `orderbook.placeBuyOrder({queryId, outcome, price, amount})` |
+| Place split limit order | `orderbook.placeSplitLimitOrder({queryId, truePrice, amount})` |
+| Get order book | `orderbook.getOrderBook(queryId, outcome)` |
+| Get best prices | `orderbook.getBestPrices(queryId, outcome)` |
 | Destroy stream | `client.destroyStream(streamLocator)` |
 
 **Safe Operation Pattern:**

package/dist/cjs/client/client.cjs

@@ -35,6 +35,7 @@ var import_getLastTransactions = require("./getLastTransactions.cjs");
 var import_roleManagement = require("../contracts-api/roleManagement.cjs");
 var import_attestationAction = require("../contracts-api/attestationAction.cjs");
 var import_transactionAction = require("../contracts-api/transactionAction.cjs");
+var import_orderbookAction = require("../contracts-api/orderbookAction.cjs");
 var BaseTNClient = class {
   kwilClient;
   signerInfo;
@@ -184,6 +185,16 @@ var BaseTNClient = class {
       this.getKwilSigner()
     );
   }
+  /**
+   * Loads the order book action API, permitting prediction market operations.
+   * @returns An instance of OrderbookAction.
+   */
+  loadOrderbookAction() {
+    return new import_orderbookAction.OrderbookAction(
+      this.getKwilClient(),
+      this.getKwilSigner()
+    );
+  }
   /**
    * Creates a new stream locator.
    * @param streamId - The ID of the stream.
@@ -243,19 +254,26 @@ var BaseTNClient = class {
     const action = this.loadAction();
     return action.listMetadataByHeight(params);
   }
-  async getWalletBalance(chain, walletAddress) {
+  /**
+   * Gets the wallet balance for a specific bridge instance
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "sepolia", "hoodi_tt", "ethereum")
+   * @param walletAddress The wallet address to check balance for
+   * @returns Promise that resolves to the balance as a string (in wei)
+   */
+  async getWalletBalance(bridgeIdentifier, walletAddress) {
     const action = this.loadAction();
-    return action.getWalletBalance(chain, walletAddress);
+    return action.getWalletBalance(bridgeIdentifier, walletAddress);
   }
   /**
-   * Performs a withdrawal operation by bridging tokens
-   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
-   * @param amount The amount to withdraw
+   * Performs a withdrawal operation by bridging tokens from TN to a destination chain
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "sepolia", "hoodi_tt")
+   * @param amount The amount to withdraw (in wei)
+   * @param recipient The recipient address on the destination chain
    * @returns Promise that resolves to the transaction hash, or throws on error
    */
-  async withdraw(chain, amount, recipient) {
+  async withdraw(bridgeIdentifier, amount, recipient) {
     const action = this.loadAction();
-    const bridgeResult = await action.bridgeTokens(chain, amount, recipient);
+    const bridgeResult = await action.bridgeTokens(bridgeIdentifier, amount, recipient);
     if (!bridgeResult.data?.tx_hash) {
       throw new Error("Bridge tokens operation failed: no transaction hash returned");
     }
@@ -267,32 +285,33 @@ var BaseTNClient = class {
     return bridgeResult.data.tx_hash;
   }
   /**
-   * Lists wallet rewards for a specific wallet address on a blockchain network
-   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
+   * Lists wallet rewards for a specific bridge instance
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "sepolia", "hoodi_tt")
    * @param wallet The wallet address to list rewards for
    * @param withPending Whether to include pending rewards
    * @returns Promise that resolves to an array of rewards data
+   * @deprecated This method uses the extension namespace directly. Most users should use getWithdrawalProof instead.
    */
-  async listWalletRewards(chain, wallet, withPending) {
+  async listWalletRewards(bridgeIdentifier, wallet, withPending) {
     const action = this.loadAction();
-    return action.listWalletRewards(chain, wallet, withPending);
+    return action.listWalletRewards(bridgeIdentifier, wallet, withPending);
   }
   /**
-   * Gets withdrawal proof for a specific wallet address on a blockchain network
-   * Returns merkle proofs and validator signatures needed for withdrawal
+   * Gets withdrawal proof for a specific bridge instance
+   * Returns merkle proofs and validator signatures needed for claiming withdrawals on the destination chain
    *
    * This method is used for non-custodial bridge withdrawals where users need to
-   * manually claim their withdrawals by submitting proofs to the destination chain.
+   * manually claim their withdrawals by submitting proofs to the destination chain contract.
    * The proof includes validator signatures, merkle root, block hash, and amount.
    *
-   * @param chain The chain identifier (e.g., "hoodi", "sepolia", etc.)
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "hoodi_tt", "sepolia", "ethereum")
    * @param walletAddress The wallet address to get withdrawal proof for
-   * @returns Promise that resolves to an array of withdrawal proof data
+   * @returns Promise that resolves to an array of withdrawal proof data (empty array if no unclaimed withdrawals)
    *
    * @example
    * ```typescript
-   * // Get withdrawal proofs for Hoodi
-   * const proofs = await client.getWithdrawalProof("hoodi", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
+   * // Get withdrawal proofs for Hoodi Test Token bridge
+   * const proofs = await client.getWithdrawalProof("hoodi_tt", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
    *
    * // Proofs will be an array like:
    * // [{
@@ -307,14 +326,20 @@ var BaseTNClient = class {
    * //   proofs: [],
    * //   signatures: [<base64-encoded-signatures>]
    * // }]
+   *
+   * // Use the proofs to claim withdrawal on destination chain
+   * if (proofs.length > 0) {
+   *   const proof = proofs[0];
+   *   await bridgeContract.claimWithdrawal(proof.recipient, proof.amount, proof.root, proof.proofs, proof.signatures);
+   * }
    * ```
    *
    * @note This method has been tested via integration tests in the node repository.
    * See: https://github.com/trufnetwork/kwil-db/blob/main/node/exts/erc20-bridge/erc20/meta_extension_withdrawal_test.go
    */
-  async getWithdrawalProof(chain, walletAddress) {
+  async getWithdrawalProof(bridgeIdentifier, walletAddress) {
     const action = this.loadAction();
-    return action.getWithdrawalProof(chain, walletAddress);
+    return action.getWithdrawalProof(bridgeIdentifier, walletAddress);
   }
   /**
    * Gets taxonomies for specific streams in batch.

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 { 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   * 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  async getWalletBalance(chain: string, walletAddress: string) {\n    const action = this.loadAction();\n    return action.getWalletBalance(chain, walletAddress);\n  }\n\n  /**\n   * Performs a withdrawal operation by bridging tokens\n   * @param chain The chain identifier (e.g., \"sepolia\", \"mainnet\", \"polygon\", etc.)\n   * @param amount The amount to withdraw\n   * @returns Promise that resolves to the transaction hash, or throws on error\n   */\n  async withdraw(chain: 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(chain, 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 wallet address on a blockchain network\n   * @param chain The chain identifier (e.g., \"sepolia\", \"mainnet\", \"polygon\", etc.)\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   */\n  async listWalletRewards(chain: string, wallet: string, withPending: boolean): Promise<any[]> {\n    const action = this.loadAction();\n    return action.listWalletRewards(chain, wallet, withPending);\n  }\n\n  /**\n   * Gets withdrawal proof for a specific wallet address on a blockchain network\n   * Returns merkle proofs and validator signatures needed for withdrawal\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.\n   * The proof includes validator signatures, merkle root, block hash, and amount.\n   *\n   * @param chain The chain identifier (e.g., \"hoodi\", \"sepolia\", etc.)\n   * @param walletAddress The wallet address to get withdrawal proof for\n   * @returns Promise that resolves to an array of withdrawal proof data\n   *\n   * @example\n   * ```typescript\n   * // Get withdrawal proofs for Hoodi\n   * const proofs = await client.getWithdrawalProof(\"hoodi\", \"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   *\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(chain: string, walletAddress: string): Promise<WithdrawalProof[]> {\n    const action = this.loadAction();\n    return action.getWithdrawalProof(chain, 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 } 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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",
   "names": []
 }

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

@@ -660,14 +660,23 @@ var Action = class _Action {
     return result.map((rows) => rows[0].database_size_pretty).throw();
   }
   /**
-   * Gets the wallet balance on any supported blockchain network
-   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
+   * Gets the wallet balance for a specific bridge instance
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "sepolia", "hoodi_tt", "ethereum")
+   *                         This corresponds to the bridge instance name in TN (e.g., hoodi_tt for Hoodi Test Token bridge)
    * @param walletAddress The wallet address to check balance for
-   * @returns Promise that resolves to the balance as a string, or throws on error
+   * @returns Promise that resolves to the balance as a string (in wei), or throws on error
+   * @example
+   * ```typescript
+   * // Simple case - identifier matches network name
+   * const balance = await action.getWalletBalance("sepolia", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
+   *
+   * // Multi-token bridge - specify bridge instance explicitly
+   * const balance = await action.getWalletBalance("hoodi_tt", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
+   * ```
    */
-  async getWalletBalance(chain, walletAddress) {
+  async getWalletBalance(bridgeIdentifier, walletAddress) {
     const result = await this.call(
-      `${chain}_wallet_balance`,
+      `${bridgeIdentifier}_wallet_balance`,
       {
         $wallet_address: walletAddress
       }
@@ -705,32 +714,42 @@ var Action = class _Action {
     }).throw();
   }
   /**
-   * Bridges tokens on a blockchain network
-   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
-   * @param amount The amount to bridge
-   * @returns Promise that resolves to GenericResponse<TxReceipt>
+   * Bridges tokens by initiating a withdrawal from TN to a blockchain network
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "sepolia", "hoodi_tt", "ethereum")
+   * @param amount The amount to bridge in wei (as string to preserve precision)
+   * @param recipient The recipient address on the destination chain
+   * @returns Promise that resolves to transaction receipt
+   * @example
+   * ```typescript
+   * // Bridge 100 tokens from TN to Sepolia
+   * const receipt = await action.bridgeTokens("sepolia", "100000000000000000000", "0x742d35Cc...");
+   *
+   * // Bridge from TN to Hoodi Test Token bridge
+   * const receipt = await action.bridgeTokens("hoodi_tt", "50000000000000000000", "0x742d35Cc...");
+   * ```
    */
-  async bridgeTokens(chain, amount, recipient) {
+  async bridgeTokens(bridgeIdentifier, amount, recipient) {
     const numAmount = parseFloat(amount);
     if (isNaN(numAmount) || numAmount <= 0) {
       throw new Error(`Invalid amount: ${amount}. Amount must be greater than 0.`);
     }
-    return await this.executeWithNamedParams(`${chain}_bridge_tokens`, [{
+    return await this.executeWithNamedParams(`${bridgeIdentifier}_bridge_tokens`, [{
       $recipient: recipient,
       $amount: amount
     }]);
   }
   /**
-   * Lists wallet rewards on a blockchain network
-   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
+   * Lists wallet rewards for a specific bridge instance
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "sepolia", "hoodi_tt")
    * @param wallet The wallet address to list rewards for
    * @param withPending Whether to include pending rewards
-   * @returns Promise that resolves to the rewards data
+   * @returns Promise that resolves to array of reward records
+   * @deprecated This method uses the extension namespace directly. Most users should use getWithdrawalProof instead.
    */
-  async listWalletRewards(chain, wallet, withPending) {
+  async listWalletRewards(bridgeIdentifier, wallet, withPending) {
     const result = await this.kwilClient.call(
       {
-        namespace: `${chain}_bridge`,
+        namespace: `${bridgeIdentifier}_bridge`,
         name: "list_wallet_rewards",
         inputs: {
           $param_1: wallet,
@@ -745,29 +764,35 @@ var Action = class _Action {
     return result.data?.result || [];
   }
   /**
-   * Gets withdrawal proof for a wallet address on a blockchain network
-   * Returns merkle proofs and validator signatures needed for withdrawal on target chain
+   * Gets withdrawal proof for a wallet address on a specific bridge instance
+   * Returns merkle proofs and validator signatures needed for claiming withdrawals on the destination chain
    *
    * This method is used for non-custodial bridge withdrawals where users need to
-   * manually claim their withdrawals by submitting proofs to the destination chain.
+   * manually claim their withdrawals by submitting proofs to the destination chain contract.
    *
-   * @param chain The chain identifier (e.g., "hoodi", "sepolia", etc.)
+   * @param bridgeIdentifier The bridge instance identifier (e.g., "hoodi_tt", "sepolia", "ethereum")
    * @param walletAddress The wallet address to get withdrawal proof for
-   * @returns Promise that resolves to array of withdrawal proofs
+   * @returns Promise that resolves to array of withdrawal proofs (empty array if no unclaimed withdrawals)
    *
    * @example
    * ```typescript
-   * // Get withdrawal proofs for Hoodi
-   * const proofs = await action.getWithdrawalProof("hoodi", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
-   * // Returns: [{ chain: "hoodi", recipient: "0x...", amount: "100000000000000000000", ... }]
+   * // Get withdrawal proofs for Hoodi Test Token bridge
+   * const proofs = await action.getWithdrawalProof("hoodi_tt", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
+   * // Returns: [{ chain: "hoodi", recipient: "0x...", amount: "100000000000000000000", proofs: [...], signatures: [...] }]
+   *
+   * // Use the proofs to claim withdrawal on destination chain
+   * if (proofs.length > 0) {
+   *   const proof = proofs[0];
+   *   await bridgeContract.claimWithdrawal(proof.recipient, proof.amount, proof.root, proof.proofs, proof.signatures);
+   * }
    * ```
    *
    * @note This method has been tested via integration tests in the node repository.
    * See: https://github.com/trufnetwork/kwil-db/blob/main/node/exts/erc20-bridge/erc20/meta_extension_withdrawal_test.go
    */
-  async getWithdrawalProof(chain, walletAddress) {
+  async getWithdrawalProof(bridgeIdentifier, walletAddress) {
     const result = await this.call(
-      `${chain}_get_withdrawal_proof`,
+      `${bridgeIdentifier}_get_withdrawal_proof`,
       {
         $wallet_address: walletAddress
       }