bulk-keychain-wasm 0.1.27 → 0.1.28

package/bulk_keychain_wasm.d.ts

@@ -1,6 +1,18 @@
 /* tslint:disable */
 /* eslint-disable */
 
+export interface SolanaInstruction {
+    programId: string;
+    accounts: Array<{ pubkey: string; isSigner: boolean; isWritable: boolean }>;
+    data: number[];
+}
+/** Mainnet USDC only; amount is an exact decimal u64 string in base units. */
+export function buildDepositInstruction(owner: string, amount: string): SolanaInstruction;
+/** Signals a mainnet USDC withdrawal; this instruction transfers no tokens. */
+export function buildWithdrawIntentInstruction(owner: string, amount: string): SolanaInstruction;
+
+
+
 /**
  * WASM wrapper for Keypair
  */
@@ -16,9 +28,9 @@ export class WasmKeypair {
      */
     static fromBytes(bytes: Uint8Array): WasmKeypair;
     /**
-     * Generate a new random keypair
+     * Import a base58 key or Uint8Array (32/64 bytes); omitted key generates a random keypair.
      */
-    constructor();
+    constructor(key?: string | Uint8Array);
     /**
      * Get the secret key as bytes (32 bytes)
      */
@@ -253,6 +265,10 @@ export class WasmSigner {
      * Sign user settings update
      */
     signUserSettings(settings: any, nonce?: string | null): any;
+    /**
+     * Sign an explicit wallet mode using this signer's key and configured network.
+     */
+    signWalletPrepared(wallet: WasmWalletPreparedMessage): any;
     /**
      * Sign whitelist/un-whitelist faucet access (`whitelistFaucet`)
      */
@@ -271,6 +287,19 @@ export class WasmSigner {
     readonly pubkey: string;
 }
 
+/**
+ * Explicit wallet signing bytes and the retained original Bulk preparation.
+ */
+export class WasmWalletPreparedMessage {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly clearSignMessage: string | undefined;
+    readonly messageBytes: Uint8Array;
+    readonly prepared: WasmPreparedMessage;
+    readonly signatureMode: string;
+}
+
 /**
  * Compute SHA256 hash from raw bytes.
  *
@@ -283,6 +312,16 @@ export function computeOrderId(wincode_bytes: Uint8Array): string;
  */
 export function currentTimestamp(): string;
 
+/**
+ * Export a base64 unsigned mainnet USDC deposit transaction for wallet signing.
+ */
+export function exportDepositTransaction(owner: string, amount: string, recent_blockhash: string): string;
+
+/**
+ * Export a base64 unsigned mainnet USDC withdrawal-intent transaction for wallet signing.
+ */
+export function exportWithdrawIntentTransaction(owner: string, amount: string, recent_blockhash: string): string;
+
 /**
  * Finalize a prepared message with a signature
  *
@@ -291,6 +330,8 @@ export function currentTimestamp(): string;
  */
 export function finalizeTransaction(prepared: any, signature: string): any;
 
+export function finalizeWalletMessage(wallet: WasmWalletPreparedMessage, signature: string): any;
+
 /**
  * Initialize the WASM module
  */
@@ -468,6 +509,8 @@ export function prepareUpdateMultisigPolicy(multisig: string, signers: any, thre
  */
 export function prepareUpdateUserSettings(settings: any, options: any): WasmPreparedMessage;
 
+export function prepareWalletMessage(prepared: WasmPreparedMessage, mode: string): WasmWalletPreparedMessage;
+
 /**
  * Prepare a portfolio withdraw for external signing
  *
@@ -511,9 +554,15 @@ export interface InitOutput {
     readonly __wbg_wasmkeypair_free: (a: number, b: number) => void;
     readonly __wbg_wasmpreparedmessage_free: (a: number, b: number) => void;
     readonly __wbg_wasmsigner_free: (a: number, b: number) => void;
+    readonly __wbg_wasmwalletpreparedmessage_free: (a: number, b: number) => void;
+    readonly buildDepositInstruction: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly buildWithdrawIntentInstruction: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly computeOrderId: (a: number, b: number) => [number, number];
     readonly currentTimestamp: () => [number, number];
+    readonly exportDepositTransaction: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly exportWithdrawIntentTransaction: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly finalizeTransaction: (a: any, b: number, c: number) => [number, number, number];
+    readonly finalizeWalletMessage: (a: number, b: number, c: number) => [number, number, number];
     readonly init: () => void;
     readonly prepareAgentWallet: (a: number, b: number, c: number, d: any) => [number, number, number];
     readonly prepareAll: (a: any, b: any) => [number, number, number, number];
@@ -537,6 +586,7 @@ export interface InitOutput {
     readonly prepareUpdateLiquidatorConfig: (a: any, b: any) => [number, number, number];
     readonly prepareUpdateMultisigPolicy: (a: number, b: number, c: any, d: number, e: any) => [number, number, number];
     readonly prepareUpdateUserSettings: (a: any, b: any) => [number, number, number];
+    readonly prepareWalletMessage: (a: number, b: number, c: number) => [number, number, number];
     readonly prepareWithdraw: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: any) => [number, number, number];
     readonly prepareWithdrawLockRecover: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
     readonly randomHash: () => [number, number];
@@ -544,15 +594,15 @@ export interface InitOutput {
     readonly validatePubkey: (a: number, b: number) => number;
     readonly wasmkeypair_fromBase58: (a: number, b: number) => [number, number, number];
     readonly wasmkeypair_fromBytes: (a: number, b: number) => [number, number, number];
-    readonly wasmkeypair_new: () => number;
+    readonly wasmkeypair_new: (a: any) => [number, number, number];
     readonly wasmkeypair_pubkey: (a: number) => [number, number];
     readonly wasmkeypair_secretKey: (a: number) => [number, number];
     readonly wasmkeypair_toBase58: (a: number) => [number, number];
     readonly wasmkeypair_toBytes: (a: number) => [number, number];
     readonly wasmpreparedmessage_account: (a: number) => [number, number];
     readonly wasmpreparedmessage_actions: (a: number) => any;
-    readonly wasmpreparedmessage_finalize: (a: number, b: number, c: number) => any;
-    readonly wasmpreparedmessage_finalizeBytes: (a: number, b: number, c: number) => any;
+    readonly wasmpreparedmessage_finalize: (a: number, b: number, c: number) => [number, number, number];
+    readonly wasmpreparedmessage_finalizeBytes: (a: number, b: number, c: number) => [number, number, number];
     readonly wasmpreparedmessage_messageBase58: (a: number) => [number, number];
     readonly wasmpreparedmessage_messageBase64: (a: number) => [number, number];
     readonly wasmpreparedmessage_messageBytes: (a: number) => [number, number];
@@ -596,8 +646,13 @@ export interface InitOutput {
     readonly wasmsigner_signUpdateLiquidatorConfig: (a: number, b: any, c: number, d: number) => [number, number, number];
     readonly wasmsigner_signUpdateMultisigPolicy: (a: number, b: number, c: number, d: any, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
     readonly wasmsigner_signUserSettings: (a: number, b: any, c: number, d: number) => [number, number, number];
+    readonly wasmsigner_signWalletPrepared: (a: number, b: number) => [number, number, number];
     readonly wasmsigner_signWhitelistFaucet: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number];
     readonly wasmsigner_withNonceManager: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly wasmwalletpreparedmessage_clearSignMessage: (a: number) => [number, number];
+    readonly wasmwalletpreparedmessage_messageBytes: (a: number) => [number, number];
+    readonly wasmwalletpreparedmessage_prepared: (a: number) => number;
+    readonly wasmwalletpreparedmessage_signatureMode: (a: number) => [number, number];
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_exn_store: (a: number) => void;

package/bulk_keychain_wasm.js

@@ -49,11 +49,15 @@ export class WasmKeypair {
         return WasmKeypair.__wrap(ret[0]);
     }
     /**
-     * Generate a new random keypair
+     * Import a base58 key or Uint8Array (32/64 bytes); omitted key generates a random keypair.
+     * @param {string | Uint8Array} [key]
      */
-    constructor() {
-        const ret = wasm.wasmkeypair_new();
-        this.__wbg_ptr = ret;
+    constructor(key) {
+        const ret = wasm.wasmkeypair_new(key);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
         WasmKeypairFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
@@ -168,7 +172,10 @@ export class WasmPreparedMessage {
         const ptr0 = passArray8ToWasm0(signature, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
         const ret = wasm.wasmpreparedmessage_finalizeBytes(this.__wbg_ptr, ptr0, len0);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
      * Finalize with a signature (base58 string)
@@ -181,7 +188,10 @@ export class WasmPreparedMessage {
         const ptr0 = passStringToWasm0(signature, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         const ret = wasm.wasmpreparedmessage_finalize(this.__wbg_ptr, ptr0, len0);
-        return ret;
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
      * Get message as base58 string
@@ -880,6 +890,19 @@ export class WasmSigner {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Sign an explicit wallet mode using this signer's key and configured network.
+     * @param {WasmWalletPreparedMessage} wallet
+     * @returns {any}
+     */
+    signWalletPrepared(wallet) {
+        _assertClass(wallet, WasmWalletPreparedMessage);
+        const ret = wasm.wasmsigner_signWalletPrepared(this.__wbg_ptr, wallet.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Sign whitelist/un-whitelist faucet access (`whitelistFaucet`)
      * @param {string} target_pubkey
@@ -935,6 +958,108 @@ export class WasmSigner {
 }
 if (Symbol.dispose) WasmSigner.prototype[Symbol.dispose] = WasmSigner.prototype.free;
 
+/**
+ * Explicit wallet signing bytes and the retained original Bulk preparation.
+ */
+export class WasmWalletPreparedMessage {
+    static __wrap(ptr) {
+        const obj = Object.create(WasmWalletPreparedMessage.prototype);
+        obj.__wbg_ptr = ptr;
+        WasmWalletPreparedMessageFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        WasmWalletPreparedMessageFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_wasmwalletpreparedmessage_free(ptr, 0);
+    }
+    /**
+     * @returns {string | undefined}
+     */
+    get clearSignMessage() {
+        const ret = wasm.wasmwalletpreparedmessage_clearSignMessage(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]);
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
+    /**
+     * @returns {Uint8Array}
+     */
+    get messageBytes() {
+        const ret = wasm.wasmwalletpreparedmessage_messageBytes(this.__wbg_ptr);
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * @returns {WasmPreparedMessage}
+     */
+    get prepared() {
+        const ret = wasm.wasmwalletpreparedmessage_prepared(this.__wbg_ptr);
+        return WasmPreparedMessage.__wrap(ret);
+    }
+    /**
+     * @returns {string}
+     */
+    get signatureMode() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmwalletpreparedmessage_signatureMode(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+}
+if (Symbol.dispose) WasmWalletPreparedMessage.prototype[Symbol.dispose] = WasmWalletPreparedMessage.prototype.free;
+
+/**
+ * Build an unsigned mainnet USDC deposit instruction from an exact base-unit amount.
+ * @param {string} owner
+ * @param {string} amount
+ * @returns {any}
+ */
+export function buildDepositInstruction(owner, amount) {
+    const ptr0 = passStringToWasm0(owner, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(amount, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.buildDepositInstruction(ptr0, len0, ptr1, len1);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * Build an unsigned mainnet USDC withdrawal intent; no tokens transfer in this instruction.
+ * @param {string} owner
+ * @param {string} amount
+ * @returns {any}
+ */
+export function buildWithdrawIntentInstruction(owner, amount) {
+    const ptr0 = passStringToWasm0(owner, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(amount, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.buildWithdrawIntentInstruction(ptr0, len0, ptr1, len1);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Compute SHA256 hash from raw bytes.
  *
@@ -974,6 +1099,70 @@ export function currentTimestamp() {
     }
 }
 
+/**
+ * Export a base64 unsigned mainnet USDC deposit transaction for wallet signing.
+ * @param {string} owner
+ * @param {string} amount
+ * @param {string} recent_blockhash
+ * @returns {string}
+ */
+export function exportDepositTransaction(owner, amount, recent_blockhash) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(owner, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(amount, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(recent_blockhash, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ret = wasm.exportDepositTransaction(ptr0, len0, ptr1, len1, ptr2, len2);
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
+/**
+ * Export a base64 unsigned mainnet USDC withdrawal-intent transaction for wallet signing.
+ * @param {string} owner
+ * @param {string} amount
+ * @param {string} recent_blockhash
+ * @returns {string}
+ */
+export function exportWithdrawIntentTransaction(owner, amount, recent_blockhash) {
+    let deferred5_0;
+    let deferred5_1;
+    try {
+        const ptr0 = passStringToWasm0(owner, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(amount, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ptr2 = passStringToWasm0(recent_blockhash, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len2 = WASM_VECTOR_LEN;
+        const ret = wasm.exportWithdrawIntentTransaction(ptr0, len0, ptr1, len1, ptr2, len2);
+        var ptr4 = ret[0];
+        var len4 = ret[1];
+        if (ret[3]) {
+            ptr4 = 0; len4 = 0;
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        deferred5_0 = ptr4;
+        deferred5_1 = len4;
+        return getStringFromWasm0(ptr4, len4);
+    } finally {
+        wasm.__wbindgen_free(deferred5_0, deferred5_1, 1);
+    }
+}
+
 /**
  * Finalize a prepared message with a signature
  *
@@ -993,6 +1182,22 @@ export function finalizeTransaction(prepared, signature) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * @param {WasmWalletPreparedMessage} wallet
+ * @param {string} signature
+ * @returns {any}
+ */
+export function finalizeWalletMessage(wallet, signature) {
+    _assertClass(wallet, WasmWalletPreparedMessage);
+    const ptr0 = passStringToWasm0(signature, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.finalizeWalletMessage(wallet.__wbg_ptr, ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Initialize the WASM module
  */
@@ -1419,6 +1624,22 @@ export function prepareUpdateUserSettings(settings, options) {
     return WasmPreparedMessage.__wrap(ret[0]);
 }
 
+/**
+ * @param {WasmPreparedMessage} prepared
+ * @param {string} mode
+ * @returns {WasmWalletPreparedMessage}
+ */
+export function prepareWalletMessage(prepared, mode) {
+    _assertClass(prepared, WasmPreparedMessage);
+    const ptr0 = passStringToWasm0(mode, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.prepareWalletMessage(prepared.__wbg_ptr, ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return WasmWalletPreparedMessage.__wrap(ret[0]);
+}
+
 /**
  * Prepare a portfolio withdraw for external signing
  *
@@ -1858,6 +2079,9 @@ const WasmPreparedMessageFinalization = (typeof FinalizationRegistry === 'undefi
 const WasmSignerFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_wasmsigner_free(ptr, 1));
+const WasmWalletPreparedMessageFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_wasmwalletpreparedmessage_free(ptr, 1));
 
 function addToExternrefTable0(obj) {
     const idx = wasm.__externref_table_alloc();

package/package.json

@@ -2,7 +2,7 @@
   "name": "bulk-keychain-wasm",
   "type": "module",
   "description": "WASM bindings for BULK txn signing",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "repository": {
     "type": "git",
     "url": "https://github.com/Bulk-trade/bulk-keychain"