@umbra-privacy/sdk 1.0.0 → 2.0.0

package/dist/math/index.js

@@ -0,0 +1,10 @@
+export { bn254Add, bn254ModuloPow, bn254Mul, bn254Sub, computeBn254LimbwiseSumInverse, computeBn254ModularInverse } from '../chunk-OFDWNWCL.js';
+export { bn254FieldElementSampler, curve25519FieldElementSampler, curve25519ModuloAdd, curve25519ModuloInv, curve25519ModuloMul, curve25519ModuloPow, curve25519ModuloSub, getBn254FieldElementSampler, getBn254ModularAdder, getBn254ModularInverter, getBn254ModularMultiplier, getBn254ModularNegator, getBn254ModularSubtractor, getCurve25519FieldElementSampler, getCurve25519ModularAddFunction, getCurve25519ModularInvFunction, getCurve25519ModularMulFunction, getCurve25519ModularPowFunction, getCurve25519ModularSubFunction } from '../chunk-WN75ORDT.js';
+import '../chunk-5KPQXPQM.js';
+import '../chunk-UOFYS6M3.js';
+import '../chunk-FQX6ZYGJ.js';
+import '../chunk-4TZVXB5G.js';
+import '../chunk-CFTW5WNG.js';
+import '../chunk-7QVYU63E.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/math/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/networks-RMd3abPE.d.ts

@@ -0,0 +1,44 @@
+import { Address } from '@solana/kit';
+import { N as Network } from './versions-BRlR36EA.js';
+import { X as X25519PublicKey } from './cryptography-BFSJcvi6.js';
+
+/**
+ * Per-Network Configuration
+ *
+ * Contains network-specific addresses and keys for each supported network.
+ * AUTO-GENERATED by the solana-program-builder pipeline.
+ * Do not edit manually — run populate-sdk-config + populate-sdk-alts + generate-sdk-networks.
+ *
+ * @module constants/networks
+ */
+
+/**
+ * A pre-baked Address Lookup Table entry.
+ *
+ * Contains the on-chain ALT address and the list of addresses it holds,
+ * so no RPC call is needed to resolve the table at transaction build time.
+ */
+interface AltEntry {
+    /** The on-chain Address Lookup Table address. */
+    readonly altAddress: Address;
+    /** The ordered list of addresses stored in this ALT. */
+    readonly addresses: readonly Address[];
+}
+/**
+ * Configuration for a single network deployment.
+ */
+interface NetworkConfig {
+    readonly programId: Address;
+    readonly mxeAccountAddress: Address;
+    readonly mxePubkey: X25519PublicKey;
+    readonly arciumProgramAddress: Address;
+    readonly addressLookupTables: Readonly<Record<number, Readonly<Record<string, AltEntry>>>>;
+}
+/**
+ * Get the network configuration for a given network.
+ *
+ * @throws {UmbraError} if the network has not been populated.
+ */
+declare function getNetworkConfig(network: Network): NetworkConfig;
+
+export { type AltEntry as A, type NetworkConfig as N, getNetworkConfig as g };

package/dist/networks-yAoO8peQ.d.cts

@@ -0,0 +1,44 @@
+import { Address } from '@solana/kit';
+import { N as Network } from './versions-BRlR36EA.cjs';
+import { X as X25519PublicKey } from './cryptography-D6tPDh-Y.cjs';
+
+/**
+ * Per-Network Configuration
+ *
+ * Contains network-specific addresses and keys for each supported network.
+ * AUTO-GENERATED by the solana-program-builder pipeline.
+ * Do not edit manually — run populate-sdk-config + populate-sdk-alts + generate-sdk-networks.
+ *
+ * @module constants/networks
+ */
+
+/**
+ * A pre-baked Address Lookup Table entry.
+ *
+ * Contains the on-chain ALT address and the list of addresses it holds,
+ * so no RPC call is needed to resolve the table at transaction build time.
+ */
+interface AltEntry {
+    /** The on-chain Address Lookup Table address. */
+    readonly altAddress: Address;
+    /** The ordered list of addresses stored in this ALT. */
+    readonly addresses: readonly Address[];
+}
+/**
+ * Configuration for a single network deployment.
+ */
+interface NetworkConfig {
+    readonly programId: Address;
+    readonly mxeAccountAddress: Address;
+    readonly mxePubkey: X25519PublicKey;
+    readonly arciumProgramAddress: Address;
+    readonly addressLookupTables: Readonly<Record<number, Readonly<Record<string, AltEntry>>>>;
+}
+/**
+ * Get the network configuration for a given network.
+ *
+ * @throws {UmbraError} if the network has not been populated.
+ */
+declare function getNetworkConfig(network: Network): NetworkConfig;
+
+export { type AltEntry as A, type NetworkConfig as N, getNetworkConfig as g };

package/dist/relayer-NRRMSMNB.js

@@ -0,0 +1,4 @@
+export { RelayerError, getUmbraRelayer, pollClaimUntilTerminal } from './chunk-4RHXVBNI.js';
+import './chunk-7QVYU63E.js';
+//# sourceMappingURL=relayer-NRRMSMNB.js.map
+//# sourceMappingURL=relayer-NRRMSMNB.js.map

package/dist/relayer-NRRMSMNB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"relayer-NRRMSMNB.js"}

package/dist/relayer-RJHEIXJG.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkNKVMSABR_cjs = require('./chunk-NKVMSABR.cjs');
+require('./chunk-PK6SKIKE.cjs');
+
+
+
+Object.defineProperty(exports, "RelayerError", {
+  enumerable: true,
+  get: function () { return chunkNKVMSABR_cjs.RelayerError; }
+});
+Object.defineProperty(exports, "getUmbraRelayer", {
+  enumerable: true,
+  get: function () { return chunkNKVMSABR_cjs.getUmbraRelayer; }
+});
+Object.defineProperty(exports, "pollClaimUntilTerminal", {
+  enumerable: true,
+  get: function () { return chunkNKVMSABR_cjs.pollClaimUntilTerminal; }
+});
+//# sourceMappingURL=relayer-RJHEIXJG.cjs.map
+//# sourceMappingURL=relayer-RJHEIXJG.cjs.map

package/dist/relayer-RJHEIXJG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"relayer-RJHEIXJG.cjs"}

package/dist/solana/index.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+var chunkAXD7LXYY_cjs = require('../chunk-AXD7LXYY.cjs');
+require('../chunk-ENVYYEM4.cjs');
+require('../chunk-FZYWLQAF.cjs');
+require('../chunk-LTCKPTZC.cjs');
+require('../chunk-PK6SKIKE.cjs');
+
+
+
+Object.defineProperty(exports, "buildAltAddressesRecord", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.buildAltAddressesRecord; }
+});
+Object.defineProperty(exports, "createInMemorySigner", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.createInMemorySigner; }
+});
+Object.defineProperty(exports, "createSignerFromKeyPair", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.createSignerFromKeyPair; }
+});
+Object.defineProperty(exports, "createSignerFromPrivateKeyBytes", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.createSignerFromPrivateKeyBytes; }
+});
+Object.defineProperty(exports, "createSignerFromWalletAccount", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.createSignerFromWalletAccount; }
+});
+Object.defineProperty(exports, "getPollingTransactionForwarder", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.getPollingTransactionForwarder; }
+});
+Object.defineProperty(exports, "getRpcAccountInfoProvider", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.getRpcAccountInfoProvider; }
+});
+Object.defineProperty(exports, "getRpcBlockhashProvider", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.getRpcBlockhashProvider; }
+});
+Object.defineProperty(exports, "getRpcEpochInfoProvider", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.getRpcEpochInfoProvider; }
+});
+Object.defineProperty(exports, "getWebsocketTransactionForwarder", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.getWebsocketTransactionForwarder; }
+});
+Object.defineProperty(exports, "lookupAltEntry", {
+  enumerable: true,
+  get: function () { return chunkAXD7LXYY_cjs.lookupAltEntry; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/solana/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/solana/index.d.cts

@@ -0,0 +1,105 @@
+export { O as OnTransactionConfirmed, P as PollingBasedTransactionForwarderConfig, a as PollingBasedTransactionForwarderDeps, b as PollingTransactionForwardOptions, R as RpcBasedAccountInfoProviderConfig, c as RpcBasedBlockhashProviderConfig, d as RpcBasedBlockhashProviderDeps, e as RpcBasedEpochInfoProviderConfig, f as RpcBasedEpochInfoProviderDeps, T as TransactionConfirmedInfo, g as TransactionForwardOptions, W as WebsocketBasedTransactionForwarderConfig, h as WebsocketBasedTransactionForwarderDeps, i as createInMemorySigner, j as createSignerFromKeyPair, k as createSignerFromPrivateKeyBytes, l as createSignerFromWalletAccount, m as getPollingTransactionForwarder, n as getRpcAccountInfoProvider, o as getRpcBlockhashProvider, p as getRpcEpochInfoProvider, q as getWebsocketTransactionForwarder } from '../transaction-forwarder-C6gMUG7a.cjs';
+import { Address } from '@solana/kit';
+import { A as AltEntry } from '../networks-yAoO8peQ.cjs';
+import '../client-DkVBHMWb.cjs';
+import '../types-C_V_CaKK.cjs';
+import '../cryptography-D6tPDh-Y.cjs';
+import '../types-EKuIfxTz.cjs';
+import '../versions-BRlR36EA.cjs';
+import '../types-IMGYmlv-.cjs';
+import '@wallet-standard/core';
+
+/**
+ * Address Lookup Table utilities for transaction compression.
+ *
+ * Address Lookup Tables (ALTs) are Solana on-chain accounts that store a list of
+ * public keys. When building versioned (v0) transactions, ALTs allow instructions
+ * to reference accounts by their index in the table rather than including the full
+ * 32-byte public key inline. This reduces transaction size and allows a single
+ * transaction to reference more accounts than the standard per-transaction limit.
+ *
+ * This module provides helpers for converting the SDK's internal {@link AltEntry}
+ * representation into the record format that `@solana/kit`'s
+ * `compressTransactionMessageUsingAddressLookupTables` expects.
+ *
+ * @remarks
+ * ALTs must be pre-loaded on-chain before they can be used in transactions. The
+ * Umbra SDK stores pre-baked ALT addresses and their contents in {@link NetworkConfig}
+ * so clients do not need to fetch ALT account data at runtime — the addresses are
+ * already known at build time.
+ *
+ * @see {@link AltEntry} for the SDK's internal ALT representation
+ * @see {@link buildAltAddressesRecord} for converting an ALT entry to the kit-compatible format
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Converts an {@link AltEntry} into the record format expected by
+ * `compressTransactionMessageUsingAddressLookupTables`.
+ *
+ * The `@solana/kit` function `compressTransactionMessageUsingAddressLookupTables`
+ * accepts a `Record<Address, Address[]>` where each key is an ALT account address
+ * and each value is the ordered list of addresses stored within that table. This
+ * function performs that conversion from the SDK's {@link AltEntry} shape.
+ *
+ * @remarks
+ * The returned record is a shallow copy of the addresses array — mutations to the
+ * original {@link AltEntry} after this call will not affect the returned record.
+ *
+ * When a transaction message is compressed using this record, `@solana/kit` will
+ * replace any account references that match entries in the ALT with the
+ * corresponding table index, shrinking the serialized transaction size.
+ *
+ * @param altEntry - The pre-baked ALT entry sourced from {@link NetworkConfig}.
+ *   Contains the on-chain ALT address and the ordered list of addresses it holds.
+ * @returns A `Record` mapping the ALT account address to the ordered array of
+ *   addresses stored in the table. This format is consumed directly by
+ *   `compressTransactionMessageUsingAddressLookupTables`.
+ *
+ * @example
+ * ```typescript
+ * import { buildAltAddressesRecord } from "./alt-utils";
+ * import { compressTransactionMessageUsingAddressLookupTables } from "@solana/kit";
+ * import { MAINNET_CONFIG } from "../constants/networks";
+ *
+ * const altRecord = buildAltAddressesRecord(MAINNET_CONFIG.alt);
+ *
+ * const compressedMessage = compressTransactionMessageUsingAddressLookupTables(
+ *   transactionMessage,
+ *   altRecord,
+ * );
+ * ```
+ *
+ * @example
+ * Combining multiple ALT entries into one record:
+ * ```typescript
+ * import { buildAltAddressesRecord } from "./alt-utils";
+ *
+ * const combinedAltRecord = {
+ *   ...buildAltAddressesRecord(MAINNET_CONFIG.umbraAlt),
+ *   ...buildAltAddressesRecord(MAINNET_CONFIG.arciumAlt),
+ * };
+ * ```
+ *
+ * @see {@link AltEntry} for the input type definition
+ * @public
+ */
+declare function buildAltAddressesRecord(altEntry: AltEntry): Record<Address, Address[]>;
+/**
+ * Looks up an ALT entry from the nested address lookup tables structure.
+ *
+ * The lookup tables are keyed by cluster offset (number), then by instruction
+ * name (string). Returns `undefined` if no ALT exists for the given cluster
+ * offset or instruction name.
+ *
+ * @param addressLookupTables - The nested ALT structure from {@link NetworkConfig}.
+ * @param clusterOffset - The Arcium cluster offset (fetched from the on-chain MXE account).
+ * @param instructionName - The snake_case instruction name.
+ * @returns The matching {@link AltEntry}, or `undefined` if not found.
+ *
+ * @public
+ */
+declare function lookupAltEntry(addressLookupTables: Readonly<Record<number, Readonly<Record<string, AltEntry>>>>, clusterOffset: number, instructionName: string): AltEntry | undefined;
+
+export { buildAltAddressesRecord, lookupAltEntry };

package/dist/solana/index.d.ts

@@ -0,0 +1,105 @@
+export { O as OnTransactionConfirmed, P as PollingBasedTransactionForwarderConfig, a as PollingBasedTransactionForwarderDeps, b as PollingTransactionForwardOptions, R as RpcBasedAccountInfoProviderConfig, c as RpcBasedBlockhashProviderConfig, d as RpcBasedBlockhashProviderDeps, e as RpcBasedEpochInfoProviderConfig, f as RpcBasedEpochInfoProviderDeps, T as TransactionConfirmedInfo, g as TransactionForwardOptions, W as WebsocketBasedTransactionForwarderConfig, h as WebsocketBasedTransactionForwarderDeps, i as createInMemorySigner, j as createSignerFromKeyPair, k as createSignerFromPrivateKeyBytes, l as createSignerFromWalletAccount, m as getPollingTransactionForwarder, n as getRpcAccountInfoProvider, o as getRpcBlockhashProvider, p as getRpcEpochInfoProvider, q as getWebsocketTransactionForwarder } from '../transaction-forwarder-5mAMTjw6.js';
+import { Address } from '@solana/kit';
+import { A as AltEntry } from '../networks-RMd3abPE.js';
+import '../client-V4AF6Bz9.js';
+import '../types-C_V_CaKK.js';
+import '../cryptography-BFSJcvi6.js';
+import '../types-CxfTIpN9.js';
+import '../versions-BRlR36EA.js';
+import '../types-D1jDUjfN.js';
+import '@wallet-standard/core';
+
+/**
+ * Address Lookup Table utilities for transaction compression.
+ *
+ * Address Lookup Tables (ALTs) are Solana on-chain accounts that store a list of
+ * public keys. When building versioned (v0) transactions, ALTs allow instructions
+ * to reference accounts by their index in the table rather than including the full
+ * 32-byte public key inline. This reduces transaction size and allows a single
+ * transaction to reference more accounts than the standard per-transaction limit.
+ *
+ * This module provides helpers for converting the SDK's internal {@link AltEntry}
+ * representation into the record format that `@solana/kit`'s
+ * `compressTransactionMessageUsingAddressLookupTables` expects.
+ *
+ * @remarks
+ * ALTs must be pre-loaded on-chain before they can be used in transactions. The
+ * Umbra SDK stores pre-baked ALT addresses and their contents in {@link NetworkConfig}
+ * so clients do not need to fetch ALT account data at runtime — the addresses are
+ * already known at build time.
+ *
+ * @see {@link AltEntry} for the SDK's internal ALT representation
+ * @see {@link buildAltAddressesRecord} for converting an ALT entry to the kit-compatible format
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Converts an {@link AltEntry} into the record format expected by
+ * `compressTransactionMessageUsingAddressLookupTables`.
+ *
+ * The `@solana/kit` function `compressTransactionMessageUsingAddressLookupTables`
+ * accepts a `Record<Address, Address[]>` where each key is an ALT account address
+ * and each value is the ordered list of addresses stored within that table. This
+ * function performs that conversion from the SDK's {@link AltEntry} shape.
+ *
+ * @remarks
+ * The returned record is a shallow copy of the addresses array — mutations to the
+ * original {@link AltEntry} after this call will not affect the returned record.
+ *
+ * When a transaction message is compressed using this record, `@solana/kit` will
+ * replace any account references that match entries in the ALT with the
+ * corresponding table index, shrinking the serialized transaction size.
+ *
+ * @param altEntry - The pre-baked ALT entry sourced from {@link NetworkConfig}.
+ *   Contains the on-chain ALT address and the ordered list of addresses it holds.
+ * @returns A `Record` mapping the ALT account address to the ordered array of
+ *   addresses stored in the table. This format is consumed directly by
+ *   `compressTransactionMessageUsingAddressLookupTables`.
+ *
+ * @example
+ * ```typescript
+ * import { buildAltAddressesRecord } from "./alt-utils";
+ * import { compressTransactionMessageUsingAddressLookupTables } from "@solana/kit";
+ * import { MAINNET_CONFIG } from "../constants/networks";
+ *
+ * const altRecord = buildAltAddressesRecord(MAINNET_CONFIG.alt);
+ *
+ * const compressedMessage = compressTransactionMessageUsingAddressLookupTables(
+ *   transactionMessage,
+ *   altRecord,
+ * );
+ * ```
+ *
+ * @example
+ * Combining multiple ALT entries into one record:
+ * ```typescript
+ * import { buildAltAddressesRecord } from "./alt-utils";
+ *
+ * const combinedAltRecord = {
+ *   ...buildAltAddressesRecord(MAINNET_CONFIG.umbraAlt),
+ *   ...buildAltAddressesRecord(MAINNET_CONFIG.arciumAlt),
+ * };
+ * ```
+ *
+ * @see {@link AltEntry} for the input type definition
+ * @public
+ */
+declare function buildAltAddressesRecord(altEntry: AltEntry): Record<Address, Address[]>;
+/**
+ * Looks up an ALT entry from the nested address lookup tables structure.
+ *
+ * The lookup tables are keyed by cluster offset (number), then by instruction
+ * name (string). Returns `undefined` if no ALT exists for the given cluster
+ * offset or instruction name.
+ *
+ * @param addressLookupTables - The nested ALT structure from {@link NetworkConfig}.
+ * @param clusterOffset - The Arcium cluster offset (fetched from the on-chain MXE account).
+ * @param instructionName - The snake_case instruction name.
+ * @returns The matching {@link AltEntry}, or `undefined` if not found.
+ *
+ * @public
+ */
+declare function lookupAltEntry(addressLookupTables: Readonly<Record<number, Readonly<Record<string, AltEntry>>>>, clusterOffset: number, instructionName: string): AltEntry | undefined;
+
+export { buildAltAddressesRecord, lookupAltEntry };

package/dist/solana/index.js

@@ -0,0 +1,7 @@
+export { buildAltAddressesRecord, createInMemorySigner, createSignerFromKeyPair, createSignerFromPrivateKeyBytes, createSignerFromWalletAccount, getPollingTransactionForwarder, getRpcAccountInfoProvider, getRpcBlockhashProvider, getRpcEpochInfoProvider, getWebsocketTransactionForwarder, lookupAltEntry } from '../chunk-HA5FLM63.js';
+import '../chunk-TLR7A64G.js';
+import '../chunk-DD2WCK4C.js';
+import '../chunk-CFTW5WNG.js';
+import '../chunk-7QVYU63E.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/solana/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/{index-CLj_zWSD.d.ts → temporal-BbRaEPoO.d.ts}

@@ -1,4 +1,4 @@
-import { Y as Year, M as Month, D as Day, H as Hour, a as Minute, S as Second } from './types-n-sHFcgr.js';
+import { Y as Year, M as Month, D as Day, H as Hour, a as Minute, S as Second } from './types-D1jDUjfN.js';
 
 /**
  * Temporal Utilities

package/dist/{index-CX6_pIRS.d.cts → temporal-oUj7iCaq.d.cts}

@@ -1,4 +1,4 @@
-import { Y as Year, M as Month, D as Day, H as Hour, a as Minute, S as Second } from './types-BBuELtY8.cjs';
+import { Y as Year, M as Month, D as Day, H as Hour, a as Minute, S as Second } from './types-IMGYmlv-.cjs';
 
 /**
  * Temporal Utilities