@trufnetwork/sdk-js 0.3.7 → 0.4.1

package/dist/cjs/client/browserClient.cjs

@@ -24,7 +24,7 @@ __export(browserClient_exports, {
   default: () => browserClient_default
 });
 module.exports = __toCommonJS(browserClient_exports);
-var import_kwil_js = require("@kwilteam/kwil-js");
+var import_kwil_js = require("@trufnetwork/kwil-js");
 var import_client = require("./client.cjs");
 var BrowserTNClient = class extends import_client.BaseTNClient {
   constructor(options) {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/browserClient.ts"],
-  "sourcesContent": ["import { EnvironmentType } from \"@kwilteam/kwil-js/dist/core/enums\";\nimport { WebKwil } from \"@kwilteam/kwil-js\";\nimport { BaseTNClient, TNClientOptions } from \"./client\";\n\nexport class BrowserTNClient extends BaseTNClient<EnvironmentType.BROWSER> {\n  constructor(options: TNClientOptions) {\n    super(options);\n    this.kwilClient = new WebKwil({\n      ...options,\n      timeout: options.timeout ?? 30000,\n      kwilProvider: options.endpoint,\n    });\n  }\n}\n\nexport default BrowserTNClient;\n"],
+  "sourcesContent": ["import { EnvironmentType } from \"@trufnetwork/kwil-js/dist/core/enums\";\nimport { WebKwil } from \"@trufnetwork/kwil-js\";\nimport { BaseTNClient, TNClientOptions } from \"./client\";\n\nexport class BrowserTNClient extends BaseTNClient<EnvironmentType.BROWSER> {\n  constructor(options: TNClientOptions) {\n    super(options);\n    this.kwilClient = new WebKwil({\n      ...options,\n      timeout: options.timeout ?? 30000,\n      kwilProvider: options.endpoint,\n    });\n  }\n}\n\nexport default BrowserTNClient;\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,qBAAwB;AACxB,oBAA8C;AAEvC,IAAM,kBAAN,cAA8B,2BAAsC;AAAA,EACzE,YAAY,SAA0B;AACpC,UAAM,OAAO;AACb,SAAK,aAAa,IAAI,uBAAQ;AAAA,MAC5B,GAAG;AAAA,MACH,SAAS,QAAQ,WAAW;AAAA,MAC5B,cAAc,QAAQ;AAAA,IACxB,CAAC;AAAA,EACH;AACF;AAEA,IAAO,wBAAQ;",
   "names": []
 }

package/dist/cjs/client/client.cjs

@@ -23,7 +23,7 @@ __export(client_exports, {
   BaseTNClient: () => BaseTNClient
 });
 module.exports = __toCommonJS(client_exports);
-var import_kwil_js = require("@kwilteam/kwil-js");
+var import_kwil_js = require("@trufnetwork/kwil-js");
 var import_composedAction = require("../contracts-api/composedAction.cjs");
 var import_deployStream = require("../contracts-api/deployStream.cjs");
 var import_deleteStream = require("../contracts-api/deleteStream.cjs");

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/client.ts"],
-  "sourcesContent": ["import { Client, KwilSigner, NodeKwil, WebKwil } from \"@kwilteam/kwil-js\";\nimport { KwilConfig } from \"@kwilteam/kwil-js/dist/api_client/config\";\nimport { Kwil } from \"@kwilteam/kwil-js/dist/client/kwil\";\nimport { EthSigner } from \"@kwilteam/kwil-js/dist/core/signature\";\nimport { EnvironmentType } from \"@kwilteam/kwil-js/dist/core/enums\";\nimport { GenericResponse } from \"@kwilteam/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@kwilteam/kwil-js/dist/core/tx\";\nimport { TxInfoReceipt } from \"@kwilteam/kwil-js/dist/core/txQuery\";\nimport { ComposedAction } from \"../contracts-api/composedAction\";\nimport { deployStream } from \"../contracts-api/deployStream\";\nimport { deleteStream } from \"../contracts-api/deleteStream\";\nimport { PrimitiveAction } from \"../contracts-api/primitiveAction\";\nimport { Action } from \"../contracts-api/action\";\nimport { StreamType } from \"../contracts-api/contractValues\";\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 { 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: EthSigner;\n}\n\nexport type TNClientOptions = {\n  endpoint: string;\n  signerInfo: SignerInfo;\n} & Omit<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: 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<TxInfoReceipt> {\n    return new Promise<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(): 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<GenericResponse<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<GenericResponse<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   * 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   * 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"],
+  "sourcesContent": ["import { Client, KwilSigner, NodeKwil, WebKwil } from \"@trufnetwork/kwil-js\";\nimport { KwilConfig } from \"@trufnetwork/kwil-js/dist/api_client/config\";\nimport { Kwil } from \"@trufnetwork/kwil-js/dist/client/kwil\";\nimport { EthSigner } from \"@trufnetwork/kwil-js/dist/core/signature\";\nimport { EnvironmentType } from \"@trufnetwork/kwil-js/dist/core/enums\";\nimport { GenericResponse } from \"@trufnetwork/kwil-js/dist/core/resreq\";\nimport { TxReceipt } from \"@trufnetwork/kwil-js/dist/core/tx\";\nimport { TxInfoReceipt } from \"@trufnetwork/kwil-js/dist/core/txQuery\";\nimport { ComposedAction } from \"../contracts-api/composedAction\";\nimport { deployStream } from \"../contracts-api/deployStream\";\nimport { deleteStream } from \"../contracts-api/deleteStream\";\nimport { PrimitiveAction } from \"../contracts-api/primitiveAction\";\nimport { Action } from \"../contracts-api/action\";\nimport { StreamType } from \"../contracts-api/contractValues\";\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 { 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: EthSigner;\n}\n\nexport type TNClientOptions = {\n  endpoint: string;\n  signerInfo: SignerInfo;\n} & Omit<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: 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<TxInfoReceipt> {\n    return new Promise<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(): 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<GenericResponse<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<GenericResponse<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   * 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   * 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/client/getLastTransactions.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/getLastTransactions.ts"],
-  "sourcesContent": ["import { WebKwil, NodeKwil, KwilSigner } from \"@kwilteam/kwil-js\";\r\nimport { GetLastTransactionsInput } from \"./client\";\r\nimport { LastTransaction } from \"../types/transaction\";\r\n\r\nconst INDEXER_BASE = \"https://indexer.infra.truf.network\";\r\nconst RPC_URL      = \"https://gateway.mainnet.truf.network/rpc/v1\";\r\n\r\nexport async function getLastTransactions(\r\n    kwilClient: WebKwil | NodeKwil,\r\n    kwilSigner: KwilSigner,\r\n    input: GetLastTransactionsInput\r\n): Promise<LastTransaction[]> {\r\n    // 1) call your SQL action\r\n    const res = await kwilClient.call(\r\n        {\r\n            name: \"get_last_transactions\",\r\n            namespace: \"main\",\r\n            inputs: {\r\n                $data_provider: input.dataProvider ?? null,\r\n                $limit_size: input.limitSize ?? 6,\r\n            },\r\n        },\r\n        kwilSigner\r\n    );\r\n    const rows = (res.data?.result as { created_at: number; method: string }[]) || [];\r\n\r\n    // 2) build per-block Promises\r\n    const tasks = rows.map(({ created_at, method }) => {\r\n        const blockHeight = Number(created_at);\r\n        if (Number.isNaN(blockHeight)) {\r\n            return Promise.reject(new Error(`Invalid block height returned: ${created_at}`));\r\n        }\r\n\r\n        const txUrl = `${INDEXER_BASE}/v0/chain/transactions`\r\n            + `?from-block=${blockHeight}&to-block=${blockHeight}`\r\n            + `&order=asc&limit=1`;\r\n\r\n        // INDEXER: always return a { sender, hash } object\r\n        const txPromise = fetch(txUrl).then(async (resp) => {\r\n            if (!resp.ok) throw new Error(`Indexer fetch failed: ${resp.status}`);\r\n            const json = (await resp.json()) as {\r\n                ok: boolean;\r\n                data: Array<{ hash: string; sender: string }>;\r\n            };\r\n            if (!json.ok || json.data.length === 0) {\r\n                return { sender: \"(unknown)\", hash: \"(unknown)\" };\r\n            }\r\n            const { hash, sender } = json.data[0];\r\n            return { sender, hash };\r\n        });\r\n\r\n        // RPC: get stamp_ms\r\n        const rpcPromise = fetch(RPC_URL, {\r\n            method:  \"POST\",\r\n            headers: { \"Content-Type\": \"application/json\" },\r\n            body:    JSON.stringify({\r\n                jsonrpc: \"2.0\",\r\n                method:  \"chain.block\",\r\n                params:  { height: blockHeight },\r\n                id:      1,\r\n            }),\r\n        }).then(async (resp) => {\r\n            if (!resp.ok) {\r\n                const txt = await resp.text();\r\n                throw new Error(`RPC fetch failed: ${resp.status} \u2013 ${txt}`);\r\n            }\r\n            const rpc = (await resp.json()) as {\r\n                result: { block: { header: { stamp_ms: number } } };\r\n            };\r\n            return rpc.result.block.header.stamp_ms;\r\n        });\r\n\r\n        // wait for both\r\n        return Promise.all([txPromise, rpcPromise]).then(\r\n            ([{ sender, hash }, stampMs]) => ({\r\n                blockHeight,\r\n                method,\r\n                sender,\r\n                transactionHash: hash,\r\n                stampMs,\r\n            })\r\n        );\r\n    });\r\n\r\n    // 3) await all in parallel\r\n    return Promise.all(tasks);\r\n}\r\n"],
+  "sourcesContent": ["import { WebKwil, NodeKwil, KwilSigner } from \"@trufnetwork/kwil-js\";\r\nimport { GetLastTransactionsInput } from \"./client\";\r\nimport { LastTransaction } from \"../types/transaction\";\r\n\r\nconst INDEXER_BASE = \"https://indexer.infra.truf.network\";\r\nconst RPC_URL      = \"https://gateway.mainnet.truf.network/rpc/v1\";\r\n\r\nexport async function getLastTransactions(\r\n    kwilClient: WebKwil | NodeKwil,\r\n    kwilSigner: KwilSigner,\r\n    input: GetLastTransactionsInput\r\n): Promise<LastTransaction[]> {\r\n    // 1) call your SQL action\r\n    const res = await kwilClient.call(\r\n        {\r\n            name: \"get_last_transactions\",\r\n            namespace: \"main\",\r\n            inputs: {\r\n                $data_provider: input.dataProvider ?? null,\r\n                $limit_size: input.limitSize ?? 6,\r\n            },\r\n        },\r\n        kwilSigner\r\n    );\r\n    const rows = (res.data?.result as { created_at: number; method: string }[]) || [];\r\n\r\n    // 2) build per-block Promises\r\n    const tasks = rows.map(({ created_at, method }) => {\r\n        const blockHeight = Number(created_at);\r\n        if (Number.isNaN(blockHeight)) {\r\n            return Promise.reject(new Error(`Invalid block height returned: ${created_at}`));\r\n        }\r\n\r\n        const txUrl = `${INDEXER_BASE}/v0/chain/transactions`\r\n            + `?from-block=${blockHeight}&to-block=${blockHeight}`\r\n            + `&order=asc&limit=1`;\r\n\r\n        // INDEXER: always return a { sender, hash } object\r\n        const txPromise = fetch(txUrl).then(async (resp) => {\r\n            if (!resp.ok) throw new Error(`Indexer fetch failed: ${resp.status}`);\r\n            const json = (await resp.json()) as {\r\n                ok: boolean;\r\n                data: Array<{ hash: string; sender: string }>;\r\n            };\r\n            if (!json.ok || json.data.length === 0) {\r\n                return { sender: \"(unknown)\", hash: \"(unknown)\" };\r\n            }\r\n            const { hash, sender } = json.data[0];\r\n            return { sender, hash };\r\n        });\r\n\r\n        // RPC: get stamp_ms\r\n        const rpcPromise = fetch(RPC_URL, {\r\n            method:  \"POST\",\r\n            headers: { \"Content-Type\": \"application/json\" },\r\n            body:    JSON.stringify({\r\n                jsonrpc: \"2.0\",\r\n                method:  \"chain.block\",\r\n                params:  { height: blockHeight },\r\n                id:      1,\r\n            }),\r\n        }).then(async (resp) => {\r\n            if (!resp.ok) {\r\n                const txt = await resp.text();\r\n                throw new Error(`RPC fetch failed: ${resp.status} \u2013 ${txt}`);\r\n            }\r\n            const rpc = (await resp.json()) as {\r\n                result: { block: { header: { stamp_ms: number } } };\r\n            };\r\n            return rpc.result.block.header.stamp_ms;\r\n        });\r\n\r\n        // wait for both\r\n        return Promise.all([txPromise, rpcPromise]).then(\r\n            ([{ sender, hash }, stampMs]) => ({\r\n                blockHeight,\r\n                method,\r\n                sender,\r\n                transactionHash: hash,\r\n                stampMs,\r\n            })\r\n        );\r\n    });\r\n\r\n    // 3) await all in parallel\r\n    return Promise.all(tasks);\r\n}\r\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,IAAM,eAAe;AACrB,IAAM,UAAe;AAErB,eAAsB,oBAClB,YACA,YACA,OAC0B;AAE1B,QAAM,MAAM,MAAM,WAAW;AAAA,IACzB;AAAA,MACI,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ;AAAA,QACJ,gBAAgB,MAAM,gBAAgB;AAAA,QACtC,aAAa,MAAM,aAAa;AAAA,MACpC;AAAA,IACJ;AAAA,IACA;AAAA,EACJ;AACA,QAAM,OAAQ,IAAI,MAAM,UAAuD,CAAC;AAGhF,QAAM,QAAQ,KAAK,IAAI,CAAC,EAAE,YAAY,OAAO,MAAM;AAC/C,UAAM,cAAc,OAAO,UAAU;AACrC,QAAI,OAAO,MAAM,WAAW,GAAG;AAC3B,aAAO,QAAQ,OAAO,IAAI,MAAM,kCAAkC,UAAU,EAAE,CAAC;AAAA,IACnF;AAEA,UAAM,QAAQ,GAAG,YAAY,qCACR,WAAW,aAAa,WAAW;AAIxD,UAAM,YAAY,MAAM,KAAK,EAAE,KAAK,OAAO,SAAS;AAChD,UAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,yBAAyB,KAAK,MAAM,EAAE;AACpE,YAAM,OAAQ,MAAM,KAAK,KAAK;AAI9B,UAAI,CAAC,KAAK,MAAM,KAAK,KAAK,WAAW,GAAG;AACpC,eAAO,EAAE,QAAQ,aAAa,MAAM,YAAY;AAAA,MACpD;AACA,YAAM,EAAE,MAAM,OAAO,IAAI,KAAK,KAAK,CAAC;AACpC,aAAO,EAAE,QAAQ,KAAK;AAAA,IAC1B,CAAC;AAGD,UAAM,aAAa,MAAM,SAAS;AAAA,MAC9B,QAAS;AAAA,MACT,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAS,KAAK,UAAU;AAAA,QACpB,SAAS;AAAA,QACT,QAAS;AAAA,QACT,QAAS,EAAE,QAAQ,YAAY;AAAA,QAC/B,IAAS;AAAA,MACb,CAAC;AAAA,IACL,CAAC,EAAE,KAAK,OAAO,SAAS;AACpB,UAAI,CAAC,KAAK,IAAI;AACV,cAAM,MAAM,MAAM,KAAK,KAAK;AAC5B,cAAM,IAAI,MAAM,qBAAqB,KAAK,MAAM,WAAM,GAAG,EAAE;AAAA,MAC/D;AACA,YAAM,MAAO,MAAM,KAAK,KAAK;AAG7B,aAAO,IAAI,OAAO,MAAM,OAAO;AAAA,IACnC,CAAC;AAGD,WAAO,QAAQ,IAAI,CAAC,WAAW,UAAU,CAAC,EAAE;AAAA,MACxC,CAAC,CAAC,EAAE,QAAQ,KAAK,GAAG,OAAO,OAAO;AAAA,QAC9B;AAAA,QACA;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AAGD,SAAO,QAAQ,IAAI,KAAK;AAC5B;",
   "names": []
 }

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/listStreams.ts"],
-  "sourcesContent": ["import {TNStream} from \"../types/stream\";\nimport {EthereumAddress} from \"../util/EthereumAddress\";\nimport {StreamId} from \"../util/StreamId\";\nimport {Database} from \"@kwilteam/kwil-js/dist/core/database\";\nimport {ListStreamsInput} from \"./client\";\nimport {KwilSigner, NodeKwil, WebKwil} from \"@kwilteam/kwil-js\";\n\n/**\n * List all streams from the TN network.\n * @param kwilClient - The Kwil client.\n * @param kwilSigner - The Kwil signer.\n * @param input - The input parameters for listing streams.\n * @returns A list of stream locators.\n */\nexport async function listStreams(\n  kwilClient: WebKwil | NodeKwil,\n  kwilSigner: KwilSigner,\n  input: ListStreamsInput\n): Promise<TNStream[]> {\n    const result = await kwilClient.call({\n        inputs: {\n            $data_provider: input.dataProvider,\n            $limit: input.limit,\n            $offset: input.offset,\n            $order_by: input.orderBy,\n            $block_height: input.blockHeight,\n        },\n        name: \"list_streams\",\n        namespace: \"main\",\n    }, kwilSigner);\n\n    return await Promise.all(\n        (result.data?.result as {\n            data_provider: string;\n            stream_id: string;\n            stream_type: string;\n            created_at: number;\n        }[]).map(async (database) => ({\n            streamId: await StreamId.generate(database.stream_id),\n            dataProvider: new EthereumAddress(database.data_provider),\n            streamType: database.stream_type,\n            createdAt: database.created_at\n        }))\n    );\n}"],
+  "sourcesContent": ["import {TNStream} from \"../types/stream\";\nimport {EthereumAddress} from \"../util/EthereumAddress\";\nimport {StreamId} from \"../util/StreamId\";\nimport {Database} from \"@trufnetwork/kwil-js/dist/core/database\";\nimport {ListStreamsInput} from \"./client\";\nimport {KwilSigner, NodeKwil, WebKwil} from \"@trufnetwork/kwil-js\";\n\n/**\n * List all streams from the TN network.\n * @param kwilClient - The Kwil client.\n * @param kwilSigner - The Kwil signer.\n * @param input - The input parameters for listing streams.\n * @returns A list of stream locators.\n */\nexport async function listStreams(\n  kwilClient: WebKwil | NodeKwil,\n  kwilSigner: KwilSigner,\n  input: ListStreamsInput\n): Promise<TNStream[]> {\n    const result = await kwilClient.call({\n        inputs: {\n            $data_provider: input.dataProvider,\n            $limit: input.limit,\n            $offset: input.offset,\n            $order_by: input.orderBy,\n            $block_height: input.blockHeight,\n        },\n        name: \"list_streams\",\n        namespace: \"main\",\n    }, kwilSigner);\n\n    return await Promise.all(\n        (result.data?.result as {\n            data_provider: string;\n            stream_id: string;\n            stream_type: string;\n            created_at: number;\n        }[]).map(async (database) => ({\n            streamId: await StreamId.generate(database.stream_id),\n            dataProvider: new EthereumAddress(database.data_provider),\n            streamType: database.stream_type,\n            createdAt: database.created_at\n        }))\n    );\n}"],
   "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,6BAA8B;AAC9B,sBAAuB;AAYvB,eAAsB,YACpB,YACA,YACA,OACqB;AACnB,QAAM,SAAS,MAAM,WAAW,KAAK;AAAA,IACjC,QAAQ;AAAA,MACJ,gBAAgB,MAAM;AAAA,MACtB,QAAQ,MAAM;AAAA,MACd,SAAS,MAAM;AAAA,MACf,WAAW,MAAM;AAAA,MACjB,eAAe,MAAM;AAAA,IACzB;AAAA,IACA,MAAM;AAAA,IACN,WAAW;AAAA,EACf,GAAG,UAAU;AAEb,SAAO,MAAM,QAAQ;AAAA,KAChB,OAAO,MAAM,QAKT,IAAI,OAAO,cAAc;AAAA,MAC1B,UAAU,MAAM,yBAAS,SAAS,SAAS,SAAS;AAAA,MACpD,cAAc,IAAI,uCAAgB,SAAS,aAAa;AAAA,MACxD,YAAY,SAAS;AAAA,MACrB,WAAW,SAAS;AAAA,IACxB,EAAE;AAAA,EACN;AACJ;",
   "names": []
 }

package/dist/cjs/client/nodeClient.cjs

@@ -24,7 +24,7 @@ __export(nodeClient_exports, {
   default: () => nodeClient_default
 });
 module.exports = __toCommonJS(nodeClient_exports);
-var import_kwil_js = require("@kwilteam/kwil-js");
+var import_kwil_js = require("@trufnetwork/kwil-js");
 var import_client = require("./client.cjs");
 var NodeTNClient = class extends import_client.BaseTNClient {
   constructor(options) {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/client/nodeClient.ts"],
-  "sourcesContent": ["import { EnvironmentType } from \"@kwilteam/kwil-js/dist/core/enums\";\nimport { NodeKwil } from \"@kwilteam/kwil-js\";\nimport { BaseTNClient, TNClientOptions } from \"./client\";\n\nexport class NodeTNClient extends BaseTNClient<EnvironmentType.NODE> {\n  constructor(options: TNClientOptions) {\n    super(options);\n    this.kwilClient = new NodeKwil({\n      ...options,\n      timeout: options.timeout ?? 30000,\n      kwilProvider: options.endpoint,\n    });\n  }\n}\n\nexport default NodeTNClient;\n"],
+  "sourcesContent": ["import { EnvironmentType } from \"@trufnetwork/kwil-js/dist/core/enums\";\nimport { NodeKwil } from \"@trufnetwork/kwil-js\";\nimport { BaseTNClient, TNClientOptions } from \"./client\";\n\nexport class NodeTNClient extends BaseTNClient<EnvironmentType.NODE> {\n  constructor(options: TNClientOptions) {\n    super(options);\n    this.kwilClient = new NodeKwil({\n      ...options,\n      timeout: options.timeout ?? 30000,\n      kwilProvider: options.endpoint,\n    });\n  }\n}\n\nexport default NodeTNClient;\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,qBAAyB;AACzB,oBAA8C;AAEvC,IAAM,eAAN,cAA2B,2BAAmC;AAAA,EACnE,YAAY,SAA0B;AACpC,UAAM,OAAO;AACb,SAAK,aAAa,IAAI,wBAAS;AAAA,MAC7B,GAAG;AAAA,MACH,SAAS,QAAQ,WAAW;AAAA,MAC5B,cAAc,QAAQ;AAAA,IACxB,CAAC;AAAA,EACH;AACF;AAEA,IAAO,qBAAQ;",
   "names": []
 }

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

@@ -28,10 +28,19 @@ var import_EthereumAddress = require("../util/EthereumAddress.cjs");
 var import_head = require("../util/head.cjs");
 var import_StreamId = require("../util/StreamId.cjs");
 var import_visibility = require("../util/visibility.cjs");
+var import_cacheMetadataParser = require("../util/cacheMetadataParser.cjs");
+var import_cacheValidation = require("../util/cacheValidation.cjs");
 var import_contractValues = require("./contractValues.cjs");
-var Action = class {
+var Action = class _Action {
   kwilClient;
   kwilSigner;
+  /** Track if deprecation warnings were already emitted */
+  static _legacyWarnEmitted = {
+    getRecord: false,
+    getIndex: false,
+    getFirstRecord: false,
+    getIndexChange: false
+  };
   constructor(kwilClient, kwilSigner) {
     this.kwilClient = kwilClient;
     this.kwilSigner = kwilSigner;
@@ -73,50 +82,159 @@ var Action = class {
     }
     return import_monads_io.Either.right(result.data?.result);
   }
-  /**
-   * Returns the records of the stream within the given date range
-   */
-  async getRecord(input) {
-    const prefix = input.prefix ? input.prefix : "";
-    const result = await this.call(
-      prefix + "get_record",
-      {
-        $data_provider: input.stream.dataProvider.getAddress(),
-        $stream_id: input.stream.streamId.getId(),
-        $from: input.from,
-        $to: input.to,
-        $frozen_at: input.frozenAt
+  async getRecord(inputOrStream, options) {
+    if ("stream" in inputOrStream) {
+      const input = inputOrStream;
+      if (!_Action._legacyWarnEmitted.getRecord) {
+        _Action._legacyWarnEmitted.getRecord = true;
+        if (typeof console !== "undefined" && console.warn) {
+          console.warn("[TN SDK] Deprecated signature: getRecord(input). Use getRecord(stream, options?) instead.");
+        }
       }
+      const prefix2 = input.prefix ? input.prefix : "";
+      const result2 = await this.call(
+        prefix2 + "get_record",
+        {
+          $data_provider: input.stream.dataProvider.getAddress(),
+          $stream_id: input.stream.streamId.getId(),
+          $from: input.from,
+          $to: input.to,
+          $frozen_at: input.frozenAt
+        }
+      );
+      return result2.mapRight(
+        (result3) => result3.map((row) => ({
+          eventTime: row.event_time,
+          value: row.value
+        }))
+      ).throw();
+    }
+    const stream = inputOrStream;
+    if (options) {
+      import_cacheValidation.CacheValidation.validateGetRecordOptions(options);
+      import_cacheValidation.CacheValidation.validateTimeRange(options.from, options.to);
+    }
+    const prefix = options?.prefix ? options.prefix : "";
+    const params = {
+      $data_provider: stream.dataProvider.getAddress(),
+      $stream_id: stream.streamId.getId(),
+      $from: options?.from,
+      $to: options?.to,
+      $frozen_at: options?.frozenAt
+    };
+    if (options?.useCache !== void 0) {
+      params.$use_cache = options.useCache;
+    }
+    const result = await this.kwilClient.call(
+      {
+        namespace: "main",
+        name: prefix + "get_record",
+        inputs: params
+      },
+      this.kwilSigner
     );
-    return result.mapRight(
-      (result2) => result2.map((row) => ({
-        eventTime: row.event_time,
-        value: row.value
-      }))
-    ).throw();
+    if (result.status !== 200) {
+      throw new Error(`Failed to get record: ${result.status}`);
+    }
+    const data = (result.data?.result).map((row) => ({
+      eventTime: row.event_time,
+      value: row.value
+    }));
+    let cache = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(result);
+    if (cache) {
+      cache = {
+        ...cache,
+        streamId: stream.streamId.getId(),
+        dataProvider: stream.dataProvider.getAddress(),
+        from: options?.from,
+        to: options?.to,
+        frozenAt: options?.frozenAt,
+        rowsServed: data.length
+      };
+    }
+    return {
+      data,
+      cache: cache || void 0,
+      logs: result.data?.logs ? import_cacheMetadataParser.CacheMetadataParser.parseLogsForMetadata(result.data.logs) : void 0
+    };
   }
-  /**
-   * Returns the index of the stream within the given date range
-   */
-  async getIndex(input) {
-    const prefix = input.prefix ? input.prefix : "";
-    const result = await this.call(
-      prefix + "get_index",
-      {
-        $data_provider: input.stream.dataProvider.getAddress(),
-        $stream_id: input.stream.streamId.getId(),
-        $from: input.from,
-        $to: input.to,
-        $frozen_at: input.frozenAt,
-        $base_time: input.baseTime
+  async getIndex(inputOrStream, options) {
+    if ("stream" in inputOrStream) {
+      const input = inputOrStream;
+      if (!_Action._legacyWarnEmitted.getIndex) {
+        _Action._legacyWarnEmitted.getIndex = true;
+        if (typeof console !== "undefined" && console.warn) {
+          console.warn("[TN SDK] Deprecated signature: getIndex(input). Use getIndex(stream, options?) instead.");
+        }
       }
+      const prefix2 = input.prefix ? input.prefix : "";
+      const result2 = await this.call(
+        prefix2 + "get_index",
+        {
+          $data_provider: input.stream.dataProvider.getAddress(),
+          $stream_id: input.stream.streamId.getId(),
+          $from: input.from,
+          $to: input.to,
+          $frozen_at: input.frozenAt,
+          $base_time: input.baseTime
+        }
+      );
+      return result2.mapRight(
+        (result3) => result3.map((row) => ({
+          eventTime: row.event_time,
+          value: row.value
+        }))
+      ).throw();
+    }
+    const stream = inputOrStream;
+    if (options) {
+      import_cacheValidation.CacheValidation.validateGetIndexOptions(options);
+      import_cacheValidation.CacheValidation.validateTimeRange(options.from, options.to);
+    }
+    const prefix = options?.prefix ? options.prefix : "";
+    const params = {
+      $data_provider: stream.dataProvider.getAddress(),
+      $stream_id: stream.streamId.getId(),
+      $from: options?.from,
+      $to: options?.to,
+      $frozen_at: options?.frozenAt,
+      $base_time: options?.baseTime
+    };
+    if (options?.useCache !== void 0) {
+      params.$use_cache = options.useCache;
+    }
+    const result = await this.kwilClient.call(
+      {
+        namespace: "main",
+        name: prefix + "get_index",
+        inputs: params
+      },
+      this.kwilSigner
     );
-    return result.mapRight(
-      (result2) => result2.map((row) => ({
-        eventTime: row.event_time,
-        value: row.value
-      }))
-    ).throw();
+    if (result.status !== 200) {
+      throw new Error(`Failed to get index: ${result.status}`);
+    }
+    const data = (result.data?.result).map((row) => ({
+      eventTime: row.event_time,
+      value: row.value
+    }));
+    let cache = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(result);
+    if (cache) {
+      cache = {
+        ...cache,
+        streamId: stream.streamId.getId(),
+        dataProvider: stream.dataProvider.getAddress(),
+        from: options?.from,
+        to: options?.to,
+        frozenAt: options?.frozenAt,
+        rowsServed: data.length
+      };
+    }
+    return {
+      data,
+      cache: cache || void 0,
+      logs: result.data?.logs ? import_cacheMetadataParser.CacheMetadataParser.parseLogsForMetadata(result.data.logs) : void 0
+    };
   }
   /**
    * Returns the type of the stream
@@ -140,25 +258,75 @@ var Action = class {
     }
     return type.value;
   }
-  /**
-   * Returns the first record of the stream
-   */
-  async getFirstRecord(input) {
-    const result = await this.call(
-      "get_first_record",
-      {
-        $data_provider: input.stream.dataProvider.getAddress(),
-        $stream_id: input.stream.streamId.getId(),
-        $after: input.after,
-        $frozen_at: input.frozenAt
+  async getFirstRecord(inputOrStream, options) {
+    if ("stream" in inputOrStream) {
+      const input = inputOrStream;
+      if (!_Action._legacyWarnEmitted.getFirstRecord) {
+        _Action._legacyWarnEmitted.getFirstRecord = true;
+        if (typeof console !== "undefined" && console.warn) {
+          console.warn("[TN SDK] Deprecated signature: getFirstRecord(input). Use getFirstRecord(stream, options?) instead.");
+        }
       }
+      const result2 = await this.call(
+        "get_first_record",
+        {
+          $data_provider: input.stream.dataProvider.getAddress(),
+          $stream_id: input.stream.streamId.getId(),
+          $after: input.after,
+          $frozen_at: input.frozenAt
+        }
+      );
+      return result2.mapRight(import_head.head).mapRight(
+        (result3) => result3.map((result4) => ({
+          eventTime: result4.event_time,
+          value: result4.value
+        })).unwrapOr(null)
+      ).throw();
+    }
+    const stream = inputOrStream;
+    if (options) {
+      import_cacheValidation.CacheValidation.validateGetFirstRecordOptions(options);
+    }
+    const params = {
+      $data_provider: stream.dataProvider.getAddress(),
+      $stream_id: stream.streamId.getId(),
+      $after: options?.after,
+      $frozen_at: options?.frozenAt
+    };
+    if (options?.useCache !== void 0) {
+      params.$use_cache = options.useCache;
+    }
+    const result = await this.kwilClient.call(
+      {
+        namespace: "main",
+        name: "get_first_record",
+        inputs: params
+      },
+      this.kwilSigner
     );
-    return result.mapRight(import_head.head).mapRight(
-      (result2) => result2.map((result3) => ({
-        eventTime: result3.event_time,
-        value: result3.value
-      })).unwrapOr(null)
-    ).throw();
+    if (result.status !== 200) {
+      throw new Error(`Failed to get first record: ${result.status}`);
+    }
+    const rawData = result.data?.result;
+    const data = rawData && rawData.length > 0 ? {
+      eventTime: rawData[0].event_time,
+      value: rawData[0].value
+    } : null;
+    let cache = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(result);
+    if (cache) {
+      cache = {
+        ...cache,
+        streamId: stream.streamId.getId(),
+        dataProvider: stream.dataProvider.getAddress(),
+        frozenAt: options?.frozenAt,
+        rowsServed: data ? 1 : 0
+      };
+    }
+    return {
+      data,
+      cache: cache || void 0,
+      logs: result.data?.logs ? import_cacheMetadataParser.CacheMetadataParser.parseLogsForMetadata(result.data.logs) : void 0
+    };
   }
   async setMetadata(stream, key, value) {
     return await this.executeWithNamedParams("insert_metadata", [
@@ -315,28 +483,84 @@ var Action = class {
       };
     });
   }
-  /**
-   * Returns the index change of the stream within the given date range
-   */
-  async getIndexChange(input) {
-    const result = await this.call(
-      "get_index_change",
-      {
-        $data_provider: input.stream.dataProvider.getAddress(),
-        $stream_id: input.stream.streamId.getId(),
-        $from: input.from,
-        $to: input.to,
-        $frozen_at: input.frozenAt,
-        $base_time: input.baseTime,
-        $time_interval: input.timeInterval
+  async getIndexChange(inputOrStream, options) {
+    if ("stream" in inputOrStream) {
+      const input = inputOrStream;
+      if (!_Action._legacyWarnEmitted.getIndexChange) {
+        _Action._legacyWarnEmitted.getIndexChange = true;
+        if (typeof console !== "undefined" && console.warn) {
+          console.warn("[TN SDK] Deprecated signature: getIndexChange(input). Use getIndexChange(stream, options?) instead.");
+        }
       }
+      const result2 = await this.call(
+        "get_index_change",
+        {
+          $data_provider: input.stream.dataProvider.getAddress(),
+          $stream_id: input.stream.streamId.getId(),
+          $from: input.from,
+          $to: input.to,
+          $frozen_at: input.frozenAt,
+          $base_time: input.baseTime,
+          $time_interval: input.timeInterval
+        }
+      );
+      return result2.mapRight(
+        (result3) => result3.map((row) => ({
+          eventTime: row.event_time,
+          value: row.value
+        }))
+      ).throw();
+    }
+    const stream = inputOrStream;
+    if (!options) {
+      throw new Error("Options parameter is required for cache-aware getIndexChange");
+    }
+    import_cacheValidation.CacheValidation.validateGetIndexChangeOptions(options);
+    import_cacheValidation.CacheValidation.validateTimeRange(options.from, options.to);
+    const params = {
+      $data_provider: stream.dataProvider.getAddress(),
+      $stream_id: stream.streamId.getId(),
+      $from: options.from,
+      $to: options.to,
+      $frozen_at: options.frozenAt,
+      $base_time: options.baseTime,
+      $time_interval: options.timeInterval
+    };
+    if (options.useCache !== void 0) {
+      params.$use_cache = options.useCache;
+    }
+    const result = await this.kwilClient.call(
+      {
+        namespace: "main",
+        name: "get_index_change",
+        inputs: params
+      },
+      this.kwilSigner
     );
-    return result.mapRight(
-      (result2) => result2.map((row) => ({
-        eventTime: row.event_time,
-        value: row.value
-      }))
-    ).throw();
+    if (result.status !== 200) {
+      throw new Error(`Failed to get index change: ${result.status}`);
+    }
+    const data = (result.data?.result).map((row) => ({
+      eventTime: row.event_time,
+      value: row.value
+    }));
+    let cache = import_cacheMetadataParser.CacheMetadataParser.extractFromResponse(result);
+    if (cache) {
+      cache = {
+        ...cache,
+        streamId: stream.streamId.getId(),
+        dataProvider: stream.dataProvider.getAddress(),
+        from: options.from,
+        to: options.to,
+        frozenAt: options.frozenAt,
+        rowsServed: data.length
+      };
+    }
+    return {
+      data,
+      cache: cache || void 0,
+      logs: result.data?.logs ? import_cacheMetadataParser.CacheMetadataParser.parseLogsForMetadata(result.data.logs) : void 0
+    };
   }
   /**
    * A custom method that accepts the procedure name and the input of GetRecordInput