@bitgo/wasm-solana 1.4.2 → 1.6.0

package/dist/cjs/js/wasm/wasm_solana.js

@@ -334,6 +334,10 @@ const InstructionsFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_instructions_free(ptr >>> 0, 1));
 
+const IntentNamespaceFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_intentnamespace_free(ptr >>> 0, 1));
+
 const KeypairFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_keypair_free(ptr >>> 0, 1));
@@ -2700,6 +2704,77 @@ class Instructions {
 if (Symbol.dispose) Instructions.prototype[Symbol.dispose] = Instructions.prototype.free;
 exports.Instructions = Instructions;
 
+/**
+ * Namespace for intent-based building operations.
+ */
+class IntentNamespace {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        IntentNamespaceFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_intentnamespace_free(ptr, 0);
+    }
+    /**
+     * Build a transaction directly from a BitGo intent.
+     *
+     * This function takes the full intent as-is and builds the transaction
+     * without requiring the caller to construct instructions.
+     *
+     * # Arguments
+     *
+     * * `intent` - The full BitGo intent object (with intentType, etc.)
+     * * `params` - Build parameters: { feePayer, nonce }
+     *
+     * # Returns
+     *
+     * An object with:
+     * * `transaction` - WasmTransaction object
+     * * `generatedKeypairs` - Array of keypairs generated (for stake accounts, etc.)
+     *
+     * # Example
+     *
+     * ```javascript
+     * const result = IntentNamespace.build_from_intent(
+     *   {
+     *     intentType: 'stake',
+     *     validatorAddress: '...',
+     *     amount: { value: 1000000000n }
+     *   },
+     *   {
+     *     feePayer: 'DgT9...',
+     *     nonce: { type: 'blockhash', value: 'GWaQ...' }
+     *   }
+     * );
+     * // result.transaction - WasmTransaction object
+     * // result.generatedKeypairs - [{ purpose, address, secretKey }]
+     * ```
+     * @param {any} intent
+     * @param {any} params
+     * @returns {any}
+     */
+    static build_from_intent(intent, params) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.intentnamespace_build_from_intent(retptr, addHeapObject(intent), addHeapObject(params));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+}
+if (Symbol.dispose) IntentNamespace.prototype[Symbol.dispose] = IntentNamespace.prototype.free;
+exports.IntentNamespace = IntentNamespace;
+
 /**
  * A vanilla Ed25519 key pair
  */
@@ -4640,6 +4715,14 @@ class WasmKeypair {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Generate a new random keypair.
+     * @returns {WasmKeypair}
+     */
+    static generate() {
+        const ret = wasm.wasmkeypair_generate();
+        return WasmKeypair.__wrap(ret);
+    }
     /**
      * Get the public key as a base58 string.
      * @returns {string}
@@ -4942,6 +5025,29 @@ class WasmTransaction {
         const ret = wasm.wasmtransaction_signable_payload(this.__wbg_ptr);
         return takeObject(ret);
     }
+    /**
+     * Get the transaction ID (first signature as base58).
+     *
+     * For Solana, the transaction ID is the first signature.
+     * Returns "UNSIGNED" if the first signature is all zeros (unsigned transaction).
+     * @returns {string}
+     */
+    get id() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmtransaction_id(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Serialize the transaction to bytes.
      * @returns {Uint8Array}
@@ -5173,6 +5279,29 @@ class WasmVersionedTransaction {
         const ret = wasm.wasmversionedtransaction_address_lookup_tables(this.__wbg_ptr);
         return takeObject(ret);
     }
+    /**
+     * Get the transaction ID (first signature as base58).
+     *
+     * For Solana, the transaction ID is the first signature.
+     * Returns "UNSIGNED" if the first signature is all zeros (unsigned transaction).
+     * @returns {string}
+     */
+    get id() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmversionedtransaction_id(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * Serialize the transaction to bytes.
      * @returns {Uint8Array}
@@ -5892,6 +6021,11 @@ exports.__wbg_call_abb4ff46ce38be40 = function() { return handleError(function (
     return addHeapObject(ret);
 }, arguments) };
 
+exports.__wbg_crypto_038798f665f985e2 = function(arg0) {
+    const ret = getObject(arg0).crypto;
+    return addHeapObject(ret);
+};
+
 exports.__wbg_crypto_86f2631e91b51511 = function(arg0) {
     const ret = getObject(arg0).crypto;
     return addHeapObject(ret);
@@ -5927,6 +6061,15 @@ exports.__wbg_error_7bc7d576a6aaf855 = function(arg0) {
     console.error(getObject(arg0));
 };
 
+exports.__wbg_getRandomValues_371e7ade8bd92088 = function(arg0, arg1) {
+    getObject(arg0).getRandomValues(getObject(arg1));
+};
+
+exports.__wbg_getRandomValues_7dfe5bd1b67c9ca1 = function(arg0) {
+    const ret = getObject(arg0).getRandomValues;
+    return addHeapObject(ret);
+};
+
 exports.__wbg_getRandomValues_b3f15fcbfabb0f8b = function() { return handleError(function (arg0, arg1) {
     getObject(arg0).getRandomValues(getObject(arg1));
 }, arguments) };
@@ -6022,6 +6165,11 @@ exports.__wbg_msCrypto_d562bbe83e0d4b91 = function(arg0) {
     return addHeapObject(ret);
 };
 
+exports.__wbg_msCrypto_ff35fce085fab2a3 = function(arg0) {
+    const ret = getObject(arg0).msCrypto;
+    return addHeapObject(ret);
+};
+
 exports.__wbg_new_1ba21ce319a06297 = function() {
     const ret = new Object();
     return addHeapObject(ret);
@@ -6101,15 +6249,33 @@ exports.__wbg_push_7d9be8f38fc13975 = function(arg0, arg1) {
     return ret;
 };
 
+exports.__wbg_randomFillSync_994ac6d9ade7a695 = function(arg0, arg1, arg2) {
+    getObject(arg0).randomFillSync(getArrayU8FromWasm0(arg1, arg2));
+};
+
 exports.__wbg_randomFillSync_f8c153b79f285817 = function() { return handleError(function (arg0, arg1) {
     getObject(arg0).randomFillSync(takeObject(arg1));
 }, arguments) };
 
+exports.__wbg_require_0d6aeaec3c042c88 = function(arg0, arg1, arg2) {
+    const ret = getObject(arg0).require(getStringFromWasm0(arg1, arg2));
+    return addHeapObject(ret);
+};
+
 exports.__wbg_require_b74f47fc2d022fd6 = function() { return handleError(function () {
     const ret = module.require;
     return addHeapObject(ret);
 }, arguments) };
 
+exports.__wbg_self_25aabeb5a7b41685 = function() { return handleError(function () {
+    const ret = self.self;
+    return addHeapObject(ret);
+}, arguments) };
+
+exports.__wbg_set_3f1d0b984ed272ed = function(arg0, arg1, arg2) {
+    getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
+};
+
 exports.__wbg_set_781438a03c0c3c81 = function() { return handleError(function (arg0, arg1, arg2) {
     const ret = Reflect.set(getObject(arg0), getObject(arg1), getObject(arg2));
     return ret;
@@ -6137,6 +6303,11 @@ exports.__wbg_static_accessor_GLOBAL_THIS_60cf02db4de8e1c1 = function() {
     return isLikeNone(ret) ? 0 : addHeapObject(ret);
 };
 
+exports.__wbg_static_accessor_MODULE_ef3aa2eb251158a5 = function() {
+    const ret = module;
+    return addHeapObject(ret);
+};
+
 exports.__wbg_static_accessor_SELF_08f5a74c69739274 = function() {
     const ret = typeof self === 'undefined' ? null : self;
     return isLikeNone(ret) ? 0 : addHeapObject(ret);
@@ -6171,6 +6342,11 @@ exports.__wbg_warn_6e567d0d926ff881 = function(arg0) {
     console.warn(getObject(arg0));
 };
 
+exports.__wbg_wasmtransaction_new = function(arg0) {
+    const ret = WasmTransaction.__wrap(arg0);
+    return addHeapObject(ret);
+};
+
 exports.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);

package/dist/cjs/js/wasm/wasm_solana_bg.wasm.d.ts

@@ -1,29 +1,25 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const ata_program_id: (a: number) => void;
-export const compute_budget_program_id: (a: number) => void;
-export const find_withdraw_authority_program_address: (a: number, b: number, c: number) => void;
-export const get_associated_token_address: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const memo_program_id: (a: number) => void;
-export const nonce_account_space: () => bigint;
-export const stake_account_space: () => bigint;
-export const stake_pool_program_id: (a: number) => void;
-export const stake_program_id: (a: number) => void;
-export const system_program_id: (a: number) => void;
-export const sysvar_recent_blockhashes: (a: number) => void;
-export const token_2022_program_id: (a: number) => void;
-export const token_program_id: (a: number) => void;
+export const __wbg_buildernamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmkeypair_free: (a: number, b: number) => void;
-export const __wbg_wasmpubkey_free: (a: number, b: number) => void;
-export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
-export const __wbg_wasmversionedtransaction_free: (a: number, b: number) => void;
-export const is_versioned_transaction: (a: number, b: number) => number;
+export const buildernamespace_build_from_versioned_data: (a: number, b: number) => void;
+export const buildernamespace_build_transaction: (a: number, b: number) => void;
 export const wasmkeypair_address: (a: number, b: number) => void;
 export const wasmkeypair_from_secret_key: (a: number, b: number, c: number) => void;
 export const wasmkeypair_from_solana_secret_key: (a: number, b: number, c: number) => void;
+export const wasmkeypair_generate: () => number;
 export const wasmkeypair_public_key: (a: number) => number;
 export const wasmkeypair_secret_key: (a: number) => number;
+export const wasmkeypair_to_base58: (a: number, b: number) => void;
+export const __wbg_intentnamespace_free: (a: number, b: number) => void;
+export const __wbg_parsernamespace_free: (a: number, b: number) => void;
+export const __wbg_wasmpubkey_free: (a: number, b: number) => void;
+export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
+export const __wbg_wasmversionedtransaction_free: (a: number, b: number) => void;
+export const intentnamespace_build_from_intent: (a: number, b: number, c: number) => void;
+export const is_versioned_transaction: (a: number, b: number) => number;
+export const parsernamespace_parse_transaction: (a: number, b: number, c: number) => void;
 export const wasmpubkey_equals: (a: number, b: number) => number;
 export const wasmpubkey_from_base58: (a: number, b: number, c: number) => void;
 export const wasmpubkey_from_bytes: (a: number, b: number, c: number) => void;
@@ -34,6 +30,7 @@ export const wasmtransaction_account_keys: (a: number) => number;
 export const wasmtransaction_add_signature: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmtransaction_fee_payer: (a: number, b: number) => void;
 export const wasmtransaction_from_bytes: (a: number, b: number, c: number) => void;
+export const wasmtransaction_id: (a: number, b: number) => void;
 export const wasmtransaction_instructions: (a: number) => number;
 export const wasmtransaction_num_instructions: (a: number) => number;
 export const wasmtransaction_num_signatures: (a: number) => number;
@@ -46,6 +43,7 @@ export const wasmversionedtransaction_add_signature: (a: number, b: number, c: n
 export const wasmversionedtransaction_address_lookup_tables: (a: number) => number;
 export const wasmversionedtransaction_fee_payer: (a: number, b: number) => void;
 export const wasmversionedtransaction_from_bytes: (a: number, b: number, c: number) => void;
+export const wasmversionedtransaction_id: (a: number, b: number) => void;
 export const wasmversionedtransaction_instructions: (a: number) => number;
 export const wasmversionedtransaction_is_versioned: (a: number) => number;
 export const wasmversionedtransaction_num_instructions: (a: number) => number;
@@ -55,13 +53,20 @@ export const wasmversionedtransaction_signatures: (a: number) => number;
 export const wasmversionedtransaction_signer_index: (a: number, b: number, c: number) => number;
 export const wasmversionedtransaction_static_account_keys: (a: number) => number;
 export const wasmversionedtransaction_to_bytes: (a: number, b: number) => void;
-export const wasmkeypair_to_base58: (a: number, b: number) => void;
 export const wasmversionedtransaction_num_signatures: (a: number) => number;
-export const __wbg_buildernamespace_free: (a: number, b: number) => void;
-export const __wbg_parsernamespace_free: (a: number, b: number) => void;
-export const buildernamespace_build_from_versioned_data: (a: number, b: number) => void;
-export const buildernamespace_build_transaction: (a: number, b: number) => void;
-export const parsernamespace_parse_transaction: (a: number, b: number, c: number) => void;
+export const ata_program_id: (a: number) => void;
+export const compute_budget_program_id: (a: number) => void;
+export const find_withdraw_authority_program_address: (a: number, b: number, c: number) => void;
+export const get_associated_token_address: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const memo_program_id: (a: number) => void;
+export const nonce_account_space: () => bigint;
+export const stake_account_space: () => bigint;
+export const stake_pool_program_id: (a: number) => void;
+export const stake_program_id: (a: number) => void;
+export const system_program_id: (a: number) => void;
+export const sysvar_recent_blockhashes: (a: number) => void;
+export const token_2022_program_id: (a: number) => void;
+export const token_program_id: (a: number) => void;
 export const __wbg_keypair_free: (a: number, b: number) => void;
 export const keypair_constructor: () => number;
 export const keypair_fromBytes: (a: number, b: number, c: number) => void;

package/dist/esm/js/index.d.ts

@@ -10,7 +10,9 @@ export { VersionedTransaction, isVersionedTransaction } from "./versioned.js";
 export type { AddressLookupTableData } from "./versioned.js";
 export { parseTransaction } from "./parser.js";
 export { buildTransaction, buildFromVersionedData } from "./builder.js";
+export { buildFromIntent } from "./intentBuilder.js";
+export type { BaseIntent, PaymentIntent, StakeIntent, UnstakeIntent, ClaimIntent, DeactivateIntent, DelegateIntent, EnableTokenIntent, CloseAtaIntent, ConsolidateIntent, SolanaIntent, StakePoolConfig, BuildFromIntentParams, BuildFromIntentResult, GeneratedKeypair, NonceSource, BlockhashNonce, DurableNonce, } from "./intentBuilder.js";
 export { system_program_id as systemProgramId, stake_program_id as stakeProgramId, compute_budget_program_id as computeBudgetProgramId, memo_program_id as memoProgramId, token_program_id as tokenProgramId, token_2022_program_id as token2022ProgramId, ata_program_id as ataProgramId, stake_pool_program_id as stakePoolProgramId, stake_account_space as stakeAccountSpace, nonce_account_space as nonceAccountSpace, sysvar_recent_blockhashes as sysvarRecentBlockhashes, get_associated_token_address as getAssociatedTokenAddress, find_withdraw_authority_program_address as findWithdrawAuthorityProgramAddress, } from "./wasm/wasm_solana.js";
 export type { AccountMeta, Instruction } from "./transaction.js";
-export type { TransactionInput, ParsedTransaction, DurableNonce, InstructionParams, TransferParams, CreateAccountParams, NonceAdvanceParams, CreateNonceAccountParams, NonceInitializeParams, StakeInitializeParams, StakingActivateParams, StakingDeactivateParams, StakingWithdrawParams, StakingDelegateParams, StakingAuthorizeParams, SetComputeUnitLimitParams, SetPriorityFeeParams, TokenTransferParams, CreateAtaParams, CloseAtaParams, MemoParams, StakePoolDepositSolParams, StakePoolWithdrawStakeParams, UnknownInstructionParams, } from "./parser.js";
-export type { TransactionIntent, NonceSource, BlockhashNonceSource, DurableNonceSource, AddressLookupTable as BuilderAddressLookupTable, Instruction as BuilderInstruction, TransferInstruction, CreateAccountInstruction, NonceAdvanceInstruction, NonceInitializeInstruction, AllocateInstruction, AssignInstruction, MemoInstruction, ComputeBudgetInstruction, StakeInitializeInstruction, StakeDelegateInstruction, StakeDeactivateInstruction, StakeWithdrawInstruction, StakeAuthorizeInstruction, StakeSplitInstruction, TokenTransferInstruction, CreateAssociatedTokenAccountInstruction, CloseAssociatedTokenAccountInstruction, MintToInstruction, BurnInstruction, ApproveInstruction, StakePoolDepositSolInstruction, StakePoolWithdrawStakeInstruction, CustomInstruction as BuilderCustomInstruction, CustomAccountMeta, RawVersionedTransactionData, VersionedInstruction as BuilderVersionedInstruction, MessageHeader, } from "./builder.js";
+export type { TransactionInput, ParsedTransaction, DurableNonce as ParsedDurableNonce, InstructionParams, TransferParams, CreateAccountParams, NonceAdvanceParams, CreateNonceAccountParams, NonceInitializeParams, StakeInitializeParams, StakingActivateParams, StakingDeactivateParams, StakingWithdrawParams, StakingDelegateParams, StakingAuthorizeParams, SetComputeUnitLimitParams, SetPriorityFeeParams, TokenTransferParams, CreateAtaParams, CloseAtaParams, MemoParams, StakePoolDepositSolParams, StakePoolWithdrawStakeParams, UnknownInstructionParams, } from "./parser.js";
+export type { TransactionIntent, NonceSource as BuilderNonceSource, BlockhashNonceSource, DurableNonceSource, AddressLookupTable as BuilderAddressLookupTable, Instruction as BuilderInstruction, TransferInstruction, CreateAccountInstruction, NonceAdvanceInstruction, NonceInitializeInstruction, AllocateInstruction, AssignInstruction, MemoInstruction, ComputeBudgetInstruction, StakeInitializeInstruction, StakeDelegateInstruction, StakeDeactivateInstruction, StakeWithdrawInstruction, StakeAuthorizeInstruction, StakeSplitInstruction, TokenTransferInstruction, CreateAssociatedTokenAccountInstruction, CloseAssociatedTokenAccountInstruction, MintToInstruction, BurnInstruction, ApproveInstruction, StakePoolDepositSolInstruction, StakePoolWithdrawStakeInstruction, CustomInstruction as BuilderCustomInstruction, CustomAccountMeta, RawVersionedTransactionData, VersionedInstruction as BuilderVersionedInstruction, MessageHeader, } from "./builder.js";

package/dist/esm/js/index.js

@@ -16,6 +16,7 @@ export { VersionedTransaction, isVersionedTransaction } from "./versioned.js";
 // Top-level function exports
 export { parseTransaction } from "./parser.js";
 export { buildTransaction, buildFromVersionedData } from "./builder.js";
+export { buildFromIntent } from "./intentBuilder.js";
 // Program ID constants (from WASM)
 export { system_program_id as systemProgramId, stake_program_id as stakeProgramId, compute_budget_program_id as computeBudgetProgramId, memo_program_id as memoProgramId, token_program_id as tokenProgramId, token_2022_program_id as token2022ProgramId, ata_program_id as ataProgramId, stake_pool_program_id as stakePoolProgramId, stake_account_space as stakeAccountSpace, nonce_account_space as nonceAccountSpace, 
 // Sysvar addresses

package/dist/esm/js/intentBuilder.d.ts

@@ -0,0 +1,197 @@
+/**
+ * High-level intent-based transaction building.
+ *
+ * This module provides `buildFromIntent()` which accepts BitGo intent objects
+ * directly and builds Solana transactions without requiring the caller to
+ * construct low-level instructions.
+ *
+ * The intent → transaction mapping happens entirely in Rust/WASM for simplicity.
+ *
+ * Usage:
+ * ```typescript
+ * import { buildFromIntent } from '@bitgo/wasm-solana';
+ *
+ * const result = buildFromIntent(intent, {
+ *   feePayer: walletRootAddress,
+ *   nonce: { type: 'blockhash', value: recentBlockhash },
+ * });
+ *
+ * // result.transaction - Transaction object
+ * // result.generatedKeypairs - any keypairs generated (e.g., stake accounts)
+ * ```
+ */
+import { Transaction } from "./transaction.js";
+/** Nonce source - blockhash or durable nonce */
+export type NonceSource = BlockhashNonce | DurableNonce;
+export interface BlockhashNonce {
+    type: "blockhash";
+    value: string;
+}
+export interface DurableNonce {
+    type: "durable";
+    address: string;
+    authority: string;
+    value: string;
+}
+/** Parameters for building a transaction from intent */
+export interface BuildFromIntentParams {
+    /** Fee payer address (wallet root) */
+    feePayer: string;
+    /** Nonce source - blockhash or durable nonce */
+    nonce: NonceSource;
+}
+/** A keypair generated during transaction building */
+export interface GeneratedKeypair {
+    /** Purpose of this keypair */
+    purpose: "stakeAccount" | "unstakeAccount" | "transferAuthority";
+    /** Public address (base58) */
+    address: string;
+    /** Secret key (base58) */
+    secretKey: string;
+}
+/** Result from building a transaction from intent */
+export interface BuildFromIntentResult {
+    /** The built transaction */
+    transaction: Transaction;
+    /** Generated keypairs (for stake accounts, etc.) */
+    generatedKeypairs: GeneratedKeypair[];
+}
+/** Base intent - all intents have intentType */
+export interface BaseIntent {
+    intentType: string;
+    memo?: string;
+}
+/** Payment intent */
+export interface PaymentIntent extends BaseIntent {
+    intentType: "payment";
+    recipients?: Array<{
+        address?: {
+            address: string;
+        };
+        amount?: {
+            value: bigint;
+            symbol?: string;
+        };
+    }>;
+}
+/** Stake intent */
+export interface StakeIntent extends BaseIntent {
+    intentType: "stake";
+    validatorAddress: string;
+    amount?: {
+        value: bigint;
+    };
+    stakingType?: "NATIVE" | "JITO" | "MARINADE";
+    stakePoolConfig?: StakePoolConfig;
+}
+/** Stake pool configuration (for Jito) */
+export interface StakePoolConfig {
+    stakePoolAddress: string;
+    withdrawAuthority: string;
+    reserveStake: string;
+    destinationPoolAccount: string;
+    managerFeeAccount: string;
+    referralPoolAccount?: string;
+    poolMint: string;
+    validatorList?: string;
+    sourcePoolAccount?: string;
+}
+/** Unstake intent */
+export interface UnstakeIntent extends BaseIntent {
+    intentType: "unstake";
+    stakingAddress: string;
+    validatorAddress?: string;
+    amount?: {
+        value: bigint;
+    };
+    remainingStakingAmount?: {
+        value: bigint;
+    };
+    stakingType?: "NATIVE" | "JITO" | "MARINADE";
+    stakePoolConfig?: StakePoolConfig;
+}
+/** Claim intent (withdraw from deactivated stake) */
+export interface ClaimIntent extends BaseIntent {
+    intentType: "claim";
+    stakingAddress: string;
+    amount?: {
+        value: bigint;
+    };
+}
+/** Deactivate intent */
+export interface DeactivateIntent extends BaseIntent {
+    intentType: "deactivate";
+    stakingAddress?: string;
+    stakingAddresses?: string[];
+}
+/** Delegate intent */
+export interface DelegateIntent extends BaseIntent {
+    intentType: "delegate";
+    validatorAddress: string;
+    stakingAddress?: string;
+    stakingAddresses?: string[];
+}
+/** Enable token intent (create ATA) */
+export interface EnableTokenIntent extends BaseIntent {
+    intentType: "enableToken";
+    recipientAddress?: string;
+    tokenAddress?: string;
+    tokenProgramId?: string;
+}
+/** Close ATA intent */
+export interface CloseAtaIntent extends BaseIntent {
+    intentType: "closeAssociatedTokenAccount";
+    tokenAccountAddress?: string;
+    tokenProgramId?: string;
+}
+/** Consolidate intent - transfer from child address to root */
+export interface ConsolidateIntent extends BaseIntent {
+    intentType: "consolidate";
+    /** The child address to consolidate from (sender) */
+    receiveAddress: string;
+    /** Recipients (root address for SOL, ATAs for tokens) */
+    recipients?: Array<{
+        address?: {
+            address: string;
+        };
+        amount?: {
+            value: bigint;
+        };
+    }>;
+}
+/** Union of all supported intent types */
+export type SolanaIntent = PaymentIntent | StakeIntent | UnstakeIntent | ClaimIntent | DeactivateIntent | DelegateIntent | EnableTokenIntent | CloseAtaIntent | ConsolidateIntent;
+/**
+ * Build a Solana transaction from a BitGo intent.
+ *
+ * This function passes the intent directly to Rust/WASM which handles
+ * all the intent-to-transaction mapping internally.
+ *
+ * @param intent - The BitGo intent (with intentType, etc.)
+ * @param params - Build parameters (feePayer, nonce)
+ * @returns Transaction object and any generated keypairs
+ *
+ * @example
+ * ```typescript
+ * // Payment intent
+ * const result = buildFromIntent(
+ *   {
+ *     intentType: 'payment',
+ *     recipients: [{ address: { address: recipient }, amount: { value: 1000000n } }]
+ *   },
+ *   { feePayer: walletRoot, nonce: { type: 'blockhash', value: blockhash } }
+ * );
+ *
+ * // Native staking - generates a new stake account keypair
+ * const result = buildFromIntent(
+ *   {
+ *     intentType: 'stake',
+ *     validatorAddress: validator,
+ *     amount: { value: 1000000000n }
+ *   },
+ *   { feePayer: walletRoot, nonce: { type: 'blockhash', value: blockhash } }
+ * );
+ * // result.generatedKeypairs[0] contains the stake account keypair
+ * ```
+ */
+export declare function buildFromIntent(intent: BaseIntent, params: BuildFromIntentParams): BuildFromIntentResult;

package/dist/esm/js/intentBuilder.js

@@ -0,0 +1,67 @@
+/**
+ * High-level intent-based transaction building.
+ *
+ * This module provides `buildFromIntent()` which accepts BitGo intent objects
+ * directly and builds Solana transactions without requiring the caller to
+ * construct low-level instructions.
+ *
+ * The intent → transaction mapping happens entirely in Rust/WASM for simplicity.
+ *
+ * Usage:
+ * ```typescript
+ * import { buildFromIntent } from '@bitgo/wasm-solana';
+ *
+ * const result = buildFromIntent(intent, {
+ *   feePayer: walletRootAddress,
+ *   nonce: { type: 'blockhash', value: recentBlockhash },
+ * });
+ *
+ * // result.transaction - Transaction object
+ * // result.generatedKeypairs - any keypairs generated (e.g., stake accounts)
+ * ```
+ */
+import { IntentNamespace } from "./wasm/wasm_solana.js";
+import { Transaction } from "./transaction.js";
+// =============================================================================
+// Main Function
+// =============================================================================
+/**
+ * Build a Solana transaction from a BitGo intent.
+ *
+ * This function passes the intent directly to Rust/WASM which handles
+ * all the intent-to-transaction mapping internally.
+ *
+ * @param intent - The BitGo intent (with intentType, etc.)
+ * @param params - Build parameters (feePayer, nonce)
+ * @returns Transaction object and any generated keypairs
+ *
+ * @example
+ * ```typescript
+ * // Payment intent
+ * const result = buildFromIntent(
+ *   {
+ *     intentType: 'payment',
+ *     recipients: [{ address: { address: recipient }, amount: { value: 1000000n } }]
+ *   },
+ *   { feePayer: walletRoot, nonce: { type: 'blockhash', value: blockhash } }
+ * );
+ *
+ * // Native staking - generates a new stake account keypair
+ * const result = buildFromIntent(
+ *   {
+ *     intentType: 'stake',
+ *     validatorAddress: validator,
+ *     amount: { value: 1000000000n }
+ *   },
+ *   { feePayer: walletRoot, nonce: { type: 'blockhash', value: blockhash } }
+ * );
+ * // result.generatedKeypairs[0] contains the stake account keypair
+ * ```
+ */
+export function buildFromIntent(intent, params) {
+    const result = IntentNamespace.build_from_intent(intent, params);
+    return {
+        transaction: Transaction.fromWasm(result.transaction),
+        generatedKeypairs: result.generatedKeypairs,
+    };
+}

package/dist/esm/js/keypair.d.ts

@@ -8,6 +8,11 @@ import { WasmKeypair } from "./wasm/wasm_solana.js";
 export declare class Keypair {
     private _wasm;
     private constructor();
+    /**
+     * Generate a new random keypair
+     * @returns A new Keypair instance with randomly generated keys
+     */
+    static generate(): Keypair;
     /**
      * Create a keypair from a 32-byte secret key
      * @param secretKey - The 32-byte Ed25519 secret key

package/dist/esm/js/keypair.js

@@ -10,6 +10,14 @@ export class Keypair {
     constructor(_wasm) {
         this._wasm = _wasm;
     }
+    /**
+     * Generate a new random keypair
+     * @returns A new Keypair instance with randomly generated keys
+     */
+    static generate() {
+        const wasm = WasmKeypair.generate();
+        return new Keypair(wasm);
+    }
     /**
      * Create a keypair from a 32-byte secret key
      * @param secretKey - The 32-byte Ed25519 secret key