@bitgo/wasm-solana 1.4.2 → 1.6.0

package/dist/cjs/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/cjs/js/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findWithdrawAuthorityProgramAddress = exports.getAssociatedTokenAddress = exports.sysvarRecentBlockhashes = exports.nonceAccountSpace = exports.stakeAccountSpace = exports.stakePoolProgramId = exports.ataProgramId = exports.token2022ProgramId = exports.tokenProgramId = exports.memoProgramId = exports.computeBudgetProgramId = exports.stakeProgramId = exports.systemProgramId = exports.buildFromVersionedData = exports.buildTransaction = exports.parseTransaction = exports.isVersionedTransaction = exports.VersionedTransaction = exports.Transaction = exports.Pubkey = exports.Keypair = exports.builder = exports.parser = exports.transaction = exports.pubkey = exports.keypair = void 0;
+exports.findWithdrawAuthorityProgramAddress = exports.getAssociatedTokenAddress = exports.sysvarRecentBlockhashes = exports.nonceAccountSpace = exports.stakeAccountSpace = exports.stakePoolProgramId = exports.ataProgramId = exports.token2022ProgramId = exports.tokenProgramId = exports.memoProgramId = exports.computeBudgetProgramId = exports.stakeProgramId = exports.systemProgramId = exports.buildFromIntent = exports.buildFromVersionedData = exports.buildTransaction = exports.parseTransaction = exports.isVersionedTransaction = exports.VersionedTransaction = exports.Transaction = exports.Pubkey = exports.Keypair = exports.builder = exports.parser = exports.transaction = exports.pubkey = exports.keypair = void 0;
 const wasm = __importStar(require("./wasm/wasm_solana.js"));
 // Force webpack to include the WASM module
 void wasm;
@@ -60,6 +60,8 @@ Object.defineProperty(exports, "parseTransaction", { enumerable: true, get: func
 var builder_js_1 = require("./builder.js");
 Object.defineProperty(exports, "buildTransaction", { enumerable: true, get: function () { return builder_js_1.buildTransaction; } });
 Object.defineProperty(exports, "buildFromVersionedData", { enumerable: true, get: function () { return builder_js_1.buildFromVersionedData; } });
+var intentBuilder_js_1 = require("./intentBuilder.js");
+Object.defineProperty(exports, "buildFromIntent", { enumerable: true, get: function () { return intentBuilder_js_1.buildFromIntent; } });
 // Program ID constants (from WASM)
 var wasm_solana_js_1 = require("./wasm/wasm_solana.js");
 Object.defineProperty(exports, "systemProgramId", { enumerable: true, get: function () { return wasm_solana_js_1.system_program_id; } });

package/dist/cjs/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/cjs/js/intentBuilder.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * 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)
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFromIntent = buildFromIntent;
+const wasm_solana_js_1 = require("./wasm/wasm_solana.js");
+const transaction_js_1 = require("./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
+ * ```
+ */
+function buildFromIntent(intent, params) {
+    const result = wasm_solana_js_1.IntentNamespace.build_from_intent(intent, params);
+    return {
+        transaction: transaction_js_1.Transaction.fromWasm(result.transaction),
+        generatedKeypairs: result.generatedKeypairs,
+    };
+}

package/dist/cjs/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/cjs/js/keypair.js

@@ -13,6 +13,14 @@ 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 = wasm_solana_js_1.WasmKeypair.generate();
+        return new Keypair(wasm);
+    }
     /**
      * Create a keypair from a 32-byte secret key
      * @param secretKey - The 32-byte Ed25519 secret key

package/dist/cjs/js/transaction.d.ts

@@ -68,6 +68,20 @@ export declare class Transaction {
      * Get the number of signatures in the transaction
      */
     get numSignatures(): number;
+    /**
+     * Get the transaction ID (first signature as base58).
+     *
+     * For Solana, the transaction ID is the first signature.
+     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     *
+     * @example
+     * ```typescript
+     * const tx = Transaction.fromBytes(txBytes);
+     * tx.addSignature(pubkey, signature);
+     * console.log(tx.id); // Base58 encoded signature
+     * ```
+     */
+    get id(): string;
     /**
      * Get the signable message payload (what gets signed)
      * This is the serialized message that signers sign
@@ -86,6 +100,11 @@ export declare class Transaction {
      * @returns The serialized transaction bytes
      */
     toBytes(): Uint8Array;
+    /**
+     * Serialize to network broadcast format.
+     * @returns The transaction as bytes ready for broadcast
+     */
+    toBroadcastFormat(): Uint8Array;
     /**
      * Get all account keys as Pubkey instances
      * @returns Array of account public keys

package/dist/cjs/js/transaction.js

@@ -62,6 +62,22 @@ class Transaction {
     get numSignatures() {
         return this._wasm.num_signatures;
     }
+    /**
+     * Get the transaction ID (first signature as base58).
+     *
+     * For Solana, the transaction ID is the first signature.
+     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     *
+     * @example
+     * ```typescript
+     * const tx = Transaction.fromBytes(txBytes);
+     * tx.addSignature(pubkey, signature);
+     * console.log(tx.id); // Base58 encoded signature
+     * ```
+     */
+    get id() {
+        return this._wasm.id;
+    }
     /**
      * Get the signable message payload (what gets signed)
      * This is the serialized message that signers sign
@@ -86,6 +102,13 @@ class Transaction {
     toBytes() {
         return this._wasm.to_bytes();
     }
+    /**
+     * Serialize to network broadcast format.
+     * @returns The transaction as bytes ready for broadcast
+     */
+    toBroadcastFormat() {
+        return this.toBytes();
+    }
     /**
      * Get all account keys as Pubkey instances
      * @returns Array of account public keys

package/dist/cjs/js/versioned.d.ts

@@ -122,6 +122,13 @@ export declare class VersionedTransaction {
      * Get the number of signatures.
      */
     get numSignatures(): number;
+    /**
+     * Get the transaction ID (first signature as base58).
+     *
+     * For Solana, the transaction ID is the first signature.
+     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     */
+    get id(): string;
     /**
      * Get the signable message payload.
      */
@@ -141,6 +148,11 @@ export declare class VersionedTransaction {
      * Serialize the transaction to base64.
      */
     toBase64(): string;
+    /**
+     * Serialize to network broadcast format.
+     * @returns The transaction as bytes ready for broadcast
+     */
+    toBroadcastFormat(): Uint8Array;
     /**
      * Get static account keys (accounts stored directly in the message).
      * For versioned transactions, additional accounts may be referenced via ALTs.

package/dist/cjs/js/versioned.js

@@ -115,6 +115,15 @@ class VersionedTransaction {
     get numSignatures() {
         return this.inner.num_signatures;
     }
+    /**
+     * Get the transaction ID (first signature as base58).
+     *
+     * For Solana, the transaction ID is the first signature.
+     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     */
+    get id() {
+        return this.inner.id;
+    }
     /**
      * Get the signable message payload.
      */
@@ -142,6 +151,13 @@ class VersionedTransaction {
     toBase64() {
         return Buffer.from(this.toBytes()).toString("base64");
     }
+    /**
+     * Serialize to network broadcast format.
+     * @returns The transaction as bytes ready for broadcast
+     */
+    toBroadcastFormat() {
+        return this.toBytes();
+    }
     /**
      * Get static account keys (accounts stored directly in the message).
      * For versioned transactions, additional accounts may be referenced via ALTs.

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

@@ -372,6 +372,48 @@ export class Instructions {
   push(instruction: Instruction): void;
 }
 
+export class IntentNamespace {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * 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 }]
+   * ```
+   */
+  static build_from_intent(intent: any, params: any): any;
+}
+
 export class Keypair {
   free(): void;
   [Symbol.dispose](): void;
@@ -697,6 +739,10 @@ export class WasmKeypair {
    * Get the address as a base58 string.
    */
   address(): string;
+  /**
+   * Generate a new random keypair.
+   */
+  static generate(): WasmKeypair;
   /**
    * Get the public key as a base58 string.
    */
@@ -804,6 +850,13 @@ export class WasmTransaction {
    * Get the recent blockhash as a base58 string.
    */
   readonly recent_blockhash: string;
+  /**
+   * 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).
+   */
+  readonly id: string;
   /**
    * Get the fee payer address as a base58 string.
    *
@@ -891,6 +944,13 @@ export class WasmVersionedTransaction {
    * Get the recent blockhash as a base58 string.
    */
   readonly recent_blockhash: string;
+  /**
+   * 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).
+   */
+  readonly id: string;
   /**
    * Get the fee payer address as a base58 string.
    */