@bitgo-beta/sdk-coin-sol 7.6.4-beta.73 → 7.6.4-beta.731

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

@@ -0,0 +1,21 @@
+import { BaseCoin as CoinConfig } from '@bitgo-beta/statics';
+import { TransactionType } from '@bitgo-beta/sdk-core';
+import { V1TransactionBuilder } from './v1TransactionBuilder';
+/**
+ * Transaction builder for Solana v1 (SIMD-0296/0385) custom instructions.
+ *
+ * Concrete subclass of the abstract {@link V1TransactionBuilder} for `customTx`
+ * intents — the surface Wallet Platform instantiates to assemble v1 transactions
+ * from a client-supplied envelope: feed each envelope instruction as a web3.js
+ * `TransactionInstruction` via {@link V1TransactionBuilder.addInstruction}, set the
+ * fee payer via {@link V1TransactionBuilder.sender}, optional durable nonce via
+ * {@link V1TransactionBuilder.nonce}, and the v1 config via
+ * {@link V1TransactionBuilder.transactionConfig}. The builder owns the
+ * `AdvanceNonceAccount` injection, the message compile, and the message-signer-order
+ * signature assembly.
+ */
+export declare class V1CustomInstructionBuilder extends V1TransactionBuilder {
+    constructor(_coinConfig: Readonly<CoinConfig>);
+    protected get transactionType(): TransactionType;
+}
+//# sourceMappingURL=v1CustomInstructionBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v1CustomInstructionBuilder.d.ts","sourceRoot":"","sources":["../../../src/lib/v1CustomInstructionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,qBAAa,0BAA2B,SAAQ,oBAAoB;gBACtD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC;IAI7C,SAAS,KAAK,eAAe,IAAI,eAAe,CAE/C;CACF"}

package/dist/esm/lib/v1CustomInstructionBuilder.js

@@ -0,0 +1,24 @@
+import { TransactionType } from '@bitgo-beta/sdk-core';
+import { V1TransactionBuilder } from './v1TransactionBuilder';
+/**
+ * Transaction builder for Solana v1 (SIMD-0296/0385) custom instructions.
+ *
+ * Concrete subclass of the abstract {@link V1TransactionBuilder} for `customTx`
+ * intents — the surface Wallet Platform instantiates to assemble v1 transactions
+ * from a client-supplied envelope: feed each envelope instruction as a web3.js
+ * `TransactionInstruction` via {@link V1TransactionBuilder.addInstruction}, set the
+ * fee payer via {@link V1TransactionBuilder.sender}, optional durable nonce via
+ * {@link V1TransactionBuilder.nonce}, and the v1 config via
+ * {@link V1TransactionBuilder.transactionConfig}. The builder owns the
+ * `AdvanceNonceAccount` injection, the message compile, and the message-signer-order
+ * signature assembly.
+ */
+export class V1CustomInstructionBuilder extends V1TransactionBuilder {
+    constructor(_coinConfig) {
+        super(_coinConfig);
+    }
+    get transactionType() {
+        return TransactionType.CustomTx;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidjFDdXN0b21JbnN0cnVjdGlvbkJ1aWxkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL3YxQ3VzdG9tSW5zdHJ1Y3Rpb25CdWlsZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUN2RCxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUU5RDs7Ozs7Ozs7Ozs7O0dBWUc7QUFDSCxNQUFNLE9BQU8sMEJBQTJCLFNBQVEsb0JBQW9CO0lBQ2xFLFlBQVksV0FBaUM7UUFDM0MsS0FBSyxDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBQ3JCLENBQUM7SUFFRCxJQUFjLGVBQWU7UUFDM0IsT0FBTyxlQUFlLENBQUMsUUFBUSxDQUFDO0lBQ2xDLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEJhc2VDb2luIGFzIENvaW5Db25maWcgfSBmcm9tICdAYml0Z28tYmV0YS9zdGF0aWNzJztcbmltcG9ydCB7IFRyYW5zYWN0aW9uVHlwZSB9IGZyb20gJ0BiaXRnby1iZXRhL3Nkay1jb3JlJztcbmltcG9ydCB7IFYxVHJhbnNhY3Rpb25CdWlsZGVyIH0gZnJvbSAnLi92MVRyYW5zYWN0aW9uQnVpbGRlcic7XG5cbi8qKlxuICogVHJhbnNhY3Rpb24gYnVpbGRlciBmb3IgU29sYW5hIHYxIChTSU1ELTAyOTYvMDM4NSkgY3VzdG9tIGluc3RydWN0aW9ucy5cbiAqXG4gKiBDb25jcmV0ZSBzdWJjbGFzcyBvZiB0aGUgYWJzdHJhY3Qge0BsaW5rIFYxVHJhbnNhY3Rpb25CdWlsZGVyfSBmb3IgYGN1c3RvbVR4YFxuICogaW50ZW50cyDigJQgdGhlIHN1cmZhY2UgV2FsbGV0IFBsYXRmb3JtIGluc3RhbnRpYXRlcyB0byBhc3NlbWJsZSB2MSB0cmFuc2FjdGlvbnNcbiAqIGZyb20gYSBjbGllbnQtc3VwcGxpZWQgZW52ZWxvcGU6IGZlZWQgZWFjaCBlbnZlbG9wZSBpbnN0cnVjdGlvbiBhcyBhIHdlYjMuanNcbiAqIGBUcmFuc2FjdGlvbkluc3RydWN0aW9uYCB2aWEge0BsaW5rIFYxVHJhbnNhY3Rpb25CdWlsZGVyLmFkZEluc3RydWN0aW9ufSwgc2V0IHRoZVxuICogZmVlIHBheWVyIHZpYSB7QGxpbmsgVjFUcmFuc2FjdGlvbkJ1aWxkZXIuc2VuZGVyfSwgb3B0aW9uYWwgZHVyYWJsZSBub25jZSB2aWFcbiAqIHtAbGluayBWMVRyYW5zYWN0aW9uQnVpbGRlci5ub25jZX0sIGFuZCB0aGUgdjEgY29uZmlnIHZpYVxuICoge0BsaW5rIFYxVHJhbnNhY3Rpb25CdWlsZGVyLnRyYW5zYWN0aW9uQ29uZmlnfS4gVGhlIGJ1aWxkZXIgb3ducyB0aGVcbiAqIGBBZHZhbmNlTm9uY2VBY2NvdW50YCBpbmplY3Rpb24sIHRoZSBtZXNzYWdlIGNvbXBpbGUsIGFuZCB0aGUgbWVzc2FnZS1zaWduZXItb3JkZXJcbiAqIHNpZ25hdHVyZSBhc3NlbWJseS5cbiAqL1xuZXhwb3J0IGNsYXNzIFYxQ3VzdG9tSW5zdHJ1Y3Rpb25CdWlsZGVyIGV4dGVuZHMgVjFUcmFuc2FjdGlvbkJ1aWxkZXIge1xuICBjb25zdHJ1Y3RvcihfY29pbkNvbmZpZzogUmVhZG9ubHk8Q29pbkNvbmZpZz4pIHtcbiAgICBzdXBlcihfY29pbkNvbmZpZyk7XG4gIH1cblxuICBwcm90ZWN0ZWQgZ2V0IHRyYW5zYWN0aW9uVHlwZSgpOiBUcmFuc2FjdGlvblR5cGUge1xuICAgIHJldHVybiBUcmFuc2FjdGlvblR5cGUuQ3VzdG9tVHg7XG4gIH1cbn1cbiJdfQ==

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

@@ -0,0 +1,36 @@
+import { BaseCoin as CoinConfig } from '@bitgo-beta/statics';
+import { TransactionType } from '@bitgo-beta/sdk-core';
+import { V1TransactionBuilder } from './v1TransactionBuilder';
+import { Transaction } from './transaction';
+export interface SendParams {
+    address: string;
+    amount: string;
+}
+/**
+ * Transaction builder for Solana v1 (SIMD-0296/0385) native SOL payments.
+ *
+ * Server-side construction surface: builds a v1 payment envelope from
+ * structured params (sender + recipients/amounts) — the caller supplies fields,
+ * never instructions. The builder owns the `AdvanceNonceAccount` injection, the
+ * message compile, and the message-signer-order signature assembly (inherited
+ * from {@link V1TransactionBuilder}); set the fee payer via
+ * {@link V1TransactionBuilder.sender}, optional durable nonce via
+ * {@link V1TransactionBuilder.nonce}, and the v1 config via
+ * {@link V1TransactionBuilder.transactionConfig}.
+ */
+export declare class V1PaymentBuilder extends V1TransactionBuilder {
+    private _sendParams;
+    constructor(_coinConfig: Readonly<CoinConfig>);
+    protected get transactionType(): TransactionType;
+    /**
+     * Set a transfer.
+     *
+     * @param {string} address - the receiver address
+     * @param {string} amount - the amount sent (lamports)
+     * @returns {V1PaymentBuilder} This transaction builder
+     */
+    send({ address, amount }: SendParams): this;
+    /** @inheritdoc */
+    protected buildImplementation(): Promise<Transaction>;
+}
+//# sourceMappingURL=v1PaymentBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v1PaymentBuilder.d.ts","sourceRoot":"","sources":["../../../src/lib/v1PaymentBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAyB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;IACxD,OAAO,CAAC,WAAW,CAAoB;gBAE3B,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC;IAI7C,SAAS,KAAK,eAAe,IAAI,eAAe,CAE/C;IAED;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,GAAG,IAAI;IAc3C,kBAAkB;cACF,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAAC;CAmB5D"}

package/dist/esm/lib/v1PaymentBuilder.js

@@ -0,0 +1,63 @@
+import { BuildTransactionError, TransactionType } from '@bitgo-beta/sdk-core';
+import { V1TransactionBuilder } from './v1TransactionBuilder';
+import { isValidAmount, validateAddress } from './utils';
+import { InstructionBuilderTypes } from './constants';
+import assert from 'assert';
+/**
+ * Transaction builder for Solana v1 (SIMD-0296/0385) native SOL payments.
+ *
+ * Server-side construction surface: builds a v1 payment envelope from
+ * structured params (sender + recipients/amounts) — the caller supplies fields,
+ * never instructions. The builder owns the `AdvanceNonceAccount` injection, the
+ * message compile, and the message-signer-order signature assembly (inherited
+ * from {@link V1TransactionBuilder}); set the fee payer via
+ * {@link V1TransactionBuilder.sender}, optional durable nonce via
+ * {@link V1TransactionBuilder.nonce}, and the v1 config via
+ * {@link V1TransactionBuilder.transactionConfig}.
+ */
+export class V1PaymentBuilder extends V1TransactionBuilder {
+    constructor(_coinConfig) {
+        super(_coinConfig);
+        this._sendParams = [];
+    }
+    get transactionType() {
+        return TransactionType.Send;
+    }
+    /**
+     * Set a transfer.
+     *
+     * @param {string} address - the receiver address
+     * @param {string} amount - the amount sent (lamports)
+     * @returns {V1PaymentBuilder} This transaction builder
+     */
+    send({ address, amount }) {
+        validateAddress(address, 'address');
+        if (!amount || !isValidAmount(amount)) {
+            throw new BuildTransactionError('Invalid or missing amount, got: ' + amount);
+        }
+        if (BigInt(amount) > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new BuildTransactionError(`input amount ${amount} exceeds max safe int ${Number.MAX_SAFE_INTEGER}`);
+        }
+        this._sendParams.push({ address, amount });
+        return this;
+    }
+    /** @inheritdoc */
+    async buildImplementation() {
+        assert(this._sender, 'Sender must be set before building the transaction');
+        const transferData = this._sendParams.map((sendParams) => {
+            return {
+                type: InstructionBuilderTypes.Transfer,
+                params: {
+                    fromAddress: this._sender,
+                    toAddress: sendParams.address,
+                    amount: sendParams.amount,
+                },
+            };
+        });
+        // v1: the priority fee is carried in the message config mask (transactionConfig),
+        // so no explicit SetPriorityFee instruction is needed (unlike the v0 flow).
+        this.instructions(transferData);
+        return await super.buildImplementation();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidjFQYXltZW50QnVpbGRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvdjFQYXltZW50QnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUscUJBQXFCLEVBQUUsZUFBZSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDOUUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFOUQsT0FBTyxFQUFFLGFBQWEsRUFBRSxlQUFlLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDekQsT0FBTyxFQUFFLHVCQUF1QixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBR3RELE9BQU8sTUFBTSxNQUFNLFFBQVEsQ0FBQztBQU81Qjs7Ozs7Ozs7Ozs7R0FXRztBQUNILE1BQU0sT0FBTyxnQkFBaUIsU0FBUSxvQkFBb0I7SUFHeEQsWUFBWSxXQUFpQztRQUMzQyxLQUFLLENBQUMsV0FBVyxDQUFDLENBQUM7UUFIYixnQkFBVyxHQUFpQixFQUFFLENBQUM7SUFJdkMsQ0FBQztJQUVELElBQWMsZUFBZTtRQUMzQixPQUFPLGVBQWUsQ0FBQyxJQUFJLENBQUM7SUFDOUIsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNILElBQUksQ0FBQyxFQUFFLE9BQU8sRUFBRSxNQUFNLEVBQWM7UUFDbEMsZUFBZSxDQUFDLE9BQU8sRUFBRSxTQUFTLENBQUMsQ0FBQztRQUNwQyxJQUFJLENBQUMsTUFBTSxJQUFJLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDdEMsTUFBTSxJQUFJLHFCQUFxQixDQUFDLGtDQUFrQyxHQUFHLE1BQU0sQ0FBQyxDQUFDO1FBQy9FLENBQUM7UUFDRCxJQUFJLE1BQU0sQ0FBQyxNQUFNLENBQUMsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLGdCQUFnQixDQUFDLEVBQUUsQ0FBQztZQUNyRCxNQUFNLElBQUkscUJBQXFCLENBQUMsZ0JBQWdCLE1BQU0seUJBQXlCLE1BQU0sQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDLENBQUM7UUFDNUcsQ0FBQztRQUVELElBQUksQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUM7UUFFM0MsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBRUQsa0JBQWtCO0lBQ1IsS0FBSyxDQUFDLG1CQUFtQjtRQUNqQyxNQUFNLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxvREFBb0QsQ0FBQyxDQUFDO1FBRTNFLE1BQU0sWUFBWSxHQUF3QixJQUFJLENBQUMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDLFVBQXNCLEVBQVksRUFBRTtZQUNsRyxPQUFPO2dCQUNMLElBQUksRUFBRSx1QkFBdUIsQ0FBQyxRQUFRO2dCQUN0QyxNQUFNLEVBQUU7b0JBQ04sV0FBVyxFQUFFLElBQUksQ0FBQyxPQUFPO29CQUN6QixTQUFTLEVBQUUsVUFBVSxDQUFDLE9BQU87b0JBQzdCLE1BQU0sRUFBRSxVQUFVLENBQUMsTUFBTTtpQkFDMUI7YUFDRixDQUFDO1FBQ0osQ0FBQyxDQUFDLENBQUM7UUFDSCxrRkFBa0Y7UUFDbEYsNEVBQTRFO1FBQzVFLElBQUksQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUFDLENBQUM7UUFFaEMsT0FBTyxNQUFNLEtBQUssQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO0lBQzNDLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEJhc2VDb2luIGFzIENvaW5Db25maWcgfSBmcm9tICdAYml0Z28tYmV0YS9zdGF0aWNzJztcbmltcG9ydCB7IEJ1aWxkVHJhbnNhY3Rpb25FcnJvciwgVHJhbnNhY3Rpb25UeXBlIH0gZnJvbSAnQGJpdGdvLWJldGEvc2RrLWNvcmUnO1xuaW1wb3J0IHsgVjFUcmFuc2FjdGlvbkJ1aWxkZXIgfSBmcm9tICcuL3YxVHJhbnNhY3Rpb25CdWlsZGVyJztcbmltcG9ydCB7IFRyYW5zYWN0aW9uIH0gZnJvbSAnLi90cmFuc2FjdGlvbic7XG5pbXBvcnQgeyBpc1ZhbGlkQW1vdW50LCB2YWxpZGF0ZUFkZHJlc3MgfSBmcm9tICcuL3V0aWxzJztcbmltcG9ydCB7IEluc3RydWN0aW9uQnVpbGRlclR5cGVzIH0gZnJvbSAnLi9jb25zdGFudHMnO1xuaW1wb3J0IHsgSW5zdHJ1Y3Rpb25QYXJhbXMsIFRyYW5zZmVyIH0gZnJvbSAnLi9pZmFjZSc7XG5cbmltcG9ydCBhc3NlcnQgZnJvbSAnYXNzZXJ0JztcblxuZXhwb3J0IGludGVyZmFjZSBTZW5kUGFyYW1zIHtcbiAgYWRkcmVzczogc3RyaW5nO1xuICBhbW91bnQ6IHN0cmluZztcbn1cblxuLyoqXG4gKiBUcmFuc2FjdGlvbiBidWlsZGVyIGZvciBTb2xhbmEgdjEgKFNJTUQtMDI5Ni8wMzg1KSBuYXRpdmUgU09MIHBheW1lbnRzLlxuICpcbiAqIFNlcnZlci1zaWRlIGNvbnN0cnVjdGlvbiBzdXJmYWNlOiBidWlsZHMgYSB2MSBwYXltZW50IGVudmVsb3BlIGZyb21cbiAqIHN0cnVjdHVyZWQgcGFyYW1zIChzZW5kZXIgKyByZWNpcGllbnRzL2Ftb3VudHMpIOKAlCB0aGUgY2FsbGVyIHN1cHBsaWVzIGZpZWxkcyxcbiAqIG5ldmVyIGluc3RydWN0aW9ucy4gVGhlIGJ1aWxkZXIgb3ducyB0aGUgYEFkdmFuY2VOb25jZUFjY291bnRgIGluamVjdGlvbiwgdGhlXG4gKiBtZXNzYWdlIGNvbXBpbGUsIGFuZCB0aGUgbWVzc2FnZS1zaWduZXItb3JkZXIgc2lnbmF0dXJlIGFzc2VtYmx5IChpbmhlcml0ZWRcbiAqIGZyb20ge0BsaW5rIFYxVHJhbnNhY3Rpb25CdWlsZGVyfSk7IHNldCB0aGUgZmVlIHBheWVyIHZpYVxuICoge0BsaW5rIFYxVHJhbnNhY3Rpb25CdWlsZGVyLnNlbmRlcn0sIG9wdGlvbmFsIGR1cmFibGUgbm9uY2UgdmlhXG4gKiB7QGxpbmsgVjFUcmFuc2FjdGlvbkJ1aWxkZXIubm9uY2V9LCBhbmQgdGhlIHYxIGNvbmZpZyB2aWFcbiAqIHtAbGluayBWMVRyYW5zYWN0aW9uQnVpbGRlci50cmFuc2FjdGlvbkNvbmZpZ30uXG4gKi9cbmV4cG9ydCBjbGFzcyBWMVBheW1lbnRCdWlsZGVyIGV4dGVuZHMgVjFUcmFuc2FjdGlvbkJ1aWxkZXIge1xuICBwcml2YXRlIF9zZW5kUGFyYW1zOiBTZW5kUGFyYW1zW10gPSBbXTtcblxuICBjb25zdHJ1Y3RvcihfY29pbkNvbmZpZzogUmVhZG9ubHk8Q29pbkNvbmZpZz4pIHtcbiAgICBzdXBlcihfY29pbkNvbmZpZyk7XG4gIH1cblxuICBwcm90ZWN0ZWQgZ2V0IHRyYW5zYWN0aW9uVHlwZSgpOiBUcmFuc2FjdGlvblR5cGUge1xuICAgIHJldHVybiBUcmFuc2FjdGlvblR5cGUuU2VuZDtcbiAgfVxuXG4gIC8qKlxuICAgKiBTZXQgYSB0cmFuc2Zlci5cbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmd9IGFkZHJlc3MgLSB0aGUgcmVjZWl2ZXIgYWRkcmVzc1xuICAgKiBAcGFyYW0ge3N0cmluZ30gYW1vdW50IC0gdGhlIGFtb3VudCBzZW50IChsYW1wb3J0cylcbiAgICogQHJldHVybnMge1YxUGF5bWVudEJ1aWxkZXJ9IFRoaXMgdHJhbnNhY3Rpb24gYnVpbGRlclxuICAgKi9cbiAgc2VuZCh7IGFkZHJlc3MsIGFtb3VudCB9OiBTZW5kUGFyYW1zKTogdGhpcyB7XG4gICAgdmFsaWRhdGVBZGRyZXNzKGFkZHJlc3MsICdhZGRyZXNzJyk7XG4gICAgaWYgKCFhbW91bnQgfHwgIWlzVmFsaWRBbW91bnQoYW1vdW50KSkge1xuICAgICAgdGhyb3cgbmV3IEJ1aWxkVHJhbnNhY3Rpb25FcnJvcignSW52YWxpZCBvciBtaXNzaW5nIGFtb3VudCwgZ290OiAnICsgYW1vdW50KTtcbiAgICB9XG4gICAgaWYgKEJpZ0ludChhbW91bnQpID4gQmlnSW50KE51bWJlci5NQVhfU0FGRV9JTlRFR0VSKSkge1xuICAgICAgdGhyb3cgbmV3IEJ1aWxkVHJhbnNhY3Rpb25FcnJvcihgaW5wdXQgYW1vdW50ICR7YW1vdW50fSBleGNlZWRzIG1heCBzYWZlIGludCAke051bWJlci5NQVhfU0FGRV9JTlRFR0VSfWApO1xuICAgIH1cblxuICAgIHRoaXMuX3NlbmRQYXJhbXMucHVzaCh7IGFkZHJlc3MsIGFtb3VudCB9KTtcblxuICAgIHJldHVybiB0aGlzO1xuICB9XG5cbiAgLyoqIEBpbmhlcml0ZG9jICovXG4gIHByb3RlY3RlZCBhc3luYyBidWlsZEltcGxlbWVudGF0aW9uKCk6IFByb21pc2U8VHJhbnNhY3Rpb24+IHtcbiAgICBhc3NlcnQodGhpcy5fc2VuZGVyLCAnU2VuZGVyIG11c3QgYmUgc2V0IGJlZm9yZSBidWlsZGluZyB0aGUgdHJhbnNhY3Rpb24nKTtcblxuICAgIGNvbnN0IHRyYW5zZmVyRGF0YTogSW5zdHJ1Y3Rpb25QYXJhbXNbXSA9IHRoaXMuX3NlbmRQYXJhbXMubWFwKChzZW5kUGFyYW1zOiBTZW5kUGFyYW1zKTogVHJhbnNmZXIgPT4ge1xuICAgICAgcmV0dXJuIHtcbiAgICAgICAgdHlwZTogSW5zdHJ1Y3Rpb25CdWlsZGVyVHlwZXMuVHJhbnNmZXIsXG4gICAgICAgIHBhcmFtczoge1xuICAgICAgICAgIGZyb21BZGRyZXNzOiB0aGlzLl9zZW5kZXIsXG4gICAgICAgICAgdG9BZGRyZXNzOiBzZW5kUGFyYW1zLmFkZHJlc3MsXG4gICAgICAgICAgYW1vdW50OiBzZW5kUGFyYW1zLmFtb3VudCxcbiAgICAgICAgfSxcbiAgICAgIH07XG4gICAgfSk7XG4gICAgLy8gdjE6IHRoZSBwcmlvcml0eSBmZWUgaXMgY2FycmllZCBpbiB0aGUgbWVzc2FnZSBjb25maWcgbWFzayAodHJhbnNhY3Rpb25Db25maWcpLFxuICAgIC8vIHNvIG5vIGV4cGxpY2l0IFNldFByaW9yaXR5RmVlIGluc3RydWN0aW9uIGlzIG5lZWRlZCAodW5saWtlIHRoZSB2MCBmbG93KS5cbiAgICB0aGlzLmluc3RydWN0aW9ucyh0cmFuc2ZlckRhdGEpO1xuXG4gICAgcmV0dXJuIGF3YWl0IHN1cGVyLmJ1aWxkSW1wbGVtZW50YXRpb24oKTtcbiAgfVxufVxuIl19

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

@@ -0,0 +1,253 @@
+import BigNumber from 'bignumber.js';
+import { BaseCoin as CoinConfig } from '@bitgo-beta/statics';
+import { BaseAddress, BaseKey, BaseTransactionBuilder, FeeOptions, PublicKey as BasePublicKey, SolV1TransactionConfig, SolVersionedTransactionData, TransactionType } from '@bitgo-beta/sdk-core';
+import { TransactionInstruction } from '@solana/web3.js';
+import { Transaction } from './transaction';
+import { InstructionParams, Nonce } from './iface';
+/**
+ * Construct an AdvanceNonceAccount instruction for a durable nonce.
+ *
+ * The v0 path receives this instruction from web3.js / the Rust wasm core
+ * (`NonceSource` durable variant); the v1 path compiles via
+ * `compileTransactionMessage`, so the nonce instruction must be constructed in
+ * TypeScript and injected into the compile input. The nonce authority
+ * (`authWalletAddress`) MUST sign the instruction — it becomes a required
+ * signer of the compiled message.
+ *
+ * @param nonceAddress - the durable nonce account address
+ * @param authWalletAddress - the nonce authority (gas-tank root in BitGo's model)
+ * @returns the AdvanceNonceAccount instruction
+ */
+export declare function buildAdvanceNonceAccountInstruction(nonceAddress: string, authWalletAddress: string): TransactionInstruction;
+/**
+ * Map a v1 envelope instruction (index-based) into a web3.js TransactionInstruction
+ * (address-based), deriving each referenced account's signer/writable role from the
+ * message header (Solana role conventions: the last `numReadonlySignedAccounts`
+ * signers and last `numReadonlyUnsignedAccounts` non-signers are readonly).
+ *
+ * @param instruction - the envelope instruction (programIdIndex/accountKeyIndexes/data)
+ * @param data - the v1 envelope
+ * @returns the address-based instruction, ready for V1TransactionBuilder.addInstruction
+ */
+export declare function toV1TransactionInstruction(instruction: {
+    programIdIndex: number;
+    accountKeyIndexes: number[];
+    data: string;
+}, data: SolVersionedTransactionData): TransactionInstruction;
+/**
+ * Inject an AdvanceNonceAccount instruction into a v1 envelope for durable nonce.
+ *
+ * v1 (SIMD-0296/0385) has no address lookup tables, so every account is a static
+ * key. The nonce authority MUST sign the AdvanceNonceAccount instruction (hard
+ * runtime requirement) and the nonce account MUST be writable; the system program
+ * and recent-blockhashes sysvar are readonly non-signers. The instruction is
+ * prepended and every instruction's account indexes are remapped to the rebuilt
+ * static key list; messageHeader grows accordingly so the wire-size estimate and
+ * account caps are correct.
+ *
+ * @param data - the v1 envelope (client-supplied, no nonce instruction)
+ * @param durableNonceParams - walletNonceAddress + authWalletAddress (gas-tank root)
+ * @returns a copy of the envelope with the nonce instruction injected
+ * @edge if the envelope already contains an AdvanceNonceAccount instruction, returns
+ *   the envelope unchanged (idempotent - a durable-aware client may supply it)
+ */
+export declare function injectV1NonceAdvanceInstruction(data: SolVersionedTransactionData, durableNonceParams: {
+    walletNonceAddress: string;
+    authWalletAddress: string;
+}): SolVersionedTransactionData;
+/**
+ * Base builder for Solana v1 (SIMD-0296/0385) transactions.
+ *
+ * Parallel to the v0 {@link TransactionBuilder}, which is bound to a
+ * `@solana/web3.js` v0 `Transaction` and cannot emit a v1 wire. This builder
+ * owns the v1 assembly:
+ *
+ * - intent-to-instruction derivation via the shared `solInstructionFactory`
+ *   (same `InstructionParams` representation as the v0 flows)
+ * - durable nonce: `AdvanceNonceAccount` instruction injection (first) plus the
+ *   nonce hash in the blockhash field
+ * - transaction config (compute unit limit, heap size, loaded accounts data
+ *   size limit, priority fee as total lamports)
+ * - signer management: private-key signers (`sign`) and external signatures
+ *   (`addSignature`), assembled in message-signer order
+ * - message compile via `compileTransactionMessage` and signed wire via
+ *   `serializeWireTransaction`
+ *
+ * Signature assembly is in message-signer order (fee payer first, then the
+ * remaining signers in the compiled account order), NOT insertion order —
+ * required for multi-signer v1 transactions such as durable-nonce CT
+ * (user + gas-tank nonce authority). Missing signatures are zero-filled in
+ * their slots so the wire shape stays valid for partial-sign flows; the
+ * broadcastable wire is only produced once every required signer has a
+ * signature.
+ */
+/**
+ * Input shape for {@link V1TransactionBuilder.transactionConfig}: all fields optional;
+ * unset values are coerced to null (the SDK v1 serializer contract).
+ */
+export type V1TransactionConfigInput = {
+    computeUnitLimit?: number;
+    heapSize?: number;
+    loadedAccountsDataSizeLimit?: number;
+    priorityFee?: number;
+};
+export declare abstract class V1TransactionBuilder extends BaseTransactionBuilder {
+    protected _transaction: Transaction;
+    private _instructionsData;
+    private _extraInstructions;
+    private _signers;
+    private _signatures;
+    private _lamportsPerSignature;
+    protected _sender: string;
+    protected _feePayer?: string;
+    protected _recentBlockhash: string;
+    protected _nonceInfo?: Nonce;
+    protected _memo?: string;
+    protected _transactionConfig?: SolV1TransactionConfig;
+    /** Optional override for the zk-elgamal-proof program id (used by CT instruction builders) */
+    protected _zkProofProgramId?: string;
+    constructor(_coinConfig: Readonly<CoinConfig>);
+    /**
+     * The transaction type.
+     */
+    protected abstract get transactionType(): TransactionType;
+    /** @inheritdoc */
+    protected buildImplementation(): Promise<Transaction>;
+    /**
+     * Assemble the v1 transaction: derive instructions, inject the durable-nonce
+     * instruction when present, compile the message, and assemble the signed
+     * wire in message-signer order.
+     *
+     * @returns {Transaction} The built transaction holding the v1 message and wire bytes
+     */
+    private buildV1;
+    /** @inheritdoc */
+    protected fromImplementation(rawTransaction: string): Transaction;
+    /** @inheritdoc */
+    protected get transaction(): Transaction;
+    /** @inheritdoc */
+    protected set transaction(transaction: Transaction);
+    /** @inheritdoc */
+    protected signImplementation(key: BaseKey): Transaction;
+    /** @inheritDoc */
+    addSignature(publicKey: BasePublicKey, signature: Buffer): void;
+    /**
+     * Sets the sender of this transaction.
+     * This account will be responsible for paying transaction fees.
+     *
+     * @param {string} senderAddress the account that is sending this transaction
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    sender(senderAddress: string): this;
+    /**
+     * Set the transaction nonce.
+     * Requires both optional params in order to use the durable nonce.
+     *
+     * @param {string} blockHash The latest blockHash or the durable nonce hash
+     * @param {DurableNonceParams} [durableNonceParams] An object containing the walletNonceAddress and the authWalletAddress (required for durable nonce)
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    nonce(blockHash: string, durableNonceParams?: {
+        walletNonceAddress: string;
+        authWalletAddress: string;
+    }): this;
+    /**
+     * Set the intent instructions to build, using the shared instruction params
+     * representation consumed by `solInstructionFactory` (same as the v0 flows).
+     *
+     * @param {InstructionParams[]} instructions the instruction params
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    instructions(instructions: InstructionParams[]): this;
+    /**
+     * Append a pre-built instruction (e.g. an envelope-derived instruction or a
+     * custom instruction) to the transaction.
+     *
+     * @param {TransactionInstruction} instruction the instruction to append
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    addInstruction(instruction: TransactionInstruction): this;
+    /**
+     * Set the v1 transaction config (compute unit limit, heap size, loaded
+     * accounts data size limit, and priority fee as total lamports). Required
+     * before building.
+     *
+     * @param {SolV1TransactionConfig} config the v1 transaction config
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    transactionConfig(config: V1TransactionConfigInput): this;
+    /**
+     * Initialize the builder from a client-supplied v1 envelope
+     * (SolVersionedTransactionData). Sets the fee payer from staticAccountKeys[0],
+     * coerces the transaction config, and converts each envelope instruction to an
+     * address-based TransactionInstruction via {@link toV1TransactionInstruction}.
+     *
+     * @param data - the v1 envelope
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    fromVersionedData(data: SolVersionedTransactionData): this;
+    /**
+     * Set the priority fee (total lamports) on the v1 transaction config.
+     *
+     * @param {FeeOptions} feeOptions the priority fee
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    setPriorityFee(feeOptions: FeeOptions): this;
+    /**
+     * Set the fee (lamports per signature) for fee estimation.
+     *
+     * @param {FeeOptions} feeOptions the fee
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    fee(feeOptions: FeeOptions): this;
+    feePayer(feePayer: string): this;
+    /**
+     * Set the memo.
+     *
+     * @param {string} memo
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    memo(memo: string): this;
+    /**
+     * Override the zk-elgamal-proof program id.
+     *
+     * Defaults to the canonical on-chain program id (`ZkE1Gama1Proof111...`)
+     * which is the same across mainnet, devnet, and testnet. Override only
+     * when targeting a custom deployment.
+     *
+     * @param {string} programId base58 encoded program id
+     * @returns {V1TransactionBuilder} This transaction builder
+     */
+    zkProofProgramId(programId: string): this;
+    /** @inheritdoc */
+    validateAddress(address: BaseAddress, addressFormat?: string): void;
+    /** @inheritdoc */
+    validateKey(key: BaseKey): void;
+    /** @inheritdoc */
+    validateRawTransaction(rawTransaction: string): void;
+    /** @inheritdoc */
+    validateTransaction(transaction?: Transaction): void;
+    /** @inheritdoc */
+    validateValue(value: BigNumber): void;
+    /**
+     * Validates the memo.
+     *
+     * @param {string} memo - the memo as string
+     */
+    validateMemo(memo: string): void;
+    /**
+     * Validates that the given key is not already in this._signers.
+     *
+     * @param {BaseKey} key - The key to check
+     */
+    private checkDuplicatedSigner;
+    /**
+     * Validates that the sender field is defined.
+     */
+    private validateSender;
+    /**
+     * Validates that the nonce field is defined.
+     */
+    private validateNonce;
+}
+//# sourceMappingURL=v1TransactionBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v1TransactionBuilder.d.ts","sourceRoot":"","sources":["../../../src/lib/v1TransactionBuilder.ts"],"names":[],"mappings":"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"}