@vultisig/sdk 0.26.1 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @vultisig/sdk
 
+## 0.27.0
+
+### Minor Changes
+
+- [#516](https://github.com/vultisig/vultisig-sdk/pull/516) [`9a80907`](https://github.com/vultisig/vultisig-sdk/commit/9a8090721008f2a10dffa9cf2d3fac479d65481c) Thanks [@NeOMakinG](https://github.com/NeOMakinG)! - Add `buildTonTxFromSigningPayload({publicKeyEd25519, signingPayloadBoc, includeStateInit, workchain})` to sign yield.xyz TON actions whose signing payload BoC is already constructed upstream. Parses the BoC, hashes the payload cell, takes the MPC signature, and wraps the final external message — same `{signingHashHex, unsignedBocHex, fromAddress, finalize(sig)}` contract as `buildTonSendTx`. Accepts either base64 or hex BoC input. Optional `includeStateInit` flag deploys the v4r2 wallet contract alongside the tx for first-send (seqno === 0) scenarios.
+
 ## 0.26.1
 
 ### Patch Changes

package/dist/index.react-native.d.ts

@@ -7738,6 +7738,59 @@ type BuildTonJettonTransferOptions = {
     workchain?: number;
 };
 declare function buildTonJettonTransferTx(opts: BuildTonJettonTransferOptions): TonTxBuilderResult;
+type BuildTonTxFromSigningPayloadOptions = {
+    /**
+     * Ed25519 pubkey of the signer (32 bytes, hex). Used to derive the
+     * V4R2 wallet address for the outer external-message envelope —
+     * NOT included in the signed payload itself. The signing hash is
+     * the hash of the payload BoC; the pubkey only affects the envelope
+     * `dest:MsgAddressInt` field.
+     */
+    publicKeyEd25519: string;
+    /**
+     * The pre-built signing-payload BoC, base64-encoded. yield.xyz returns
+     * this verbatim in each step's `unsignedTransaction` field. Hex is
+     * also accepted (auto-detect by prefix / character set) so a future
+     * upstream that emits hex doesn't break this primitive.
+     */
+    signingPayloadBoc: string;
+    /**
+     * When true, the external message wraps a StateInit cell (the wallet
+     * deploys itself in the same tx). Required for the very first send
+     * from a wallet — the contract isn't on-chain yet so the message
+     * must include code+data.
+     *
+     * For TON V4R2 the rule is: include StateInit iff seqno === 0. Callers
+     * that derive the BoC from yield.xyz typically know this from their
+     * own seqno lookup; pass true on first-ever send, false otherwise.
+     *
+     * Default false to fail-closed (a missing StateInit on first send
+     * surfaces as a clear broadcast error; a stale StateInit on a later
+     * send would pass an invalid contract redeploy).
+     */
+    includeStateInit?: boolean;
+    /**
+     * Optional override for the wallet workchain. Defaults to `0` (the
+     * basechain — where all user wallets live). Pass `-1` for the
+     * masterchain (validators / system contracts); almost no consumer
+     * needs this.
+     */
+    workchain?: number;
+};
+/**
+ * Sign a pre-built TON signing payload (the inner Cell that gets hashed
+ * for the wallet's external-message body). See the section header
+ * comment above for the full design rationale and seqno-freshness
+ * warnings.
+ *
+ * @returns {signingHashHex, unsignedBocHex, fromAddress, finalize(sig)}
+ *          — identical contract to `buildTonSendTx` so call-sites can
+ *          treat both paths uniformly. `unsignedBocHex` round-trips
+ *          the decoded payload's serialized form (NOT the input
+ *          string verbatim — equality holds at the byte level after
+ *          BoC re-serialization).
+ */
+declare function buildTonTxFromSigningPayload(opts: BuildTonTxFromSigningPayloadOptions): TonTxBuilderResult;
 /** Throws if `memo` exceeds the 123-byte TON comment cell capacity. */
 declare function validateTonMemo(memo: string): void;
 
@@ -7794,6 +7847,7 @@ declare function buildV4R2Wallet(opts: {
 
 type ton_BuildTonJettonTransferOptions = BuildTonJettonTransferOptions;
 type ton_BuildTonSendOptions = BuildTonSendOptions;
+type ton_BuildTonTxFromSigningPayloadOptions = BuildTonTxFromSigningPayloadOptions;
 declare const ton_TON_V4R2_SUB_WALLET_ID: typeof TON_V4R2_SUB_WALLET_ID;
 type ton_TonTxBuilderResult = TonTxBuilderResult;
 type ton_TonV4R2Wallet = TonV4R2Wallet;
@@ -7802,6 +7856,7 @@ type ton_TonWalletStatus = TonWalletStatus;
 declare const ton_broadcastTonTx: typeof broadcastTonTx;
 declare const ton_buildTonJettonTransferTx: typeof buildTonJettonTransferTx;
 declare const ton_buildTonSendTx: typeof buildTonSendTx;
+declare const ton_buildTonTxFromSigningPayload: typeof buildTonTxFromSigningPayload;
 declare const ton_buildV4R2Wallet: typeof buildV4R2Wallet;
 declare const ton_deriveTonAddress: typeof deriveTonAddress;
 declare const ton_getTonBalance: typeof getTonBalance;
@@ -7809,8 +7864,8 @@ declare const ton_getTonWalletInfo: typeof getTonWalletInfo;
 declare const ton_sha256: typeof sha256;
 declare const ton_validateTonMemo: typeof validateTonMemo;
 declare namespace ton {
-  export { ton_TON_V4R2_SUB_WALLET_ID as TON_V4R2_SUB_WALLET_ID, ton_broadcastTonTx as broadcastTonTx, ton_buildTonJettonTransferTx as buildTonJettonTransferTx, ton_buildTonSendTx as buildTonSendTx, ton_buildV4R2Wallet as buildV4R2Wallet, ton_deriveTonAddress as deriveTonAddress, ton_getTonBalance as getTonBalance, ton_getTonWalletInfo as getTonWalletInfo, ton_sha256 as sha256, ton_validateTonMemo as validateTonMemo };
-  export type { ton_BuildTonJettonTransferOptions as BuildTonJettonTransferOptions, ton_BuildTonSendOptions as BuildTonSendOptions, ton_TonTxBuilderResult as TonTxBuilderResult, ton_TonV4R2Wallet as TonV4R2Wallet, ton_TonWalletInfo as TonWalletInfo, ton_TonWalletStatus as TonWalletStatus };
+  export { ton_TON_V4R2_SUB_WALLET_ID as TON_V4R2_SUB_WALLET_ID, ton_broadcastTonTx as broadcastTonTx, ton_buildTonJettonTransferTx as buildTonJettonTransferTx, ton_buildTonSendTx as buildTonSendTx, ton_buildTonTxFromSigningPayload as buildTonTxFromSigningPayload, ton_buildV4R2Wallet as buildV4R2Wallet, ton_deriveTonAddress as deriveTonAddress, ton_getTonBalance as getTonBalance, ton_getTonWalletInfo as getTonWalletInfo, ton_sha256 as sha256, ton_validateTonMemo as validateTonMemo };
+  export type { ton_BuildTonJettonTransferOptions as BuildTonJettonTransferOptions, ton_BuildTonSendOptions as BuildTonSendOptions, ton_BuildTonTxFromSigningPayloadOptions as BuildTonTxFromSigningPayloadOptions, ton_TonTxBuilderResult as TonTxBuilderResult, ton_TonV4R2Wallet as TonV4R2Wallet, ton_TonWalletInfo as TonWalletInfo, ton_TonWalletStatus as TonWalletStatus };
 }
 
 /**