@bitgo-beta/sdk-coin-sol 7.6.4-beta.71 → 7.6.4-beta.710

package/dist/esm/lib/serialization/wire-transaction.js

@@ -0,0 +1,48 @@
+import { BuildTransactionError } from '@bitgo-beta/sdk-core';
+const SIGNATURE_BYTE_LENGTH = 64;
+const V1_VERSION_PREFIX = 0x81;
+const V1_TRANSACTION_SIZE_LIMIT = 4096;
+/**
+ * Assemble the v1 wire format of a signed transaction.
+ *
+ * Unlike legacy and v0 transactions, where signatures are prefixed before the
+ * message, a v1 transaction places the message first and appends the signatures
+ * at the tail with no length prefix; the signature count is derived from the
+ * message header's numRequiredSignatures.
+ *
+ * @param messageBytes - The serialized v1 message bytes (starting with the 0x81 version prefix)
+ * @param signatures - The ed25519 signatures over the message bytes, one per required signer
+ * @returns The full v1 wire transaction bytes
+ */
+export function serializeWireTransaction(messageBytes, signatures) {
+    if (!messageBytes || messageBytes.length === 0) {
+        throw new BuildTransactionError('messageBytes is required to serialize a v1 transaction');
+    }
+    if (!signatures || signatures.length === 0) {
+        throw new BuildTransactionError('At least one signature is required to serialize a v1 transaction');
+    }
+    for (const signature of signatures) {
+        if (signature.length !== SIGNATURE_BYTE_LENGTH) {
+            throw new BuildTransactionError(`Invalid signature length: expected ${SIGNATURE_BYTE_LENGTH} bytes, got ${signature.length}`);
+        }
+    }
+    if (messageBytes[0] !== V1_VERSION_PREFIX) {
+        throw new BuildTransactionError(`Invalid v1 message: expected version prefix 0x${V1_VERSION_PREFIX.toString(16)}, got 0x${messageBytes[0].toString(16)}`);
+    }
+    if (messageBytes[1] !== signatures.length) {
+        throw new BuildTransactionError(`Signature count mismatch: message declares ${messageBytes[1]} required signers but ${signatures.length} were provided`);
+    }
+    const totalLength = messageBytes.length + signatures.length * SIGNATURE_BYTE_LENGTH;
+    if (totalLength > V1_TRANSACTION_SIZE_LIMIT) {
+        throw new BuildTransactionError(`v1 transaction exceeds the ${V1_TRANSACTION_SIZE_LIMIT}-byte size limit: ${totalLength} bytes`);
+    }
+    const buffer = new Uint8Array(totalLength);
+    buffer.set(messageBytes, 0);
+    let offset = messageBytes.length;
+    for (const signature of signatures) {
+        buffer.set(signature, offset);
+        offset += SIGNATURE_BYTE_LENGTH;
+    }
+    return buffer;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2lyZS10cmFuc2FjdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9saWIvc2VyaWFsaXphdGlvbi93aXJlLXRyYW5zYWN0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRTdELE1BQU0scUJBQXFCLEdBQUcsRUFBRSxDQUFDO0FBQ2pDLE1BQU0saUJBQWlCLEdBQUcsSUFBSSxDQUFDO0FBQy9CLE1BQU0seUJBQXlCLEdBQUcsSUFBSSxDQUFDO0FBRXZDOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsTUFBTSxVQUFVLHdCQUF3QixDQUFDLFlBQXdCLEVBQUUsVUFBd0I7SUFDekYsSUFBSSxDQUFDLFlBQVksSUFBSSxZQUFZLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQy9DLE1BQU0sSUFBSSxxQkFBcUIsQ0FBQyx3REFBd0QsQ0FBQyxDQUFDO0lBQzVGLENBQUM7SUFDRCxJQUFJLENBQUMsVUFBVSxJQUFJLFVBQVUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDM0MsTUFBTSxJQUFJLHFCQUFxQixDQUFDLGtFQUFrRSxDQUFDLENBQUM7SUFDdEcsQ0FBQztJQUVELEtBQUssTUFBTSxTQUFTLElBQUksVUFBVSxFQUFFLENBQUM7UUFDbkMsSUFBSSxTQUFTLENBQUMsTUFBTSxLQUFLLHFCQUFxQixFQUFFLENBQUM7WUFDL0MsTUFBTSxJQUFJLHFCQUFxQixDQUM3QixzQ0FBc0MscUJBQXFCLGVBQWUsU0FBUyxDQUFDLE1BQU0sRUFBRSxDQUM3RixDQUFDO1FBQ0osQ0FBQztJQUNILENBQUM7SUFFRCxJQUFJLFlBQVksQ0FBQyxDQUFDLENBQUMsS0FBSyxpQkFBaUIsRUFBRSxDQUFDO1FBQzFDLE1BQU0sSUFBSSxxQkFBcUIsQ0FDN0IsaURBQWlELGlCQUFpQixDQUFDLFFBQVEsQ0FDekUsRUFBRSxDQUNILFdBQVcsWUFBWSxDQUFDLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUMzQyxDQUFDO0lBQ0osQ0FBQztJQUVELElBQUksWUFBWSxDQUFDLENBQUMsQ0FBQyxLQUFLLFVBQVUsQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUMxQyxNQUFNLElBQUkscUJBQXFCLENBQzdCLDhDQUE4QyxZQUFZLENBQUMsQ0FBQyxDQUFDLHlCQUF5QixVQUFVLENBQUMsTUFBTSxnQkFBZ0IsQ0FDeEgsQ0FBQztJQUNKLENBQUM7SUFFRCxNQUFNLFdBQVcsR0FBRyxZQUFZLENBQUMsTUFBTSxHQUFHLFVBQVUsQ0FBQyxNQUFNLEdBQUcscUJBQXFCLENBQUM7SUFDcEYsSUFBSSxXQUFXLEdBQUcseUJBQXlCLEVBQUUsQ0FBQztRQUM1QyxNQUFNLElBQUkscUJBQXFCLENBQzdCLDhCQUE4Qix5QkFBeUIscUJBQXFCLFdBQVcsUUFBUSxDQUNoRyxDQUFDO0lBQ0osQ0FBQztJQUVELE1BQU0sTUFBTSxHQUFHLElBQUksVUFBVSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBQzNDLE1BQU0sQ0FBQyxHQUFHLENBQUMsWUFBWSxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBRTVCLElBQUksTUFBTSxHQUFHLFlBQVksQ0FBQyxNQUFNLENBQUM7SUFDakMsS0FBSyxNQUFNLFNBQVMsSUFBSSxVQUFVLEVBQUUsQ0FBQztRQUNuQyxNQUFNLENBQUMsR0FBRyxDQUFDLFNBQVMsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUM5QixNQUFNLElBQUkscUJBQXFCLENBQUM7SUFDbEMsQ0FBQztJQUVELE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBCdWlsZFRyYW5zYWN0aW9uRXJyb3IgfSBmcm9tICdAYml0Z28tYmV0YS9zZGstY29yZSc7XG5cbmNvbnN0IFNJR05BVFVSRV9CWVRFX0xFTkdUSCA9IDY0O1xuY29uc3QgVjFfVkVSU0lPTl9QUkVGSVggPSAweDgxO1xuY29uc3QgVjFfVFJBTlNBQ1RJT05fU0laRV9MSU1JVCA9IDQwOTY7XG5cbi8qKlxuICogQXNzZW1ibGUgdGhlIHYxIHdpcmUgZm9ybWF0IG9mIGEgc2lnbmVkIHRyYW5zYWN0aW9uLlxuICpcbiAqIFVubGlrZSBsZWdhY3kgYW5kIHYwIHRyYW5zYWN0aW9ucywgd2hlcmUgc2lnbmF0dXJlcyBhcmUgcHJlZml4ZWQgYmVmb3JlIHRoZVxuICogbWVzc2FnZSwgYSB2MSB0cmFuc2FjdGlvbiBwbGFjZXMgdGhlIG1lc3NhZ2UgZmlyc3QgYW5kIGFwcGVuZHMgdGhlIHNpZ25hdHVyZXNcbiAqIGF0IHRoZSB0YWlsIHdpdGggbm8gbGVuZ3RoIHByZWZpeDsgdGhlIHNpZ25hdHVyZSBjb3VudCBpcyBkZXJpdmVkIGZyb20gdGhlXG4gKiBtZXNzYWdlIGhlYWRlcidzIG51bVJlcXVpcmVkU2lnbmF0dXJlcy5cbiAqXG4gKiBAcGFyYW0gbWVzc2FnZUJ5dGVzIC0gVGhlIHNlcmlhbGl6ZWQgdjEgbWVzc2FnZSBieXRlcyAoc3RhcnRpbmcgd2l0aCB0aGUgMHg4MSB2ZXJzaW9uIHByZWZpeClcbiAqIEBwYXJhbSBzaWduYXR1cmVzIC0gVGhlIGVkMjU1MTkgc2lnbmF0dXJlcyBvdmVyIHRoZSBtZXNzYWdlIGJ5dGVzLCBvbmUgcGVyIHJlcXVpcmVkIHNpZ25lclxuICogQHJldHVybnMgVGhlIGZ1bGwgdjEgd2lyZSB0cmFuc2FjdGlvbiBieXRlc1xuICovXG5leHBvcnQgZnVuY3Rpb24gc2VyaWFsaXplV2lyZVRyYW5zYWN0aW9uKG1lc3NhZ2VCeXRlczogVWludDhBcnJheSwgc2lnbmF0dXJlczogVWludDhBcnJheVtdKTogVWludDhBcnJheSB7XG4gIGlmICghbWVzc2FnZUJ5dGVzIHx8IG1lc3NhZ2VCeXRlcy5sZW5ndGggPT09IDApIHtcbiAgICB0aHJvdyBuZXcgQnVpbGRUcmFuc2FjdGlvbkVycm9yKCdtZXNzYWdlQnl0ZXMgaXMgcmVxdWlyZWQgdG8gc2VyaWFsaXplIGEgdjEgdHJhbnNhY3Rpb24nKTtcbiAgfVxuICBpZiAoIXNpZ25hdHVyZXMgfHwgc2lnbmF0dXJlcy5sZW5ndGggPT09IDApIHtcbiAgICB0aHJvdyBuZXcgQnVpbGRUcmFuc2FjdGlvbkVycm9yKCdBdCBsZWFzdCBvbmUgc2lnbmF0dXJlIGlzIHJlcXVpcmVkIHRvIHNlcmlhbGl6ZSBhIHYxIHRyYW5zYWN0aW9uJyk7XG4gIH1cblxuICBmb3IgKGNvbnN0IHNpZ25hdHVyZSBvZiBzaWduYXR1cmVzKSB7XG4gICAgaWYgKHNpZ25hdHVyZS5sZW5ndGggIT09IFNJR05BVFVSRV9CWVRFX0xFTkdUSCkge1xuICAgICAgdGhyb3cgbmV3IEJ1aWxkVHJhbnNhY3Rpb25FcnJvcihcbiAgICAgICAgYEludmFsaWQgc2lnbmF0dXJlIGxlbmd0aDogZXhwZWN0ZWQgJHtTSUdOQVRVUkVfQllURV9MRU5HVEh9IGJ5dGVzLCBnb3QgJHtzaWduYXR1cmUubGVuZ3RofWBcbiAgICAgICk7XG4gICAgfVxuICB9XG5cbiAgaWYgKG1lc3NhZ2VCeXRlc1swXSAhPT0gVjFfVkVSU0lPTl9QUkVGSVgpIHtcbiAgICB0aHJvdyBuZXcgQnVpbGRUcmFuc2FjdGlvbkVycm9yKFxuICAgICAgYEludmFsaWQgdjEgbWVzc2FnZTogZXhwZWN0ZWQgdmVyc2lvbiBwcmVmaXggMHgke1YxX1ZFUlNJT05fUFJFRklYLnRvU3RyaW5nKFxuICAgICAgICAxNlxuICAgICAgKX0sIGdvdCAweCR7bWVzc2FnZUJ5dGVzWzBdLnRvU3RyaW5nKDE2KX1gXG4gICAgKTtcbiAgfVxuXG4gIGlmIChtZXNzYWdlQnl0ZXNbMV0gIT09IHNpZ25hdHVyZXMubGVuZ3RoKSB7XG4gICAgdGhyb3cgbmV3IEJ1aWxkVHJhbnNhY3Rpb25FcnJvcihcbiAgICAgIGBTaWduYXR1cmUgY291bnQgbWlzbWF0Y2g6IG1lc3NhZ2UgZGVjbGFyZXMgJHttZXNzYWdlQnl0ZXNbMV19IHJlcXVpcmVkIHNpZ25lcnMgYnV0ICR7c2lnbmF0dXJlcy5sZW5ndGh9IHdlcmUgcHJvdmlkZWRgXG4gICAgKTtcbiAgfVxuXG4gIGNvbnN0IHRvdGFsTGVuZ3RoID0gbWVzc2FnZUJ5dGVzLmxlbmd0aCArIHNpZ25hdHVyZXMubGVuZ3RoICogU0lHTkFUVVJFX0JZVEVfTEVOR1RIO1xuICBpZiAodG90YWxMZW5ndGggPiBWMV9UUkFOU0FDVElPTl9TSVpFX0xJTUlUKSB7XG4gICAgdGhyb3cgbmV3IEJ1aWxkVHJhbnNhY3Rpb25FcnJvcihcbiAgICAgIGB2MSB0cmFuc2FjdGlvbiBleGNlZWRzIHRoZSAke1YxX1RSQU5TQUNUSU9OX1NJWkVfTElNSVR9LWJ5dGUgc2l6ZSBsaW1pdDogJHt0b3RhbExlbmd0aH0gYnl0ZXNgXG4gICAgKTtcbiAgfVxuXG4gIGNvbnN0IGJ1ZmZlciA9IG5ldyBVaW50OEFycmF5KHRvdGFsTGVuZ3RoKTtcbiAgYnVmZmVyLnNldChtZXNzYWdlQnl0ZXMsIDApO1xuXG4gIGxldCBvZmZzZXQgPSBtZXNzYWdlQnl0ZXMubGVuZ3RoO1xuICBmb3IgKGNvbnN0IHNpZ25hdHVyZSBvZiBzaWduYXR1cmVzKSB7XG4gICAgYnVmZmVyLnNldChzaWduYXR1cmUsIG9mZnNldCk7XG4gICAgb2Zmc2V0ICs9IFNJR05BVFVSRV9CWVRFX0xFTkdUSDtcbiAgfVxuXG4gIHJldHVybiBidWZmZXI7XG59XG4iXX0=

package/dist/esm/lib/solInstructionFactory.d.ts

@@ -0,0 +1,10 @@
+import { TransactionInstruction } from '@solana/web3.js';
+import { InstructionParams } from './iface';
+/**
+ * Construct Solana instructions from instructions params
+ *
+ * @param {InstructionParams} instructionToBuild - the data containing the instruction params
+ * @returns {TransactionInstruction[]} An array containing supported Solana instructions
+ */
+export declare function solInstructionFactory(instructionToBuild: InstructionParams, zkProofProgramId?: string): TransactionInstruction[];
+//# sourceMappingURL=solInstructionFactory.d.ts.map

package/dist/esm/lib/solInstructionFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solInstructionFactory.d.ts","sourceRoot":"","sources":["../../../src/lib/solInstructionFactory.ts"],"names":[],"mappings":"AAeA,OAAO,EASL,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EAUL,iBAAiB,EAsBlB,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,iBAAiB,EACrC,gBAAgB,CAAC,EAAE,MAAM,GACxB,sBAAsB,EAAE,CA+D1B"}