@provablehq/sdk 0.11.8 → 0.11.10

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

@@ -89,12 +89,53 @@ interface PrepareProgramOptions {
     programImports?: ProgramImports;
     edition?: number;
 }
+/**
+ * A program to load into a reusable {@link PreparedProcess}.
+ *
+ * @property programName Program name (e.g. "credits.aleo").
+ * @property programSource Optional source. When omitted, it is fetched from
+ *   the network.
+ * @property edition Optional edition. When omitted, the current on-chain
+ *   edition is resolved.
+ */
+interface ProgramPreparationOptions {
+    programName: string;
+    programSource?: string | Program;
+    edition?: number;
+}
+/**
+ * Options for preparing one snarkVM process that can serve multiple programs
+ * and functions.
+ *
+ * `programImports` may contain a superset of dynamic-dispatch targets. Calls
+ * can later provide and use any matching subset without rebuilding the
+ * process.
+ */
+interface PrepareProcessOptions {
+    programs: ProgramPreparationOptions[];
+    programImports?: ProgramImports;
+}
+/** Metadata for a program loaded into a {@link PreparedProcess}. */
+interface PreparedProcessProgram {
+    readonly programName: string;
+    readonly programSource: string;
+    readonly edition: number;
+    readonly functions: readonly string[];
+}
+/** Options accepted by {@link PreparedProcess.supports}. */
+interface PreparedProcessSupportsOptions {
+    programName: string;
+    functionName?: string;
+    programSource?: string | Program;
+    programImports?: ProgramImports;
+    edition?: number;
+}
 /**
  * A reusable program context created by {@link ProgramManager.prepareProgram}.
  *
- * The context is scoped to one program function. Calls using it must be
- * sequential. The caller owns the context and should call {@link free} when it
- * is no longer needed.
+ * The context is scoped to one program function. Concurrent calls sharing it
+ * are serialized at the WASM boundary. The caller owns the context and should
+ * call {@link free} when it is no longer needed.
  */
 declare class PreparedProgram {
     readonly programName: string;
@@ -110,6 +151,29 @@ declare class PreparedProgram {
      */
     free(): void;
 }
+/**
+ * A reusable snarkVM process created by {@link ProgramManager.prepareProcess}.
+ *
+ * Unlike {@link PreparedProgram}, a prepared process can authorize any
+ * function in any loaded program. Extra loaded programs remain idle when a
+ * call only needs a subset. Concurrent calls sharing the process are
+ * serialized at the WASM boundary.
+ */
+declare class PreparedProcess {
+    readonly programs: readonly PreparedProcessProgram[];
+    /** Instances are normally created through {@link ProgramManager.prepareProcess}. */
+    constructor(programs: readonly PreparedProcessProgram[]);
+    /** Names of all programs loaded into this process. */
+    get programNames(): readonly string[];
+    /**
+     * Check whether the process can serve a call without network resolution or
+     * process rebuilding. Caller-provided imports may be a subset of the
+     * programs loaded into the process.
+     */
+    supports(options: PreparedProcessSupportsOptions): boolean;
+    /** Release the prepared snarkVM process. This method is idempotent. */
+    free(): void;
+}
 /**
  * Options for building an Authorization for a function.
  *
@@ -121,6 +185,7 @@ declare class PreparedProgram {
  * @property {ProgramImports} [programImports] The other programs the program imports.
  * @property {edition} [edition]
  * @property {PreparedProgram} [preparedProgram] A reusable context returned by ProgramManager.prepareProgram.
+ * @property {PreparedProcess} [preparedProcess] A multi-program context returned by ProgramManager.prepareProcess.
  */
 interface AuthorizationOptions {
     programName: string;
@@ -131,6 +196,7 @@ interface AuthorizationOptions {
     programImports?: ProgramImports;
     edition?: number;
     preparedProgram?: PreparedProgram;
+    preparedProcess?: PreparedProcess;
 }
 /**
  * Options for executing a fee authorization.
@@ -193,6 +259,7 @@ interface ExecuteAuthorizationOptions {
  * @property {number} [edition] - Edition of the program to execute the function in.
  * @property {boolean} [useFeeMaster] - Whether to use the FeeMaster account to execute the transaction.
  * @property {PreparedProgram} [preparedProgram] - A reusable context returned by ProgramManager.prepareProgram.
+ * @property {PreparedProcess} [preparedProcess] - A reusable multi-program context returned by ProgramManager.prepareProcess.
  */
 interface ProvingRequestOptions {
     programName: string;
@@ -212,6 +279,7 @@ interface ProvingRequestOptions {
     useFeeMaster?: boolean;
     executionRequest?: ExecutionRequest;
     preparedProgram?: PreparedProgram;
+    preparedProcess?: PreparedProcess;
 }
 /**
  * Fee estimate options.
@@ -349,7 +417,36 @@ declare class ProgramManager {
      * }
      */
     prepareProgram(options: PrepareProgramOptions): Promise<PreparedProgram>;
+    /**
+     * Prepare one reusable snarkVM process for multiple programs and functions.
+     *
+     * Sources, editions, and transitive imports are resolved once. Every
+     * loaded program can later be used as an entry program, and an invocation
+     * may supply any matching subset of the preloaded imports.
+     *
+     * @example
+     * const prepared = await programManager.prepareProcess({
+     *     programs: [
+     *         { programName: "wallet_router.aleo" },
+     *         { programName: "token_registry.aleo" },
+     *     ],
+     *     programImports: dynamicDispatchTargets,
+     * });
+     * try {
+     *     const authorization = await programManager.buildAuthorizationUnchecked({
+     *         programName: "wallet_router.aleo",
+     *         functionName: "transfer",
+     *         inputs,
+     *         preparedProcess: prepared,
+     *     });
+     * } finally {
+     *     prepared.free();
+     * }
+     */
+    prepareProcess(options: PrepareProcessOptions): Promise<PreparedProcess>;
     private validatePreparedProgram;
+    private validatePreparedProcess;
+    private preparedCallContext;
     /**
      * Collect static imports declared by the entry program together with any
      * caller-provided imports, then resolve missing transitive dependencies.
@@ -417,7 +514,7 @@ declare class ProgramManager {
      * import { ProgramManager } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a ProgramManager
-     * const programManager = new ProgramManager("https://api.provable.com/v2");
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2");
      *
      * // Set the value of the `Accept-Language` header to `en-US`
      * programManager.setHeader('Accept-Language', 'en-US');
@@ -436,7 +533,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a ProgramManager
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider);
      *
      * // Set the inclusion keys.
      * programManager.setInclusionProver();
@@ -451,7 +548,7 @@ declare class ProgramManager {
      * import { ProgramManager } from "@provablehq/sdk/mainnet.js";
      *
      * // Create a ProgramManager
-     * const programManager = new ProgramManager("https://api.provable.com/v2");
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2");
      *
      * // Remove the default `X-Aleo-SDK-Version` header
      * programManager.removeHeader('X-Aleo-SDK-Version');
@@ -479,7 +576,7 @@ declare class ProgramManager {
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for deployments
      * const program = "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";
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.setAccount(Account);
      *
      * // Define a fee in credits
@@ -512,7 +609,7 @@ declare class ProgramManager {
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for deployments
      * const program = "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";
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.setAccount(Account);
      *
      * // Define a fee in credits
@@ -551,7 +648,7 @@ declare class ProgramManager {
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for deployments
      * const program = "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";
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Define a fee in credits
      * const priorityFee = 0.0;
@@ -582,7 +679,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Build and execute the transaction
      * const tx = await programManager.buildExecutionTransaction({
@@ -622,7 +719,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider);
      *
      * // Build the `Authorization`.
      * const privateKey = new PrivateKey(); // Change this to a private key that has an aleo credit balance.
@@ -691,7 +788,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a ProgramManager with the key and record providers.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Build the `Authorization`.
      * const authorization = await programManager.buildAuthorization({
@@ -720,7 +817,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a ProgramManager with the key and record providers.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Build the unchecked `Authorization`.
      * const authorization = await programManager.buildAuthorizationUnchecked({
@@ -749,7 +846,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a ProgramManager with the key and record providers.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Build the proving request.
      * const provingRequest = await programManager.provingRequest({
@@ -781,7 +878,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a ProgramManager with the key and record providers.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Build a credits.aleo/fee_public `Authorization`.
      * const feePublicAuthorization = await programManager.buildFeeAuthorization({
@@ -814,7 +911,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      *
      * // Build and execute the transaction
      * const tx_id = await programManager.execute({
@@ -907,7 +1004,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * const record_1 = "{  owner: aleo184vuwr5u7u0ha5f5k44067dd2uaqewxx6pe5ltha5pv99wvhfqxqv339h4.private,  microcredits: 45000000u64.private,  _nonce: 4106205762862305308495708971985748592380064201230396559307556388725936304984group.public}"
      * const record_2 = "{  owner: aleo184vuwr5u7u0ha5f5k44067dd2uaqewxx6pe5ltha5pv99wvhfqxqv339h4.private,  microcredits: 45000000u64.private,  _nonce: 1540945439182663264862696551825005342995406165131907382295858612069623286213group.public}"
      * const tx_id = await programManager.join(record_1, record_2, 0.05, false);
@@ -938,7 +1035,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * const record = "{  owner: aleo184vuwr5u7u0ha5f5k44067dd2uaqewxx6pe5ltha5pv99wvhfqxqv339h4.private,  microcredits: 45000000u64.private,  _nonce: 4106205762862305308495708971985748592380064201230396559307556388725936304984group.public}"
      * const tx_id = await programManager.split(25000000, record);
      *
@@ -985,7 +1082,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * const tx = await programManager.buildTransferTransaction(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "public", 0.2, false);
      * await programManager.networkClient.submitTransaction(tx.toString());
      *
@@ -1016,7 +1113,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * const tx = await programManager.buildTransferPublicTransaction(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", 0.2);
      * await programManager.networkClient.submitTransaction(tx.toString());
      *
@@ -1047,7 +1144,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * const tx = await programManager.buildTransferPublicAsSignerTransaction(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", 0.2);
      * await programManager.networkClient.submitTransaction(tx.toString());
      *
@@ -1083,7 +1180,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * const tx_id = await programManager.transfer(1, "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "public", 0.2, false);
      *
      * // Verify the transaction was successful
@@ -1111,7 +1208,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
      * // Create the bonding transaction object for later submission
@@ -1145,7 +1242,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      *
      * // Create the bonding transaction
      * tx_id = await programManager.bondPublic("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", "aleo1rhgdu77hgyqd3xjj8ucu3jj9r2krwz6mnzyd80gncr5fxcwlh5rsvzp9px", "aleo1feya8sjy9k2zflvl2dx39pdsq5tju28elnp2ektnn588uu9ghv8s84msv9", 2000000);
@@ -1176,7 +1273,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
      * // Create the bond validator transaction object for later use.
@@ -1211,7 +1308,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
      * // Create the bonding transaction
@@ -1241,7 +1338,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to unbond credits.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      * const tx = await programManager.buildUnbondPublicTransaction("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j", 2000000);
      *
      * // The transaction can be submitted later to the network using the network client.
@@ -1276,7 +1373,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
      * // Create the unbond_public transaction and send it to the network
@@ -1305,7 +1402,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to claim unbonded credits.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      *
      * // Create the claim_unbond_public transaction object for later use.
      * const tx = await programManager.buildClaimUnbondPublicTransaction("aleo1jx8s4dvjepculny4wfrzwyhs3tlyv65r58ns3g6q2gm2esh7ps8sqy9s5j");
@@ -1337,7 +1434,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      * programManager.setAccount(new Account("YourPrivateKey"));
      *
      * // Create the claim_unbond_public transaction
@@ -1374,7 +1471,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      *
      * // Create the set_validator_state transaction
      * const tx = await programManager.buildSetValidatorStateTransaction(true);
@@ -1413,7 +1510,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Create a new ProgramManager with the key that will be used to bond credits
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, undefined);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, undefined);
      *
      * // Create the set_validator_state transaction
      * const tx_id = await programManager.setValidatorState(true);
@@ -1494,7 +1591,7 @@ declare class ProgramManager {
      * keyProvider.useCache(true);
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider);
      *
      * // Build the `Authorization`.
      * const privateKey = new PrivateKey(); // Change this to a private key that has an aleo credit balance.
@@ -1543,7 +1640,7 @@ declare class ProgramManager {
      * import { AleoKeyProvider, PrivateKey, initThreadPool, ProgramManager } from "@provablehq/sdk";
      *
      * // Initialize a program manager with the key provider to automatically fetch keys for executions.
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider);
      *
      * // Get the base fee in microcredits.
      * const baseFeeMicrocredits = await programManager.estimateExecutionFee({programName: "credits.aleo"});
@@ -1756,4 +1853,4 @@ declare function verifyBatchProof(options: BatchVerificationOptions): boolean;
  * const checksum = programChecksum("program foo.aleo; ...");
  */
 declare function programChecksum(program: string | Program): Uint8Array;
-export { ProgramManager, PreparedProgram, PrepareProgramOptions, AuthorizationOptions, FeeAuthorizationOptions, ExecuteOptions, ProvingRequestOptions, ExternalSigningOptions, VerificationOptions, BatchVerificationOptions, inputsToFields, verifyProof, verifyBatchProof, programChecksum };
+export { ProgramManager, PreparedProgram, PreparedProcess, PrepareProgramOptions, ProgramPreparationOptions, PrepareProcessOptions, PreparedProcessProgram, PreparedProcessSupportsOptions, AuthorizationOptions, FeeAuthorizationOptions, ExecuteOptions, ProvingRequestOptions, ExternalSigningOptions, VerificationOptions, BatchVerificationOptions, inputsToFields, verifyProof, verifyBatchProof, programChecksum };

package/dist/testnet/record-provider.d.cts

@@ -54,7 +54,7 @@ interface RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      */
     findCreditsRecord(microcredits: number, searchParameters: RecordSearchParams): Promise<OwnedRecord>;
@@ -77,7 +77,7 @@ interface RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      */
     findCreditsRecords(microcreditAmounts: number[], searchParameters: RecordSearchParams): Promise<OwnedRecord[]>;
@@ -191,7 +191,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * @example
      * // Create a new NetworkRecordProvider
-     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
+     * const networkClient = new AleoNetworkClient("https://edge.provable.com/api/v2");
      * const keyProvider = new AleoKeyProvider();
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
      *
@@ -204,7 +204,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      *
      * */
@@ -218,7 +218,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * @example
      * // Create a new NetworkRecordProvider
-     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
+     * const networkClient = new AleoNetworkClient("https://edge.provable.com/api/v2");
      * const keyProvider = new AleoKeyProvider();
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
      *
@@ -231,7 +231,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      */
     findCreditsRecord(microcredits: number, searchParameters: RecordSearchParams): Promise<OwnedRecord>;
@@ -256,7 +256,7 @@ declare class NetworkRecordProvider implements RecordProvider {
  * const params = new BlockHeightSearch(89995, 99995);
  *
  * // Create a new NetworkRecordProvider
- * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
+ * const networkClient = new AleoNetworkClient("https://edge.provable.com/api/v2");
  * const keyProvider = new AleoKeyProvider();
  * const recordProvider = new NetworkRecordProvider(account, networkClient);
  *

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

@@ -54,7 +54,7 @@ interface RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      */
     findCreditsRecord(microcredits: number, searchParameters: RecordSearchParams): Promise<OwnedRecord>;
@@ -77,7 +77,7 @@ interface RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      */
     findCreditsRecords(microcreditAmounts: number[], searchParameters: RecordSearchParams): Promise<OwnedRecord[]>;
@@ -191,7 +191,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * @example
      * // Create a new NetworkRecordProvider
-     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
+     * const networkClient = new AleoNetworkClient("https://edge.provable.com/api/v2");
      * const keyProvider = new AleoKeyProvider();
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
      *
@@ -204,7 +204,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      *
      * */
@@ -218,7 +218,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * @example
      * // Create a new NetworkRecordProvider
-     * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
+     * const networkClient = new AleoNetworkClient("https://edge.provable.com/api/v2");
      * const keyProvider = new AleoKeyProvider();
      * const recordProvider = new NetworkRecordProvider(account, networkClient);
      *
@@ -231,7 +231,7 @@ declare class NetworkRecordProvider implements RecordProvider {
      *
      * // When the program manager is initialized with the record provider it will be used to find automatically find
      * // fee records and amount records for value transfers so that they do not need to be specified manually
-     * const programManager = new ProgramManager("https://api.provable.com/v2", keyProvider, recordProvider);
+     * const programManager = new ProgramManager("https://edge.provable.com/api/v2", keyProvider, recordProvider);
      * programManager.transfer(1, "aleo166q6ww6688cug7qxwe7nhctjpymydwzy2h7rscfmatqmfwnjvggqcad0at", "public", 0.5);
      */
     findCreditsRecord(microcredits: number, searchParameters: RecordSearchParams): Promise<OwnedRecord>;
@@ -256,7 +256,7 @@ declare class NetworkRecordProvider implements RecordProvider {
  * const params = new BlockHeightSearch(89995, 99995);
  *
  * // Create a new NetworkRecordProvider
- * const networkClient = new AleoNetworkClient("https://api.provable.com/v2");
+ * const networkClient = new AleoNetworkClient("https://edge.provable.com/api/v2");
  * const keyProvider = new AleoKeyProvider();
  * const recordProvider = new NetworkRecordProvider(account, networkClient);
  *

package/dist/testnet/record-scanner.d.cts

@@ -29,9 +29,9 @@ export interface RecordScannerJWTData {
  * Configuration for the record scanner.
  *
  * @property {string} url Base URL of the record scanning service (network path is appended by the SDK).
- * @property {ApiAuthConfig} [auth] Explicit auth mode: `jwt` (api.provable.com), `api-key` (edge.provable.com), or `none`. Wins over the legacy fields below, which cannot be combined with it.
- * @property {string | { header: string, value: string }} [apiKey] Legacy: API key as a string (JWT auth) or as a custom header name and value (keyed auth).
- * @property {string} [consumerId] Legacy: required for JWT refresh when using authenticated record scanner (e.g. Provable API).
+ * @property {ApiAuthConfig} [auth] Explicit auth mode. edge.provable.com/api is unauthenticated and never uses JWTs: use `none` (default) or `api-key` with an optional provisioned key. `jwt` is for the legacy api.provable.com gateway. Wins over the legacy fields below, which cannot be combined with it.
+ * @property {string | { header: string, value: string }} [apiKey] Legacy: API key as a string (sent as `X-API-Key` on its own, or used to mint a JWT when paired with `consumerId`) or as a custom header name and value (keyed auth).
+ * @property {string} [consumerId] Legacy: pairs with a string `apiKey` to mint JWTs against api.provable.com. Do not set it for edge.provable.com, which has no JWT route.
  * @property {RecordScannerJWTData} [jwtData] Legacy: optional JWT for auth. If omitted and apiKey + consumerId are set, JWT is refreshed when needed.
  * @property {ViewKey[]} [viewKeys] Optional view keys to use for local scanning and decryption.
  * @property {Account} [account] Optional account to use for local scanning and decryption.

package/dist/testnet/record-scanner.d.ts

@@ -29,9 +29,9 @@ export interface RecordScannerJWTData {
  * Configuration for the record scanner.
  *
  * @property {string} url Base URL of the record scanning service (network path is appended by the SDK).
- * @property {ApiAuthConfig} [auth] Explicit auth mode: `jwt` (api.provable.com), `api-key` (edge.provable.com), or `none`. Wins over the legacy fields below, which cannot be combined with it.
- * @property {string | { header: string, value: string }} [apiKey] Legacy: API key as a string (JWT auth) or as a custom header name and value (keyed auth).
- * @property {string} [consumerId] Legacy: required for JWT refresh when using authenticated record scanner (e.g. Provable API).
+ * @property {ApiAuthConfig} [auth] Explicit auth mode. edge.provable.com/api is unauthenticated and never uses JWTs: use `none` (default) or `api-key` with an optional provisioned key. `jwt` is for the legacy api.provable.com gateway. Wins over the legacy fields below, which cannot be combined with it.
+ * @property {string | { header: string, value: string }} [apiKey] Legacy: API key as a string (sent as `X-API-Key` on its own, or used to mint a JWT when paired with `consumerId`) or as a custom header name and value (keyed auth).
+ * @property {string} [consumerId] Legacy: pairs with a string `apiKey` to mint JWTs against api.provable.com. Do not set it for edge.provable.com, which has no JWT route.
  * @property {RecordScannerJWTData} [jwtData] Legacy: optional JWT for auth. If omitted and apiKey + consumerId are set, JWT is refreshed when needed.
  * @property {ViewKey[]} [viewKeys] Optional view keys to use for local scanning and decryption.
  * @property {Account} [account] Optional account to use for local scanning and decryption.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@provablehq/sdk",
-  "version": "0.11.8",
+  "version": "0.11.10",
   "description": "A Software Development Kit (SDK) for Zero-Knowledge Transactions",
   "collaborators": [
     "The Provable Team"
@@ -91,7 +91,7 @@
   },
   "homepage": "https://github.com/ProvableHQ/sdk#readme",
   "dependencies": {
-    "@provablehq/wasm": "^0.11.8",
+    "@provablehq/wasm": "^0.11.10",
     "@scure/base": "^2.0.0",
     "@serenity-kit/noble-sodium": "0.2.3",
     "comlink": "^4.4.2",