@trufnetwork/sdk-js 0.5.8 → 0.5.10

package/dist/types/contracts-api/action.d.ts

@@ -1,5 +1,6 @@
 import { KwilSigner, NodeKwil, WebKwil, Types } from "@trufnetwork/kwil-js";
 import { Either } from "monads-io";
+import { WithdrawalProof } from "../types/bridge";
 import { DateString } from "../types/other";
 import { StreamLocator } from "../types/stream";
 import { CacheAwareResponse, GetRecordOptions, GetIndexOptions, GetIndexChangeOptions, GetFirstRecordOptions } from "../types/cache";
@@ -180,12 +181,21 @@ export declare class Action {
      */
     getDatabaseSizePretty(): Promise<string>;
     /**
-     * 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");
+     * ```
      */
-    getWalletBalance(chain: string, walletAddress: string): Promise<string>;
+    getWalletBalance(bridgeIdentifier: string, walletAddress: string): Promise<string>;
     /**
      * Calls the whoami action to get the caller's wallet address
      * This is useful for verifying wallet authentication with TN
@@ -193,19 +203,57 @@ export declare class Action {
      */
     whoami(): Promise<string>;
     /**
-     * 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...");
+     * ```
      */
-    bridgeTokens(chain: string, amount: string, recipient: string): Promise<Types.GenericResponse<Types.TxReceipt>>;
+    bridgeTokens(bridgeIdentifier: string, amount: string, recipient: string): Promise<Types.GenericResponse<Types.TxReceipt>>;
     /**
-     * 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.
      */
-    listWalletRewards(chain: string, wallet: string, withPending: boolean): Promise<any[]>;
+    listWalletRewards(bridgeIdentifier: string, wallet: string, withPending: boolean): Promise<any[]>;
+    /**
+     * 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 contract.
+     *
+     * @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 (empty array if no unclaimed withdrawals)
+     *
+     * @example
+     * ```typescript
+     * // 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
+     */
+    getWithdrawalProof(bridgeIdentifier: string, walletAddress: string): Promise<WithdrawalProof[]>;
 }
 //# sourceMappingURL=action.d.ts.map

package/dist/types/contracts-api/action.d.ts.map

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

package/dist/types/internal.d.ts

@@ -23,5 +23,6 @@ export type { InsertRecordInput } from "./contracts-api/primitiveAction";
 export type { TaxonomySet, TaxonomyItem, ListTaxonomiesByHeightParams, GetTaxonomiesForStreamsParams, TaxonomyQueryResult } from "./contracts-api/composedAction";
 export type { GrantRoleInput, RevokeRoleInput, AreMembersOfInput, WalletMembership } from "./types/role";
 export type { RequestAttestationInput, RequestAttestationResult, GetSignedAttestationInput, SignedAttestationResult, ListAttestationsInput, AttestationMetadata } from "./types/attestation";
+export type { WithdrawalProof } from "./types/bridge";
 export type { VisibilityEnum } from "./util/visibility";
 //# sourceMappingURL=internal.d.ts.map

package/dist/types/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EACL,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EACV,YAAY,EACZ,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,4BAA4B,EAC5B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EACL,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,UAAU,EACV,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EACV,YAAY,EACZ,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,4BAA4B,EAC5B,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/types/bridge.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Types for bridge-related operations
+ */
+/**
+ * Withdrawal proof returned from getWithdrawalProof()
+ *
+ * This proof contains all the data needed for a user to claim their withdrawal
+ * on the destination chain by submitting a transaction to the bridge contract.
+ *
+ * @example
+ * ```typescript
+ * const proofs = await client.getWithdrawalProof("hoodi_tt", "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb");
+ * const proof = proofs[0];
+ *
+ * // Decode base64 data to use in smart contract call
+ * const blockHash = Buffer.from(proof.block_hash, 'base64').toString('hex');
+ * const root = Buffer.from(proof.root, 'base64').toString('hex');
+ * const signatures = proof.signatures.map(sig => Buffer.from(sig, 'base64'));
+ * ```
+ */
+export interface WithdrawalProof {
+    /**
+     * The source chain name (e.g., "hoodi", "sepolia")
+     * Note: This is the chain name, not the bridge identifier
+     */
+    chain: string;
+    /**
+     * The numeric chain ID (e.g., "3639" for Hoodi)
+     */
+    chain_id: string;
+    /**
+     * The bridge contract address on the destination chain
+     */
+    contract: string;
+    /**
+     * The block number when the epoch was created
+     */
+    created_at: number;
+    /**
+     * The recipient wallet address
+     */
+    recipient: string;
+    /**
+     * The withdrawal amount in wei (as string to handle large numbers)
+     */
+    amount: string;
+    /**
+     * The Kwil block hash (base64-encoded bytes)
+     * Decode to bytes32 for smart contract call
+     */
+    block_hash: string;
+    /**
+     * The merkle root (base64-encoded bytes)
+     * Decode to bytes32 for smart contract call
+     */
+    root: string;
+    /**
+     * Array of merkle proofs (base64-encoded bytes)
+     * Usually empty for single withdrawals
+     */
+    proofs: string[];
+    /**
+     * Array of validator signatures (base64-encoded bytes)
+     * Each signature is 65 bytes: r[32] || s[32] || v[1]
+     * Decode and split into (v, r, s) for smart contract call
+     */
+    signatures: string[];
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/types/types/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/types/bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trufnetwork/sdk-js",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "TRUF.NETWORK SDK for JavaScript/TypeScript",
   "type": "module",
   "keywords": [