@provablehq/sdk 0.9.16-rc → 0.9.16

package/dist/mainnet/network-client.d.ts

@@ -3,7 +3,7 @@ import { BlockJSON } from "./models/blockJSON.js";
 import { TransactionJSON } from "./models/transaction/transactionJSON.js";
 import { Address, Plaintext, Program, ProvingRequest, RecordPlaintext, PrivateKey, Transaction } from "./wasm.js";
 import { ConfirmedTransactionJSON } from "./models/confirmed_transaction.js";
-import { ProvingResponse } from "./models/provingResponse.js";
+import { ProvingResponse, ProvingResult } from "./models/provingResponse.js";
 type ProgramImports = {
     [key: string]: string | Program;
 };
@@ -11,6 +11,8 @@ interface AleoNetworkClientOptions {
     headers?: {
         [key: string]: string;
     };
+    proverUri?: string;
+    recordScannerUri?: string;
 }
 /**
  * Interface for the JWT data.
@@ -37,6 +39,7 @@ interface DelegatedProvingParams {
     apiKey?: string;
     consumerId?: string;
     jwtData?: JWTData;
+    dpsPrivacy?: boolean;
 }
 /**
  * Client library that encapsulates REST calls to publicly exposed endpoints of Aleo nodes. The methods provided in this
@@ -51,7 +54,7 @@ interface DelegatedProvingParams {
  * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
  * const apiKey = process.env.apiKey;
  * const consumerId = process.env.consumerId;
- * const publicNetworkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined, account);
+ * const publicNetworkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined, account);
  */
 declare class AleoNetworkClient {
     host: string;
@@ -67,6 +70,8 @@ declare class AleoNetworkClient {
     apiKey?: string;
     consumerId?: string;
     jwtData?: JWTData;
+    proverUri?: string;
+    recordScannerUri?: string;
     constructor(host: string, options?: AleoNetworkClientOptions);
     /**
      * Set an account to use in networkClient calls
@@ -75,7 +80,7 @@ declare class AleoNetworkClient {
      * @example
      * import { Account, AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1");
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
      * const account = new Account();
      * networkClient.setAccount(account);
      */
@@ -99,9 +104,39 @@ declare class AleoNetworkClient {
      * const networkClient = new AleoNetworkClient("http://0.0.0.0:3030", undefined);
      *
      * // Set the host to a public node.
-     * networkClient.setHost("http://api.explorer.provable.com/v1");
+     * networkClient.setHost("https://api.provable.com/v2");
      */
     setHost(host: string): void;
+    /**
+     * Set a new uri for a remote prover.
+     *
+     * @param {string} proverUri The uri of the remote prover.
+     *
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a networkClient that connects to the provable explorer api.
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
+     *
+     * // Set the prover uri.
+     * networkClient.setProverUri("https://prover.provable.prove");
+     */
+    setProverUri(proverUri: string): void;
+    /**
+     * Set a new uri for a remote record scanner.
+     *
+     * @param {string} recordScannerUri The uri of the remote record scanner.
+     *
+     * @example
+     * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
+     *
+     * // Create a networkClient that connects to the provable explorer api.
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
+     *
+     * // Set the record scanner uri.
+     * networkClient.setRecordScannerUri("https://scanner.provable.scan");
+     */
+    setRecordScannerUri(recordScannerUri: string): void;
     /**
      * Set verbose errors to true or false for the `AleoNetworkClient`. When set to true, if `submitTransaction` fails, the failure responses will report descriptive information as to why the transaction failed.
      *
@@ -176,7 +211,7 @@ declare class AleoNetworkClient {
      * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * networkClient.setAccount(account);
      *
      * // Find specific amounts
@@ -207,7 +242,7 @@ declare class AleoNetworkClient {
      * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
      *
      * // Create a network client and set an account to search for records with.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * networkClient.setAccount(account);
      *
      * // Find specific amounts
@@ -240,7 +275,7 @@ declare class AleoNetworkClient {
      * @example
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const block = networkClient.getBlockByHash("ab19dklwl9vp63zu3hwg57wyhvmqf92fx5g8x0t6dr72py8r87pxupqfne5t9");
      */
     getBlockByHash(blockHash: string): Promise<BlockJSON>;
@@ -275,7 +310,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/testnet.js";
      *
      * // Get the transaction ID of the deployment transaction for a program.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const transactionId = networkClient.getDeploymentTransactionIDForProgram("hello_hello.aleo");
      *
      * // Get the transaction data for the deployment transaction.
@@ -295,7 +330,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, DeploymentJSON } from "@provablehq/sdk/testnet.js";
      *
      * // Get the transaction ID of the deployment transaction for a program.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const transaction = networkClient.getDeploymentTransactionForProgram("hello_hello.aleo");
      *
      * // Get the verifying keys for each function in the deployment.
@@ -313,7 +348,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/testnet.js";
      *
      * // Get the transaction ID of the deployment transaction for a program.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const transactionId = networkClient.getDeploymentTransactionIDForProgram("hello_hello.aleo");
      *
      * // Get the transaction data for the deployment transaction.
@@ -332,7 +367,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/testnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const latestHeight = networkClient.getLatestBlock();
      */
@@ -346,10 +381,10 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Create a network client and get the latest committee.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const latestCommittee = await networkClient.getLatestCommittee();
      */
     getLatestCommittee(): Promise<object>;
@@ -363,10 +398,10 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Create a network client and get the committee for a specific block.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const committee = await networkClient.getCommitteeByBlockHeight(1234);
      */
     getCommitteeByBlockHeight(blockHeight: number): Promise<object>;
@@ -379,7 +414,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const latestHeight = networkClient.getLatestHeight();
      */
@@ -393,7 +428,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get the latest block hash.
      * const latestHash = networkClient.getLatestBlockHash();
@@ -410,7 +445,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get the source code of a program.)
      * @returns {Promise<string>} Source code of the program
@@ -419,7 +454,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const program = networkClient.getProgram("hello_hello.aleo");
      * const expectedSource = "program hello_hello.aleo;\n\nfunction hello:\n    input r0 as u32.public;\n    input r1 as u32.private;\n    add r0 r1 into r2;\n    output r2 as u32.private;\n"
@@ -436,7 +471,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const programVersion = networkClient.getLatestProgramEdition("hello_hello.aleo");
      * assert.equal(programVersion, 1);
@@ -453,7 +488,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const programID = "hello_hello.aleo";
      * const programSource = "program hello_hello.aleo;\n\nfunction hello:\n    input r0 as u32.public;\n    input r1 as u32.private;\n    add r0 r1 into r2;\n    output r2 as u32.private;\n"
@@ -482,7 +517,7 @@ declare class AleoNetworkClient {
      * }
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Imports can be fetched using the program ID, source code, or program object
      * let programImports = await networkClient.getProgramImports("double_test.aleo");
@@ -507,7 +542,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const programImportsNames = networkClient.getProgramImports("wrapped_credits.aleo");
      * const expectedImportsNames = ["credits.aleo"];
@@ -524,7 +559,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const mappings = networkClient.getProgramMappingNames("credits.aleo");
      * const expectedMappings = [
@@ -551,7 +586,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get public balance of an account
      * const mappingValue = networkClient.getMappingValue("credits.aleo", "account", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px");
@@ -571,7 +606,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get the bond state as an account.
      * const unbondedState = networkClient.getMappingPlaintext("credits.aleo", "bonded", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px");
@@ -604,7 +639,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get the balance of an account from either an address object or address string.
      * const account = Account.fromCiphertext(process.env.ciphertext, process.env.password);
@@ -622,7 +657,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get the latest state root.
      * const stateRoot = networkClient.getStateRoot();
@@ -638,7 +673,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const transaction = networkClient.getTransaction("at1handz9xjrqeynjrr0xay4pcsgtnczdksz3e584vfsgaz0dh0lyxq43a4wj");
      */
@@ -653,7 +688,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const transaction = networkClient.getConfirmedTransaction("at1handz9xjrqeynjrr0xay4pcsgtnczdksz3e584vfsgaz0dh0lyxq43a4wj");
      * assert.equal(transaction.status, "confirmed");
@@ -695,7 +730,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const transactions = networkClient.getTransactions(654);
      */
@@ -710,7 +745,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * const transactions = networkClient.getTransactionsByBlockHash("ab19dklwl9vp63zu3hwg57wyhvmqf92fx5g8x0t6dr72py8r87pxupqfne5t9");
      */
@@ -724,7 +759,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      *
      * // Get the current transactions in the mempool.
      * const transactions = networkClient.getTransactionsInMempool();
@@ -762,12 +797,23 @@ declare class AleoNetworkClient {
      */
     private refreshJwt;
     /**
-     * Submit a `ProvingRequest` to a remote proving service for delegated proving. If the broadcast flag of the `ProvingRequest` is set to `true` the remote service will attempt to broadcast the result `Transaction` on behalf of the requestor.
+     * Parses a /prove or /prove/encrypted response. Returns a result object (never throws for 200/400/500/503).
+     */
+    private handleProvingResponse;
+    /**
+     * Submit a `ProvingRequest` to a remote proving service for delegated proving. If the broadcast flag of the `ProvingRequest` is set to `true` the remote service will attempt to broadcast the result `Transaction` on behalf of the requestor. Throws on HTTP 400, 500, 503 (and retries on 500/503). Callers should {@link submitProvingRequestSafe} to handle proving request failures without throwing.
      *
      * @param {DelegatedProvingParams} options - The optional parameters required to submit a proving request.
      * @returns {Promise<ProvingResponse>} The ProvingResponse containing the transaction result and the result of the broadcast if the `broadcast` flag was set to `true`.
      */
     submitProvingRequest(options: DelegatedProvingParams): Promise<ProvingResponse>;
+    /**
+     * Submit a proving request and return a result object instead of throwing. This method is usable when callers want to handle HTTP status (400, 500, 503) yourself. Retries on 500/503 and returns on 200 or 400.
+     *
+     * @param {DelegatedProvingParams} options - The optional parameters required to submit a proving request.
+     * @returns {Promise<ProvingResult>} `{ ok: true, data }` on success (200), or `{ ok: false, status, error }` on 400/500/503. Check `result.ok` and then either `result.data` or `result.status` / `result.error.message`.
+     */
+    submitProvingRequestSafe(options: DelegatedProvingParams): Promise<ProvingResult>;
     /**
      * Await a submitted transaction to be confirmed or rejected on the Aleo network.
      *
@@ -780,7 +826,7 @@ declare class AleoNetworkClient {
      * import { AleoNetworkClient, Account, ProgramManager } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a network client and program manager.
-     * const networkClient = new AleoNetworkClient("http://api.explorer.provable.com/v1", undefined);
+     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2", undefined);
      * const programManager = new ProgramManager(networkClient);
      *
      * // Set the account for the program manager.

package/dist/mainnet/node.d.ts

@@ -1,3 +1,2 @@
 import "./node-polyfill.js";
-export { LocalFileKeyStore } from "./keys/keystore/file.js";
 export * from "./browser.js";

package/dist/mainnet/node.js

@@ -1,9 +1,6 @@
 import './node-polyfill.js';
-import * as fs from 'node:fs/promises';
-import * as path from 'path';
-import { ProvingKey, VerifyingKey } from '@provablehq/wasm/mainnet.js';
+export { Account, AleoKeyProvider, AleoKeyProviderParams, AleoNetworkClient, BlockHeightSearch, CREDITS_PROGRAM_KEYS, DecryptionNotEnabledError, KEY_STORE, NetworkRecordProvider, OfflineKeyProvider, OfflineSearchParams, PRIVATE_TO_PUBLIC_TRANSFER, PRIVATE_TRANSFER, PRIVATE_TRANSFER_TYPES, PUBLIC_TO_PRIVATE_TRANSFER, PUBLIC_TRANSFER, PUBLIC_TRANSFER_AS_SIGNER, ProgramManager, RECORD_DOMAIN, RecordNotFoundError, RecordScanner, RecordScannerRequestError, SealanceMerkleTree, UUIDError, VALID_TRANSFER_TYPES, ViewKeyNotStoredError, encryptAuthorization, encryptProvingRequest, encryptRegistrationRequest, encryptViewKey, initializeWasm, isProveApiErrorBody, isProvingResponse, logAndThrow } from './browser.js';
 export { Address, Authorization, BHP1024, BHP256, BHP512, BHP768, Boolean, Ciphertext, ComputeKey, EncryptionToolkit, ExecutionRequest, ExecutionResponse, Field, Execution as FunctionExecution, GraphKey, Group, I128, I16, I32, I64, I8, OfflineQuery, Pedersen128, Pedersen64, Plaintext, Poseidon2, Poseidon4, Poseidon8, PrivateKey, PrivateKeyCiphertext, Program, ProgramManager as ProgramManagerBase, ProvingKey, ProvingRequest, RecordCiphertext, RecordPlaintext, Scalar, Signature, Transaction, Transition, U128, U16, U32, U64, U8, VerifyingKey, ViewKey, getOrInitConsensusVersionTestHeights, initThreadPool, verifyFunctionExecution } from '@provablehq/wasm/mainnet.js';
-export { Account, AleoKeyProvider, AleoKeyProviderParams, AleoNetworkClient, BlockHeightSearch, CREDITS_PROGRAM_KEYS, KEY_STORE, NetworkRecordProvider, OfflineKeyProvider, OfflineSearchParams, PRIVATE_TO_PUBLIC_TRANSFER, PRIVATE_TRANSFER, PRIVATE_TRANSFER_TYPES, PUBLIC_TO_PRIVATE_TRANSFER, PUBLIC_TRANSFER, PUBLIC_TRANSFER_AS_SIGNER, ProgramManager, RECORD_DOMAIN, RecordScanner, SealanceMerkleTree, VALID_TRANSFER_TYPES, initializeWasm, logAndThrow, promoteMapToKeyStore } from './browser.js';
 import 'core-js/proposals/json-parse-with-source.js';
 import 'node:crypto';
 import 'node:fs';
@@ -11,130 +8,6 @@ import 'mime/lite';
 import 'xmlhttprequest-ssl';
 import 'node:worker_threads';
 import 'node:os';
+import 'libsodium-wrappers';
 import '@scure/base';
-
-class LocalFileKeyStore {
-    directory;
-    constructor(directory) {
-        this.directory = directory ?? path.join(process.cwd(), "keystore");
-        // Ensure directory exists
-        fs.mkdir(this.directory, { recursive: true }).catch((err) => {
-            console.error("Failed to create keystore directory:", err);
-        });
-    }
-    proverPath(locator) {
-        return path.join(this.directory, `${locator}.prover`);
-    }
-    verifierPath(locator) {
-        return path.join(this.directory, `${locator}.verifier`);
-    }
-    async readFileOptional(filepath) {
-        try {
-            const data = await fs.readFile(filepath);
-            return new Uint8Array(data);
-        }
-        catch (err) {
-            if (err.code === "ENOENT")
-                return null;
-            throw err;
-        }
-    }
-    async writeFileAtomic(filepath, data) {
-        // Ensure parent directories for nested locators exist
-        await fs.mkdir(path.dirname(filepath), { recursive: true });
-        await fs.writeFile(filepath, data);
-    }
-    async clearRecursive(dir) {
-        let entries;
-        try {
-            entries = await fs.readdir(dir);
-        }
-        catch (err) {
-            if (err.code === "ENOENT") {
-                return;
-            }
-            throw err;
-        }
-        await Promise.all(entries.map(async (name) => {
-            const full = path.join(dir, name);
-            let isDirectory = false;
-            try {
-                const stat = await fs.stat(full);
-                isDirectory = stat.isDirectory();
-            }
-            catch {
-                return;
-            }
-            if (isDirectory) {
-                await this.clearRecursive(full);
-            }
-            else if (name.endsWith(".prover") || name.endsWith(".verifier")) {
-                await fs.unlink(full).catch(() => { });
-            }
-        }));
-    }
-    // -------------------------------------------------------
-    // KEYSTORE INTERFACE
-    // -------------------------------------------------------
-    async getKeys(locator) {
-        const prover = await this.getProvingKey(locator);
-        const verifier = await this.getVerifyingKey(locator);
-        if (!prover || !verifier)
-            return null;
-        return [prover, verifier];
-    }
-    async getKeyBytes(locator) {
-        const prover = await this.getProvingKeyBytes(locator);
-        const verifier = await this.getVerifyingKeyBytes(locator);
-        if (!prover || !verifier)
-            return null;
-        return [prover, verifier];
-    }
-    async getProvingKey(locator) {
-        const bytes = await this.getProvingKeyBytes(locator);
-        return bytes ? ProvingKey.fromBytes(bytes) : null;
-    }
-    async getProvingKeyBytes(locator) {
-        return this.readFileOptional(this.proverPath(locator));
-    }
-    async getVerifyingKey(locator) {
-        const bytes = await this.getVerifyingKeyBytes(locator);
-        return bytes ? VerifyingKey.fromBytes(bytes) : null;
-    }
-    async getVerifyingKeyBytes(locator) {
-        return this.readFileOptional(this.verifierPath(locator));
-    }
-    async setKeys(locator, keys) {
-        const [p, v] = keys;
-        await this.writeFileAtomic(this.proverPath(locator), p.toBytes());
-        await this.writeFileAtomic(this.verifierPath(locator), v.toBytes());
-    }
-    async setKeyBytes(locator, keys) {
-        const [proverBytes, verifierBytes] = keys;
-        await this.writeFileAtomic(this.proverPath(locator), proverBytes);
-        await this.writeFileAtomic(this.verifierPath(locator), verifierBytes);
-    }
-    async has(locator) {
-        const proverExists = await fs
-            .access(this.proverPath(locator))
-            .then(() => true)
-            .catch(() => false);
-        const verifierExists = await fs
-            .access(this.verifierPath(locator))
-            .then(() => true)
-            .catch(() => false);
-        return proverExists && verifierExists;
-    }
-    async delete(locator) {
-        const p = this.proverPath(locator);
-        const v = this.verifierPath(locator);
-        await fs.unlink(p).catch(() => { });
-        await fs.unlink(v).catch(() => { });
-    }
-    async clear() {
-        await this.clearRecursive(this.directory);
-    }
-}
-
-export { LocalFileKeyStore };
 //# sourceMappingURL=node.js.map

package/dist/mainnet/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sources":["../../src/keys/keystore/file.ts"],"sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as path from \"path\";\n\nimport { CachedKeyPair, FunctionKeyPair } from \"../../models/keyPair.js\";\nimport { KeyStore } from \"./keystore.js\";\nimport { ProvingKey, VerifyingKey } from \"../../wasm.js\";\n\nexport class LocalFileKeyStore implements KeyStore {\n\n    private directory: string;\n\n    constructor(directory?: string) {\n        this.directory = directory ?? path.join(process.cwd(), \"keystore\");\n\n        // Ensure directory exists\n        fs.mkdir(this.directory, { recursive: true }).catch((err) => {\n            console.error(\"Failed to create keystore directory:\", err);\n        });\n    }\n\n    private proverPath(locator: string): string {\n        return path.join(this.directory, `${locator}.prover`);\n    }\n\n    private verifierPath(locator: string): string {\n        return path.join(this.directory, `${locator}.verifier`);\n    }\n\n    private async readFileOptional(filepath: string): Promise<Uint8Array | null> {\n        try {\n            const data = await fs.readFile(filepath);\n            return new Uint8Array(data);\n        } catch (err: any) {\n            if (err.code === \"ENOENT\") return null;\n            throw err;\n        }\n    }\n\n    private async writeFileAtomic(filepath: string, data: Uint8Array): Promise<void> {\n        // Ensure parent directories for nested locators exist\n        await fs.mkdir(path.dirname(filepath), { recursive: true });\n        await fs.writeFile(filepath, data);\n    }\n\n    private async clearRecursive(dir: string): Promise<void> {\n        let entries: string[];\n        try {\n            entries = await fs.readdir(dir);\n        } catch (err: any) {\n            if (err.code === \"ENOENT\") {\n                return;\n            }\n            throw err;\n        }\n\n        await Promise.all(entries.map(async (name) => {\n            const full = path.join(dir, name);\n            let isDirectory = false;\n            try {\n                const stat = await fs.stat(full);\n                isDirectory = stat.isDirectory();\n            } catch {\n                return;\n            }\n\n            if (isDirectory) {\n                await this.clearRecursive(full);\n            } else if (name.endsWith(\".prover\") || name.endsWith(\".verifier\")) {\n                await fs.unlink(full).catch(() => {});\n            }\n        }));\n    }\n\n    // -------------------------------------------------------\n    // KEYSTORE INTERFACE\n    // -------------------------------------------------------\n\n    async getKeys(locator: string): Promise<FunctionKeyPair | null> {\n        const prover = await this.getProvingKey(locator);\n        const verifier = await this.getVerifyingKey(locator);\n        if (!prover || !verifier) return null;\n        return [prover, verifier];\n    }\n\n    async getKeyBytes(locator: string): Promise<CachedKeyPair | null> {\n        const prover = await this.getProvingKeyBytes(locator);\n        const verifier = await this.getVerifyingKeyBytes(locator);\n        if (!prover || !verifier) return null;\n        return [prover, verifier];\n    }\n\n    async getProvingKey(locator: string): Promise<ProvingKey | null> {\n        const bytes = await this.getProvingKeyBytes(locator);\n        return bytes ? ProvingKey.fromBytes(bytes) : null;\n    }\n\n    async getProvingKeyBytes(locator: string): Promise<Uint8Array | null> {\n        return this.readFileOptional(this.proverPath(locator));\n    }\n\n    async getVerifyingKey(locator: string): Promise<VerifyingKey | null> {\n        const bytes = await this.getVerifyingKeyBytes(locator);\n        return bytes ? VerifyingKey.fromBytes(bytes) : null;\n    }\n\n    async getVerifyingKeyBytes(locator: string): Promise<Uint8Array | null> {\n        return this.readFileOptional(this.verifierPath(locator));\n    }\n\n    async setKeys(locator: string, keys: FunctionKeyPair): Promise<void> {\n        const [p, v] = keys;\n        await this.writeFileAtomic(this.proverPath(locator), p.toBytes());\n        await this.writeFileAtomic(this.verifierPath(locator), v.toBytes());\n    }\n\n    async setKeyBytes(locator: string, keys: CachedKeyPair): Promise<void> {\n        const [proverBytes, verifierBytes] = keys;\n        await this.writeFileAtomic(this.proverPath(locator), proverBytes);\n        await this.writeFileAtomic(this.verifierPath(locator), verifierBytes);\n    }\n\n    async has(locator: string): Promise<boolean> {\n        const proverExists = await fs\n            .access(this.proverPath(locator))\n            .then(() => true)\n            .catch(() => false);\n\n        const verifierExists = await fs\n            .access(this.verifierPath(locator))\n            .then(() => true)\n            .catch(() => false);\n\n        return proverExists && verifierExists;\n    }\n\n    async delete(locator: string): Promise<void> {\n        const p = this.proverPath(locator);\n        const v = this.verifierPath(locator);\n\n        await fs.unlink(p).catch(() => {});\n        await fs.unlink(v).catch(() => {});\n    }\n\n    async clear(): Promise<void> {\n        await this.clearRecursive(this.directory);\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"node.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/mainnet/{keys/provider/offline-key-provider.d.ts → offline-key-provider.d.ts}

@@ -1,7 +1,5 @@
-import { FunctionKeyProvider, KeySearchParams } from "./function-key-provider.js";
-import { CachedKeyPair, FunctionKeyPair } from "../../models/keyPair.js";
-import { ProvingKey, VerifyingKey } from "../../wasm.js";
-import { KeyStore } from "../keystore/keystore.js";
+import { CachedKeyPair, FunctionKeyPair, FunctionKeyProvider, KeySearchParams } from "./function-key-provider.js";
+import { ProvingKey, VerifyingKey } from "./wasm.js";
 /**
  * Search parameters for the offline key provider. This class implements the KeySearchParams interface and includes
  * a convenience method for creating a new instance of this class for each function of the credits.aleo program.
@@ -134,13 +132,12 @@ declare class OfflineSearchParams implements KeySearchParams {
  * const offlineExecuteTx = <Transaction>await this.buildExecutionTransaction("hello_hello.aleo", "hello", 1, false, ["5u32", "5u32"], undefined, offlineSearchParams, undefined, undefined, undefined, undefined, offlineQuery, program);
  *
  * // Broadcast the transaction later on a machine with internet access
- * const networkClient = new AleoNetworkClient("https://api.explorer.provable.com/v1");
+ * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
  * const txId = await networkClient.broadcastTransaction(offlineExecuteTx);
  */
 declare class OfflineKeyProvider implements FunctionKeyProvider {
     cache: Map<string, CachedKeyPair>;
     constructor();
-    keyStore(): Promise<KeyStore | undefined>;
     /**
      * Get bond_public function keys from the credits.aleo program. The keys must be cached prior to calling this
      * method for it to work.