@provablehq/sdk 0.9.1 → 0.9.3

package/dist/mainnet/program-manager.d.ts

@@ -1,9 +1,9 @@
-import { Account } from "./account";
-import { AleoNetworkClient, AleoNetworkClientOptions, ProgramImports } from "./network-client";
-import { ImportedPrograms, ImportedVerifyingKeys } from "./models/imports";
-import { RecordProvider, RecordSearchParams } from "./record-provider";
-import { FunctionKeyPair, FunctionKeyProvider, KeySearchParams } from "./function-key-provider";
-import { ExecutionResponse, OfflineQuery, RecordPlaintext, PrivateKey, Program, ProvingKey, VerifyingKey, Transaction } from "./wasm";
+import { Account } from "./account.js";
+import { AleoNetworkClient, AleoNetworkClientOptions, ProgramImports } from "./network-client.js";
+import { ImportedPrograms, ImportedVerifyingKeys } from "./models/imports.js";
+import { RecordProvider, RecordSearchParams } from "./record-provider.js";
+import { FunctionKeyPair, FunctionKeyProvider, KeySearchParams } from "./function-key-provider.js";
+import { Authorization, ExecutionResponse, OfflineQuery, RecordPlaintext, PrivateKey, Program, ProvingKey, VerifyingKey, Transaction } from "./wasm.js";
 /**
  * Represents the options for executing a transaction in the Aleo network.
  * This interface is used to specify the parameters required for building and submitting an execution transaction.
@@ -39,6 +39,40 @@ interface ExecuteOptions {
     program?: string | Program;
     imports?: ProgramImports;
 }
+/**
+ * Options for building an Authorization for a function.
+ *
+ * @property programName {string} Name of the program containing the function to build the authorization for.
+ * @property functionName {string} Name of the function name to build the authorization for.
+ * @property inputs {string[]} The inputs to the function.
+ * @property programSource {string | Program} The optional source code for the program to build an execution for.
+ * @property privateKey {PrivateKey} Optional private key to use to build the authorization.
+ * @property programImports {ProgramImports} The other programs the program imports.
+ */
+interface AuthorizationOptions {
+    programName: string;
+    functionName: string;
+    inputs: string[];
+    programSource?: string | Program;
+    privateKey?: PrivateKey;
+    programImports?: ProgramImports;
+}
+/**
+ * Options for executing a fee authorization.
+ *
+ * @property deploymentOrExecutionId {string} The id of a previously built Execution or Authorization.
+ * @property baseFeeCredits {number} The number of Aleo Credits to pay for the base fee.
+ * @property priorityFeeCredits {number} The number of Aleo Credits to pay for the priority fee.
+ * @property privateKey {PrivateKey} Optional private key to specify for the authorization.
+ * @property feeRecord {RecordPlaintext} A record to specify to pay the private fee. If this is specified a `fee_private` authorization will be built.
+ */
+interface FeeAuthorizationOptions {
+    deploymentOrExecutionId: string;
+    baseFeeCredits: number;
+    priorityFeeCredits?: number;
+    privateKey?: PrivateKey;
+    feeRecord?: RecordPlaintext;
+}
 /**
  * The ProgramManager class is used to execute and deploy programs on the Aleo network and create value transfers.
  */
@@ -168,7 +202,7 @@ declare class ProgramManager {
      * /// Import the mainnet version of the sdk.
      * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
      *
-     * // Create a new NetworkClient, KeyProvider, and RecordProvider
+     * // Create a new NetworkClient, KeyProvider, and RecordProvider.
      * const keyProvider = new AleoKeyProvider();
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
      * keyProvider.useCache = true;
@@ -200,7 +234,7 @@ declare class ProgramManager {
      * /// Import the mainnet version of the sdk.
      * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
      *
-     * // Create a new NetworkClient, KeyProvider, and RecordProvider using official Aleo record, key, and network providers
+     * // Create a new NetworkClient, KeyProvider, and RecordProvider.
      * const keyProvider = new AleoKeyProvider();
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
      * keyProvider.useCache = true;
@@ -228,6 +262,68 @@ declare class ProgramManager {
      * }, 10000);
      */
     buildExecutionTransaction(options: ExecuteOptions): Promise<Transaction>;
+    /**
+     * Builds a SnarkVM `Authorization` for a specific function.
+     *
+     * @param {AuthorizationOptions} options - The options for building the `Authorization`
+     * @returns {Promise<Authorization>} - A promise that resolves to an `Authorization` or throws an Error.
+     *
+     * @example
+     * /// Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a new NetworkClient, KeyProvider, and RecordProvider.
+     * const keyProvider = new AleoKeyProvider();
+     * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache = true;
+     *
+     * // Initialize a ProgramManager with the key and record providers.
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
+     *
+     * // Build the `Authorization`.
+     * const authorization = await programManager.buildAuthorization({
+     *   programName: "credits.aleo",
+     *   functionName: "transfer_public",
+     *   inputs: [
+     *     "aleo1vwls2ete8dk8uu2kmkmzumd7q38fvshrht8hlc0a5362uq8ftgyqnm3w08",
+     *     "10000000u64",
+     *   ],
+     * });
+     */
+    buildAuthorization(options: AuthorizationOptions): Promise<Authorization>;
+    /**
+     * Builds a SnarkVM fee `Authorization` for `credits.aleo/fee_private` or `credits.aleo/fee_public`. If a record is provided `fee_private` will be executed, otherwise `fee_public` will be executed.
+     *
+     * @param {FeeAuthorizationOptions} options - The options for building the `Authorization`.
+     * @returns {Promise<Authorization>} - A promise that resolves to an `Authorization` or throws an Error.
+     *
+     * @example
+     * /// Import the mainnet version of the sdk.
+     * import { AleoKeyProvider, ProgramManager, NetworkRecordProvider } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a new NetworkClient, KeyProvider, and RecordProvider.
+     * const keyProvider = new AleoKeyProvider();
+     * const recordProvider = new NetworkRecordProvider(account, networkClient);
+     * keyProvider.useCache = true;
+     *
+     * // Initialize a ProgramManager with the key and record providers.
+     * const programManager = new ProgramManager("https://api.explorer.provable.com/v1", keyProvider, recordProvider);
+     *
+     * // Build a credits.aleo/fee_public `Authorization`.
+     * const feePublicAuthorization = await programManager.authorizeFee({
+     *   deploymentOrExecutionId: "2423957656946557501636078245035919227529640894159332581642187482178647335171field",
+     *   baseFeeCredits: 0.1,
+     * });
+     *
+     * // Build a credits.aleo/fee_private `Authorization`.
+     * const record = "{ owner: aleo1j7qxyunfldj2lp8hsvy7mw5k8zaqgjfyr72x2gh3x4ewgae8v5gscf5jh3.private, microcredits: 1500000000000000u64.private, _nonce: 3077450429259593211617823051143573281856129402760267155982965992208217472983group.public }";
+     * const feePrivateAuthorization = await programManager.authorizeFee({
+     *   deploymentOrExecutionId: "2423957656946557501636078245035919227529640894159332581642187482178647335171field",
+     *   baseFeeCredits: 0.1,
+     *   feeRecord: record,
+     * });
+     */
+    buildFeeAuthorization(options: FeeAuthorizationOptions): Promise<Authorization>;
     /**
      * Builds an execution transaction for submission to the Aleo network.
      *
@@ -891,4 +987,4 @@ declare class ProgramManager {
     verifyProgram(program: string): boolean;
     getCreditsRecord(amount: number, nonces: string[], record?: RecordPlaintext | string, params?: RecordSearchParams): Promise<RecordPlaintext>;
 }
-export { ProgramManager };
+export { ProgramManager, AuthorizationOptions, FeeAuthorizationOptions, ExecuteOptions };

package/dist/mainnet/record-provider.d.ts

@@ -1,6 +1,6 @@
-import { RecordPlaintext } from "./wasm";
-import { Account } from "./account";
-import { AleoNetworkClient } from "./network-client";
+import { RecordPlaintext } from "./wasm.js";
+import { Account } from "./account.js";
+import { AleoNetworkClient } from "./network-client.js";
 /**
  * Interface for record search parameters. This allows for arbitrary search parameters to be passed to record provider
  * implementations.

package/dist/mainnet/wasm.d.ts

@@ -1 +1 @@
-export { Address, BHP256, BHP512, BHP768, BHP1024, Ciphertext, ComputeKey, Execution, ExecutionResponse, Field, Group, OfflineQuery, Metadata, Pedersen64, Pedersen128, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager, ProvingKey, RecordCiphertext, RecordPlaintext, Scalar, Signature, Transaction, Transition, VerifyingKey, ViewKey, initThreadPool, verifyFunctionExecution, } from "@provablehq/wasm/mainnet.js";
+export { Address, Authorization, BHP256, BHP512, BHP768, BHP1024, Ciphertext, ComputeKey, EncryptionToolkit, ExecutionRequest, Execution, ExecutionResponse, Field, Group, OfflineQuery, Metadata, Pedersen64, Pedersen128, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager, ProvingKey, RecordCiphertext, RecordPlaintext, Scalar, Signature, Transaction, Transition, VerifyingKey, ViewKey, initThreadPool, verifyFunctionExecution, } from "@provablehq/wasm/mainnet.js";

package/dist/mainnet/worker.d.ts

@@ -1,5 +1,5 @@
-import "./polyfill/shared";
-import { PrivateKey } from "./browser";
+import "./polyfill/shared.js";
+import { PrivateKey } from "./browser.js";
 export interface WorkerAPI {
     run: (localProgram: string, aleoFunction: string, inputs: string[], privateKey: string) => Promise<{
         outputs: any;

package/dist/mainnet/worker.js

@@ -1,6 +1,6 @@
 import 'core-js/proposals/json-parse-with-source.js';
 import { initThreadPool, PrivateKey, verifyFunctionExecution } from '@provablehq/wasm/mainnet.js';
-import { P as ProgramManager, A as AleoKeyProvider, a as AleoKeyProviderParams } from './program-manager-DMDKstZ8.js';
+import { P as ProgramManager, A as AleoKeyProvider, a as AleoKeyProviderParams } from './program-manager-BfZnPCKl.js';
 import { expose } from 'comlink';
 
 await initThreadPool();

package/dist/mainnet/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","sources":["../../src/worker.ts"],"sourcesContent":["import \"./polyfill/shared\";\nimport {initThreadPool, ProgramManager, PrivateKey, verifyFunctionExecution, FunctionKeyPair} from \"./browser\";\nimport { AleoKeyProvider, AleoKeyProviderParams} from \"./function-key-provider\";\nimport { expose } from \"comlink\";\n\nawait initThreadPool();\n\nconst defaultHost = \"https://api.explorer.provable.com/v1\";\nconst keyProvider = new AleoKeyProvider();\nconst programManager = new ProgramManager(\n    defaultHost,\n    keyProvider,\n    undefined\n);\n\nkeyProvider.useCache(true);\n\nlet lastLocalProgram: string = \"\";\n\nexport interface WorkerAPI {\n    run: (\n        localProgram: string,\n        aleoFunction: string,\n        inputs: string[],\n        privateKey: string\n    ) => Promise<{ outputs: any; execution: string } | string>;\n\n    getPrivateKey: () => Promise<PrivateKey>;\n}\nasync function run(\n    localProgram: string,\n    aleoFunction: string,\n    inputs: string[],\n    privateKey: string,\n    proveExecution = false\n) {\n    console.log(\"Web worker: Executing function locally...\");\n    const startTime = performance.now();\n\n    // Ensure the program is valid and that it contains the function specified\n    let program;\n\n    try {\n        program = programManager.createProgramFromSource(localProgram);\n    } catch (e) {\n        throw new Error(\"Error creating program from source\");\n    }\n\n    const program_id = program.id();\n    if (!program.hasFunction(aleoFunction)) {\n        throw new Error(`Program ${program_id} does not contain function ${aleoFunction}`);\n    }\n    const cacheKey = `${program_id}:${aleoFunction}`;\n\n\n    // Get the program imports\n    let imports;\n\n    try {\n        imports = await programManager.networkClient.getProgramImports(\n            localProgram\n        );\n    } catch (e) {\n        throw new Error(\"Error getting program imports\");\n    }\n\n    // Get the proving and verifying keys for the function\n    if (lastLocalProgram !== localProgram) {\n        const keys = <FunctionKeyPair>await programManager.synthesizeKeys(\n            localProgram,\n            aleoFunction,\n            inputs,\n            PrivateKey.from_string(privateKey)\n        );\n        programManager.keyProvider.cacheKeys(cacheKey, keys);\n        lastLocalProgram = localProgram;\n    }\n\n    // Pass the cache key to the execute function\n    const keyParams = new AleoKeyProviderParams({\n        cacheKey: cacheKey,\n    });\n\n    // Execute the function locally\n    const response = await programManager.run(\n        localProgram,\n        aleoFunction,\n        inputs,\n        proveExecution,\n        imports,\n        keyParams,\n        undefined,\n        undefined,\n        PrivateKey.from_string(privateKey),\n    );\n\n    // Return the outputs to the main thread\n    console.log(\n        `Web worker: Local execution completed in ${\n            performance.now() - startTime\n        } ms`\n    );\n    const outputs = response.getOutputs();\n    const execution = response.getExecution();\n    let executionString = \"\";\n\n    let keys;\n\n    try {\n        keys = keyProvider.getKeys(cacheKey);\n    } catch (e) {\n        throw new Error(\"Could not get verifying key\");\n    }\n\n    const verifyingKey = keys[1];\n\n    if (execution) {\n        verifyFunctionExecution(\n            execution,\n            verifyingKey,\n            program,\n            \"hello\"\n        );\n        executionString = execution.toString();\n        console.log(\"Execution verified successfully: \" + execution);\n    } else {\n        executionString = \"\";\n    }\n\n    console.log(`Function execution response: ${outputs}`);\n\n    return { outputs: outputs, execution: executionString };\n}\n\nasync function getPrivateKey() {\n    const privateKey = new PrivateKey();\n    return privateKey.to_string();\n}\n\nconst workerAPI = { run, getPrivateKey };\nexpose(workerAPI);\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"worker.js","sources":["../../src/worker.ts"],"sourcesContent":["import \"./polyfill/shared.js\";\nimport {initThreadPool, ProgramManager, PrivateKey, verifyFunctionExecution, FunctionKeyPair} from \"./browser.js\";\nimport { AleoKeyProvider, AleoKeyProviderParams} from \"./function-key-provider.js\";\nimport { expose } from \"comlink\";\n\nawait initThreadPool();\n\nconst defaultHost = \"https://api.explorer.provable.com/v1\";\nconst keyProvider = new AleoKeyProvider();\nconst programManager = new ProgramManager(\n    defaultHost,\n    keyProvider,\n    undefined\n);\n\nkeyProvider.useCache(true);\n\nlet lastLocalProgram: string = \"\";\n\nexport interface WorkerAPI {\n    run: (\n        localProgram: string,\n        aleoFunction: string,\n        inputs: string[],\n        privateKey: string\n    ) => Promise<{ outputs: any; execution: string } | string>;\n\n    getPrivateKey: () => Promise<PrivateKey>;\n}\nasync function run(\n    localProgram: string,\n    aleoFunction: string,\n    inputs: string[],\n    privateKey: string,\n    proveExecution = false\n) {\n    console.log(\"Web worker: Executing function locally...\");\n    const startTime = performance.now();\n\n    // Ensure the program is valid and that it contains the function specified\n    let program;\n\n    try {\n        program = programManager.createProgramFromSource(localProgram);\n    } catch (e) {\n        throw new Error(\"Error creating program from source\");\n    }\n\n    const program_id = program.id();\n    if (!program.hasFunction(aleoFunction)) {\n        throw new Error(`Program ${program_id} does not contain function ${aleoFunction}`);\n    }\n    const cacheKey = `${program_id}:${aleoFunction}`;\n\n\n    // Get the program imports\n    let imports;\n\n    try {\n        imports = await programManager.networkClient.getProgramImports(\n            localProgram\n        );\n    } catch (e) {\n        throw new Error(\"Error getting program imports\");\n    }\n\n    // Get the proving and verifying keys for the function\n    if (lastLocalProgram !== localProgram) {\n        const keys = <FunctionKeyPair>await programManager.synthesizeKeys(\n            localProgram,\n            aleoFunction,\n            inputs,\n            PrivateKey.from_string(privateKey)\n        );\n        programManager.keyProvider.cacheKeys(cacheKey, keys);\n        lastLocalProgram = localProgram;\n    }\n\n    // Pass the cache key to the execute function\n    const keyParams = new AleoKeyProviderParams({\n        cacheKey: cacheKey,\n    });\n\n    // Execute the function locally\n    const response = await programManager.run(\n        localProgram,\n        aleoFunction,\n        inputs,\n        proveExecution,\n        imports,\n        keyParams,\n        undefined,\n        undefined,\n        PrivateKey.from_string(privateKey),\n    );\n\n    // Return the outputs to the main thread\n    console.log(\n        `Web worker: Local execution completed in ${\n            performance.now() - startTime\n        } ms`\n    );\n    const outputs = response.getOutputs();\n    const execution = response.getExecution();\n    let executionString = \"\";\n\n    let keys;\n\n    try {\n        keys = keyProvider.getKeys(cacheKey);\n    } catch (e) {\n        throw new Error(\"Could not get verifying key\");\n    }\n\n    const verifyingKey = keys[1];\n\n    if (execution) {\n        verifyFunctionExecution(\n            execution,\n            verifyingKey,\n            program,\n            \"hello\"\n        );\n        executionString = execution.toString();\n        console.log(\"Execution verified successfully: \" + execution);\n    } else {\n        executionString = \"\";\n    }\n\n    console.log(`Function execution response: ${outputs}`);\n\n    return { outputs: outputs, execution: executionString };\n}\n\nasync function getPrivateKey() {\n    const privateKey = new PrivateKey();\n    return privateKey.to_string();\n}\n\nconst workerAPI = { run, getPrivateKey };\nexpose(workerAPI);\n"],"names":[],"mappings":"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"}

package/dist/testnet/account.d.ts

@@ -1,4 +1,4 @@
-import { Address, ComputeKey, PrivateKey, Signature, ViewKey, PrivateKeyCiphertext, RecordCiphertext, RecordPlaintext } from "./wasm";
+import { Address, ComputeKey, Field, Group, PrivateKey, Signature, ViewKey, PrivateKeyCiphertext, RecordCiphertext, RecordPlaintext } from "./wasm.js";
 interface AccountParam {
     privateKey?: string;
     seed?: Uint8Array;
@@ -182,6 +182,41 @@ export declare class Account {
      * const decryptedRecords = account.decryptRecords(records);
      */
     decryptRecords(ciphertexts: string[]): RecordPlaintext[];
+    /**
+     * Generates a record view key from the account owner's view key and the record ciphertext.
+     * This key can be used to decrypt the record without revealing the account's view key.
+     * @param {RecordCiphertext | string} recordCiphertext The record ciphertext to generate the view key for
+     * @returns {Field} The record view key
+     *
+     * @example
+     * // Import the Account class
+     * import { Account } from "@provablehq/sdk/testnet.js";
+     *
+     * // Create an account object from a previously encrypted ciphertext and password.
+     * const account = Account.fromCiphertext(process.env.ciphertext!, process.env.password!);
+     *
+     * // Generate a record view key from the account's view key and a record ciphertext
+     * const recordCiphertext = RecordCiphertext.fromString("your_record_ciphertext_here");
+     * const recordViewKey = account.generateRecordViewKey(recordCiphertext);
+     */
+    generateRecordViewKey(recordCiphertext: RecordCiphertext | string): Field;
+    /**
+     * Generates a transition view key from the account owner's view key and the transition public key.
+     * This key can be used to decrypt the private inputs and outputs of a the transition without
+     * revealing the account's view key.
+     * @param {string | Group} tpk The transition public key
+     * @returns {Field} The transition view key
+     *
+     * @example
+     * // Import the Account class
+     * import { Account } from "@provablehq/sdk/testnet.js";
+     *
+     * // Generate a transition view key from the account's view key and a transition public key
+     * const tpk = Group.fromString("your_transition_public_key_here");
+     *
+     * const transitionViewKey = account.generateTransitionViewKey(tpk);
+     */
+    generateTransitionViewKey(tpk: string | Group): Field;
     /**
      * Determines whether the account owns a ciphertext record.
      * @param {RecordCiphertext | string} ciphertext The record ciphertext to check ownership of

package/dist/testnet/browser.d.ts

@@ -1,38 +1,38 @@
-import "./polyfill/shared";
-import { Account } from "./account";
-import { AleoNetworkClient, ProgramImports } from "./network-client";
-import { BlockJSON, Header, Metadata } from "./models/blockJSON";
-import { ConfirmedTransactionJSON } from "./models/confirmed_transaction";
-import { DeploymentJSON, VerifyingKeys } from "./models/deployment/deploymentJSON";
-import { DeploymentObject } from "./models/deployment/deploymentObject";
-import { ExecutionJSON, FeeExecutionJSON } from "./models/execution/executionJSON";
-import { ExecutionObject, FeeExecutionObject } from "./models/execution/executionObject";
-import { FinalizeJSON } from "./models/finalizeJSON";
-import { FunctionObject } from "./models/functionObject";
-import { ImportedVerifyingKeys, ImportedPrograms } from "./models/imports";
-import { InputJSON } from "./models/input/inputJSON";
-import { InputObject } from "./models/input/inputObject";
-import { OutputJSON } from "./models/output/outputJSON";
-import { OutputObject } from "./models/output/outputObject";
-import { OwnerJSON } from "./models/owner/ownerJSON";
-import { PlaintextArray } from "./models/plaintext/array";
-import { PlaintextLiteral } from "./models/plaintext/literal";
-import { PlaintextObject } from "./models/plaintext/plaintext";
-import { PlaintextStruct } from "./models/plaintext/struct";
-import { RatificationJSON } from "./models/ratification";
-import { SolutionsJSON, SolutionJSON, PartialSolutionJSON } from "./models/solution";
-import { TransactionJSON } from "./models/transaction/transactionJSON";
-import { TransactionObject } from "./models/transaction/transactionObject";
-import { TransitionJSON } from "./models/transition/transitionJSON";
-import { TransitionObject } from "./models/transition/transitionObject";
-import { AleoKeyProvider, AleoKeyProviderParams, AleoKeyProviderInitParams, CachedKeyPair, FunctionKeyPair, FunctionKeyProvider, KeySearchParams } from "./function-key-provider";
-import { OfflineKeyProvider, OfflineSearchParams } from "./offline-key-provider";
-import { BlockHeightSearch, NetworkRecordProvider, RecordProvider, RecordSearchParams } from "./record-provider";
+import "./polyfill/shared.js";
+import { Account } from "./account.js";
+import { AleoNetworkClient, ProgramImports } from "./network-client.js";
+import { BlockJSON, Header, Metadata } from "./models/blockJSON.js";
+import { ConfirmedTransactionJSON } from "./models/confirmed_transaction.js";
+import { DeploymentJSON, VerifyingKeys } from "./models/deployment/deploymentJSON.js";
+import { DeploymentObject } from "./models/deployment/deploymentObject.js";
+import { ExecutionJSON, FeeExecutionJSON } from "./models/execution/executionJSON.js";
+import { ExecutionObject, FeeExecutionObject } from "./models/execution/executionObject.js";
+import { FinalizeJSON } from "./models/finalizeJSON.js";
+import { FunctionObject } from "./models/functionObject.js";
+import { ImportedVerifyingKeys, ImportedPrograms } from "./models/imports.js";
+import { InputJSON } from "./models/input/inputJSON.js";
+import { InputObject } from "./models/input/inputObject.js";
+import { OutputJSON } from "./models/output/outputJSON.js";
+import { OutputObject } from "./models/output/outputObject.js";
+import { OwnerJSON } from "./models/owner/ownerJSON.js";
+import { PlaintextArray } from "./models/plaintext/array.js";
+import { PlaintextLiteral } from "./models/plaintext/literal.js";
+import { PlaintextObject } from "./models/plaintext/plaintext.js";
+import { PlaintextStruct } from "./models/plaintext/struct.js";
+import { RatificationJSON } from "./models/ratification.js";
+import { SolutionsJSON, SolutionJSON, PartialSolutionJSON } from "./models/solution.js";
+import { TransactionJSON } from "./models/transaction/transactionJSON.js";
+import { TransactionObject } from "./models/transaction/transactionObject.js";
+import { TransitionJSON } from "./models/transition/transitionJSON.js";
+import { TransitionObject } from "./models/transition/transitionObject.js";
+import { AleoKeyProvider, AleoKeyProviderParams, AleoKeyProviderInitParams, CachedKeyPair, FunctionKeyPair, FunctionKeyProvider, KeySearchParams } from "./function-key-provider.js";
+import { OfflineKeyProvider, OfflineSearchParams } from "./offline-key-provider.js";
+import { BlockHeightSearch, NetworkRecordProvider, RecordProvider, RecordSearchParams } from "./record-provider.js";
 declare function initializeWasm(): Promise<void>;
-export { createAleoWorker } from "./managed-worker";
-export { ProgramManager } from "./program-manager";
-export { logAndThrow } from "./utils";
-export { Address, BHP256, BHP512, BHP768, BHP1024, Ciphertext, ComputeKey, Execution as FunctionExecution, ExecutionResponse, Field, Group, OfflineQuery, Pedersen64, Pedersen128, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager as ProgramManagerBase, ProvingKey, RecordCiphertext, RecordPlaintext, Signature, Scalar, Transaction, Transition, VerifyingKey, ViewKey, initThreadPool, verifyFunctionExecution, } from "./wasm";
+export { createAleoWorker } from "./managed-worker.js";
+export { ProgramManager } from "./program-manager.js";
+export { logAndThrow } from "./utils.js";
+export { Address, Authorization, BHP256, BHP512, BHP768, BHP1024, Ciphertext, ComputeKey, Execution as FunctionExecution, ExecutionRequest, ExecutionResponse, EncryptionToolkit, Field, Group, OfflineQuery, Pedersen64, Pedersen128, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager as ProgramManagerBase, ProvingKey, RecordCiphertext, RecordPlaintext, Signature, Scalar, Transaction, Transition, VerifyingKey, ViewKey, initThreadPool, verifyFunctionExecution, } from "./wasm.js";
 export { initializeWasm };
-export { Key, CREDITS_PROGRAM_KEYS, KEY_STORE, PRIVATE_TRANSFER, PRIVATE_TO_PUBLIC_TRANSFER, PRIVATE_TRANSFER_TYPES, PUBLIC_TRANSFER, PUBLIC_TRANSFER_AS_SIGNER, PUBLIC_TO_PRIVATE_TRANSFER, VALID_TRANSFER_TYPES, } from "./constants";
+export { Key, CREDITS_PROGRAM_KEYS, KEY_STORE, PRIVATE_TRANSFER, PRIVATE_TO_PUBLIC_TRANSFER, PRIVATE_TRANSFER_TYPES, PUBLIC_TRANSFER, PUBLIC_TRANSFER_AS_SIGNER, PUBLIC_TO_PRIVATE_TRANSFER, VALID_TRANSFER_TYPES, } from "./constants.js";
 export { Account, AleoKeyProvider, AleoKeyProviderParams, AleoKeyProviderInitParams, AleoNetworkClient, BlockJSON, BlockHeightSearch, CachedKeyPair, ConfirmedTransactionJSON, DeploymentJSON, DeploymentObject, ExecutionJSON, ExecutionObject, FeeExecutionJSON, FeeExecutionObject, FinalizeJSON, FunctionObject, FunctionKeyPair, FunctionKeyProvider, Header, ImportedPrograms, ImportedVerifyingKeys, InputJSON, InputObject, KeySearchParams, Metadata, NetworkRecordProvider, OfflineKeyProvider, OfflineSearchParams, OutputJSON, OutputObject, OwnerJSON, PartialSolutionJSON, PlaintextArray, PlaintextLiteral, PlaintextObject, PlaintextStruct, ProgramImports, RatificationJSON, RecordProvider, RecordSearchParams, SolutionJSON, SolutionsJSON, TransactionJSON, TransactionObject, TransitionJSON, TransitionObject, VerifyingKeys, };

package/dist/testnet/browser.js

@@ -1,8 +1,8 @@
 import 'core-js/proposals/json-parse-with-source.js';
-import { ViewKey, ComputeKey, Address, PrivateKeyCiphertext, PrivateKey, RecordCiphertext, ProvingKey, VerifyingKey } from '@provablehq/wasm/testnet.js';
-export { Address, BHP1024, BHP256, BHP512, BHP768, Ciphertext, ComputeKey, ExecutionResponse, Field, Execution as FunctionExecution, Group, OfflineQuery, Pedersen128, Pedersen64, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager as ProgramManagerBase, ProvingKey, RecordCiphertext, RecordPlaintext, Scalar, Signature, Transaction, Transition, VerifyingKey, ViewKey, initThreadPool, verifyFunctionExecution } from '@provablehq/wasm/testnet.js';
-import { C as CREDITS_PROGRAM_KEYS, c as PRIVATE_TRANSFER, d as PRIVATE_TO_PUBLIC_TRANSFER, f as PUBLIC_TRANSFER, g as PUBLIC_TRANSFER_AS_SIGNER, h as PUBLIC_TO_PRIVATE_TRANSFER, l as logAndThrow } from './program-manager-BTHjM8b7.js';
-export { A as AleoKeyProvider, a as AleoKeyProviderParams, b as AleoNetworkClient, K as KEY_STORE, e as PRIVATE_TRANSFER_TYPES, P as ProgramManager, V as VALID_TRANSFER_TYPES } from './program-manager-BTHjM8b7.js';
+import { ViewKey, ComputeKey, Address, PrivateKeyCiphertext, PrivateKey, RecordCiphertext, EncryptionToolkit, Group, ProvingKey, VerifyingKey } from '@provablehq/wasm/testnet.js';
+export { Address, Authorization, BHP1024, BHP256, BHP512, BHP768, Ciphertext, ComputeKey, EncryptionToolkit, ExecutionRequest, ExecutionResponse, Field, Execution as FunctionExecution, Group, OfflineQuery, Pedersen128, Pedersen64, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager as ProgramManagerBase, ProvingKey, RecordCiphertext, RecordPlaintext, Scalar, Signature, Transaction, Transition, VerifyingKey, ViewKey, initThreadPool, verifyFunctionExecution } from '@provablehq/wasm/testnet.js';
+import { C as CREDITS_PROGRAM_KEYS, c as PRIVATE_TRANSFER, d as PRIVATE_TO_PUBLIC_TRANSFER, f as PUBLIC_TRANSFER, g as PUBLIC_TRANSFER_AS_SIGNER, h as PUBLIC_TO_PRIVATE_TRANSFER, l as logAndThrow } from './program-manager-kuhVcNPN.js';
+export { A as AleoKeyProvider, a as AleoKeyProviderParams, b as AleoNetworkClient, K as KEY_STORE, e as PRIVATE_TRANSFER_TYPES, P as ProgramManager, V as VALID_TRANSFER_TYPES } from './program-manager-kuhVcNPN.js';
 import { wrap } from 'comlink';
 
 /**
@@ -230,6 +230,54 @@ class Account {
     decryptRecords(ciphertexts) {
         return ciphertexts.map((ciphertext) => this._viewKey.decrypt(ciphertext));
     }
+    /**
+     * Generates a record view key from the account owner's view key and the record ciphertext.
+     * This key can be used to decrypt the record without revealing the account's view key.
+     * @param {RecordCiphertext | string} recordCiphertext The record ciphertext to generate the view key for
+     * @returns {Field} The record view key
+     *
+     * @example
+     * // Import the Account class
+     * import { Account } from "@provablehq/sdk/testnet.js";
+     *
+     * // Create an account object from a previously encrypted ciphertext and password.
+     * const account = Account.fromCiphertext(process.env.ciphertext!, process.env.password!);
+     *
+     * // Generate a record view key from the account's view key and a record ciphertext
+     * const recordCiphertext = RecordCiphertext.fromString("your_record_ciphertext_here");
+     * const recordViewKey = account.generateRecordViewKey(recordCiphertext);
+     */
+    generateRecordViewKey(recordCiphertext) {
+        if (typeof recordCiphertext === 'string') {
+            recordCiphertext = RecordCiphertext.fromString(recordCiphertext);
+        }
+        if (!(recordCiphertext.isOwner(this._viewKey))) {
+            throw new Error("The record ciphertext does not belong to this account");
+        }
+        return EncryptionToolkit.generateRecordViewKey(this._viewKey, recordCiphertext);
+    }
+    /**
+     * Generates a transition view key from the account owner's view key and the transition public key.
+     * This key can be used to decrypt the private inputs and outputs of a the transition without
+     * revealing the account's view key.
+     * @param {string | Group} tpk The transition public key
+     * @returns {Field} The transition view key
+     *
+     * @example
+     * // Import the Account class
+     * import { Account } from "@provablehq/sdk/testnet.js";
+     *
+     * // Generate a transition view key from the account's view key and a transition public key
+     * const tpk = Group.fromString("your_transition_public_key_here");
+     *
+     * const transitionViewKey = account.generateTransitionViewKey(tpk);
+     */
+    generateTransitionViewKey(tpk) {
+        if (typeof tpk === 'string') {
+            tpk = Group.fromString(tpk);
+        }
+        return EncryptionToolkit.generateTvk(this._viewKey, tpk);
+    }
     /**
      * Determines whether the account owns a ciphertext record.
      * @param {RecordCiphertext | string} ciphertext The record ciphertext to check ownership of