@kimafinance/kima-transaction-api 1.5.11 → 1.5.13

package/README.md

@@ -19,10 +19,25 @@ yarn add @kimafinance/kima-transaction-api
 import {
   submitKimaTransferTransaction,
   submitKimaSwapTransaction,
-  SupportNetworks,
+  SupportedNetworks,
   CurrencyOptions,
+  SubmitOptionsPayload,
 } from "@kimafinance/kima-transaction-api";
 
+const transferOptions: SubmitOptionsPayload = {
+  signature: "", // approval message signature
+  feeId: "", // fee id from fee quote
+  chargeFeeAtTarget: false,
+  transactionIdSeed: "",
+  transactionIdSignature: "",
+  permit2: {
+    r: "0x...",
+    s: "0x...",
+    v: 27,
+    deadline: 1735689600,
+  },
+};
+
 const txResult = await submitKimaTransferTransaction({
   originAddress: "0x1234123412341234123412341234123412341234",
   originChain: "ETH",
@@ -37,13 +52,8 @@ const txResult = await submitKimaTransferTransaction({
   htlcExpirationTimestamp: "",
   htlcVersion: "",
   senderPubKey: "",
-  options: {
-    signature: "", // required: generated signature from the approval message
-    feeId: "", // required: id returned from calculated fee in fcs
-    chargeFeeAtTarget: false // required: wether to deduct fees from origin or target
-    transactionIdSeed: "", // optional: used in fiat on ramp payments
-    transactionIdSignature: "", // optional: used to validate transaction idempotency
-  }
+  // Runtime wire format stays a serialized JSON string
+  options: JSON.stringify(transferOptions),
 });
 
 
@@ -59,10 +69,16 @@ const txResult = await submitKimaSwapTransaction({
   fee: "0.3",
   dex: "uniswap", // required to send empty strings for now
   slippage: "0.05",
-  options: {
-    signature: "", // required: generated signature from the approval message
-    feeId: "", // required: id returned from calculated fee in fcs
-  }
+  options: JSON.stringify({
+    signature: "",
+    feeId: "",
+    permit2: {
+      r: "0x...",
+      s: "0x...",
+      v: 28,
+      deadline: 1735689600,
+    },
+  } satisfies SubmitOptionsPayload),
 });
 ```
 

package/build/index.d.ts

@@ -1,8 +1,9 @@
 import { RequestHtlcReclaimProps, RequestHtlcLockProps, HtlcLockingTransactionResponse, QueryHtlcLockingTransactionParams, RequestTransferTxProps, RequestSwapTxProps, RequestExternalTxProps } from "./types";
+export * from "./types";
 export declare function getHtlcLockingTransactions({ baseUrl, limit, offset, paginationKey, }: QueryHtlcLockingTransactionParams): Promise<HtlcLockingTransactionResponse>;
 export declare function HtlcReclaim({ senderAddress, txHash, }: RequestHtlcReclaimProps): Promise<import("@cosmjs/stargate").DeliverTxResponse>;
 export declare function submitHtlcLock({ fromAddress, senderPubkey, amount, htlcTimeout, txHash, htlcAddress, }: RequestHtlcLockProps): Promise<import("@cosmjs/stargate").DeliverTxResponse>;
 export declare function getCreatorAddress(): Promise<import("@cosmjs/proto-signing").AccountData>;
 export declare function submitKimaTransferTransaction({ originChain, originAddress, targetChain, targetAddress, originSymbol, targetSymbol, amount, fee, htlcCreationHash, htlcCreationVout, htlcExpirationTimestamp, htlcVersion, senderPubKey, options, }: RequestTransferTxProps): Promise<import("@cosmjs/stargate").DeliverTxResponse>;
-export declare function submitKimaSwapTransaction({ originChain, originAddress, targetChain, targetAddress, originSymbol, targetSymbol, amountIn, amountOut, fee, dex, slippage, options, }: RequestSwapTxProps): Promise<import("@cosmjs/stargate").DeliverTxResponse>;
+export declare function submitKimaSwapTransaction({ originChain, originAddress, targetChain, targetAddress, originSymbol, targetSymbol, amountIn, amountOut, fee, dex, slippage, htlcExpirationTimestamp, htlcCreationHash, htlcCreationVout, htlcVersion, senderPubKey, options }: RequestSwapTxProps): Promise<import("@cosmjs/stargate").DeliverTxResponse>;
 export declare function submitKimaExternalTransaction({ originChain, originAddress, targetChain, targetAddress, originSymbol, targetSymbol, amount, fee, options, }: RequestExternalTxProps): Promise<import("@cosmjs/stargate").DeliverTxResponse>;

package/build/index.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -9,6 +23,7 @@ const http_1 = __importDefault(require("http"));
 const https_1 = __importDefault(require("https"));
 const url_1 = require("url");
 const common_1 = require("./kima/common");
+__exportStar(require("./types"), exports);
 const requestJson = async (url) => {
     return new Promise((resolve, reject) => {
         const parsed = new url_1.URL(url);
@@ -117,7 +132,7 @@ async function submitKimaTransferTransaction({ originChain, originAddress, targe
     return result;
 }
 exports.submitKimaTransferTransaction = submitKimaTransferTransaction;
-async function submitKimaSwapTransaction({ originChain, originAddress, targetChain, targetAddress, originSymbol, targetSymbol, amountIn, amountOut, fee, dex, slippage, options, }) {
+async function submitKimaSwapTransaction({ originChain, originAddress, targetChain, targetAddress, originSymbol, targetSymbol, amountIn, amountOut, fee, dex, slippage, htlcExpirationTimestamp, htlcCreationHash, htlcCreationVout, htlcVersion, senderPubKey, options }) {
     const wallet = await proto_signing_1.DirectSecp256k1HdWallet.fromMnemonic(process.env.KIMA_BACKEND_MNEMONIC, { prefix: "kima" });
     const client = await (0, common_1.TxClient)(wallet);
     const [firstAccount] = await wallet.getAccounts();
@@ -134,6 +149,11 @@ async function submitKimaSwapTransaction({ originChain, originAddress, targetCha
         fee: fee,
         dex: dex,
         slippage: slippage,
+        htlcExpirationTimestamp: htlcExpirationTimestamp || "",
+        htlcCreationHash: htlcCreationHash || "",
+        htlcCreationVout: htlcCreationVout || 0,
+        htlcVersion: htlcVersion || "",
+        senderPubKey: senderPubKey || new Uint8Array(),
         options: options,
     };
     const msgTx = await client.msgRequestSwapTransaction(params);

package/build/kima/swap_tx.d.ts

@@ -24,6 +24,16 @@ export interface MsgRequestSwapTransaction {
     dex: string;
     /** the slippage of the swap transaction */
     slippage: string;
+    /** the timestamp when the HTLC contract expires and the user can reclaim the funds locked there */
+    htlcExpirationTimestamp: string;
+    /** the txhash locking the funds in the HTLC */
+    htlcCreationHash: string;
+    /** the output index of the locked funds in the HTLC creation transaction */
+    htlcCreationVout: number;
+    /** a version denoting which HTLC script version is being used for the HTLC transaction */
+    htlcVersion: string;
+    /** for bitcoin transaction this is the public key of the sender */
+    senderPubKey: Uint8Array;
     /** the options of the swap transaction */
     options: string;
 }
@@ -130,6 +140,11 @@ export declare const MsgRequestSwapTransaction: {
         fee?: string | undefined;
         dex?: string | undefined;
         slippage?: string | undefined;
+        htlcExpirationTimestamp?: string | undefined;
+        htlcCreationHash?: string | undefined;
+        htlcCreationVout?: number | undefined;
+        htlcVersion?: string | undefined;
+        senderPubKey?: Uint8Array | undefined;
         options?: string | undefined;
     } & {
         creator?: string | undefined;
@@ -144,6 +159,11 @@ export declare const MsgRequestSwapTransaction: {
         fee?: string | undefined;
         dex?: string | undefined;
         slippage?: string | undefined;
+        htlcExpirationTimestamp?: string | undefined;
+        htlcCreationHash?: string | undefined;
+        htlcCreationVout?: number | undefined;
+        htlcVersion?: string | undefined;
+        senderPubKey?: Uint8Array | undefined;
         options?: string | undefined;
     } & { [K in Exclude<keyof I, keyof MsgRequestSwapTransaction>]: never; }>(object: I): MsgRequestSwapTransaction;
 };

package/build/kima/swap_tx.js

@@ -22,6 +22,11 @@ function createBaseMsgRequestSwapTransaction() {
         fee: "",
         dex: "",
         slippage: "",
+        htlcExpirationTimestamp: "",
+        htlcCreationHash: "",
+        htlcCreationVout: 0,
+        htlcVersion: "",
+        senderPubKey: new Uint8Array(),
         options: "",
     };
 }
@@ -63,8 +68,23 @@ exports.MsgRequestSwapTransaction = {
         if (message.slippage !== "") {
             writer.uint32(98).string(message.slippage);
         }
+        if (message.htlcExpirationTimestamp !== "") {
+            writer.uint32(106).string(message.htlcExpirationTimestamp);
+        }
+        if (message.htlcCreationHash !== "") {
+            writer.uint32(114).string(message.htlcCreationHash);
+        }
+        if (message.htlcCreationVout !== 0) {
+            writer.uint32(120).uint32(message.htlcCreationVout);
+        }
+        if (message.htlcVersion !== "") {
+            writer.uint32(130).string(message.htlcVersion);
+        }
+        if (message.senderPubKey.length !== 0) {
+            writer.uint32(138).bytes(message.senderPubKey);
+        }
         if (message.options !== "") {
-            writer.uint32(106).string(message.options);
+            writer.uint32(146).string(message.options);
         }
         return writer;
     },
@@ -112,6 +132,21 @@ exports.MsgRequestSwapTransaction = {
                     message.slippage = reader.string();
                     break;
                 case 13:
+                    message.htlcExpirationTimestamp = reader.string();
+                    break;
+                case 14:
+                    message.htlcCreationHash = reader.string();
+                    break;
+                case 15:
+                    message.htlcCreationVout = reader.uint32();
+                    break;
+                case 16:
+                    message.htlcVersion = reader.string();
+                    break;
+                case 17:
+                    message.senderPubKey = reader.bytes();
+                    break;
+                case 18:
                     message.options = reader.string();
                     break;
                 default:
@@ -135,6 +170,11 @@ exports.MsgRequestSwapTransaction = {
             fee: isSet(object.fee) ? String(object.fee) : "",
             dex: isSet(object.dex) ? String(object.dex) : "",
             slippage: isSet(object.slippage) ? String(object.slippage) : "",
+            htlcExpirationTimestamp: isSet(object.htlcExpirationTimestamp) ? String(object.htlcExpirationTimestamp) : "",
+            htlcCreationHash: isSet(object.htlcCreationHash) ? String(object.htlcCreationHash) : "",
+            htlcCreationVout: isSet(object.htlcCreationVout) ? Number(object.htlcCreationVout) : 0,
+            htlcVersion: isSet(object.htlcVersion) ? String(object.htlcVersion) : "",
+            senderPubKey: isSet(object.senderPubKey) ? bytesFromBase64(object.senderPubKey) : new Uint8Array(),
             options: isSet(object.options) ? String(object.options) : "",
         };
     },
@@ -152,6 +192,12 @@ exports.MsgRequestSwapTransaction = {
         message.fee !== undefined && (obj.fee = message.fee);
         message.dex !== undefined && (obj.dex = message.dex);
         message.slippage !== undefined && (obj.slippage = message.slippage);
+        message.htlcExpirationTimestamp !== undefined && (obj.htlcExpirationTimestamp = message.htlcExpirationTimestamp);
+        message.htlcCreationHash !== undefined && (obj.htlcCreationHash = message.htlcCreationHash);
+        message.htlcCreationVout !== undefined && (obj.htlcCreationVout = Math.round(message.htlcCreationVout));
+        message.htlcVersion !== undefined && (obj.htlcVersion = message.htlcVersion);
+        message.senderPubKey !== undefined
+            && (obj.senderPubKey = base64FromBytes(message.senderPubKey !== undefined ? message.senderPubKey : new Uint8Array()));
         message.options !== undefined && (obj.options = message.options);
         return obj;
     },
@@ -169,6 +215,11 @@ exports.MsgRequestSwapTransaction = {
         message.fee = object.fee ?? "";
         message.dex = object.dex ?? "";
         message.slippage = object.slippage ?? "";
+        message.htlcExpirationTimestamp = object.htlcExpirationTimestamp ?? "";
+        message.htlcCreationHash = object.htlcCreationHash ?? "";
+        message.htlcCreationVout = object.htlcCreationVout ?? 0;
+        message.htlcVersion = object.htlcVersion ?? "";
+        message.senderPubKey = object.senderPubKey ?? new Uint8Array();
         message.options = object.options ?? "";
         return message;
     },
@@ -1094,6 +1145,31 @@ var globalThis = (() => {
     }
     throw "Unable to locate global object";
 })();
+function bytesFromBase64(b64) {
+    if (globalThis.Buffer) {
+        return Uint8Array.from(globalThis.Buffer.from(b64, "base64"));
+    }
+    else {
+        const bin = globalThis.atob(b64);
+        const arr = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; ++i) {
+            arr[i] = bin.charCodeAt(i);
+        }
+        return arr;
+    }
+}
+function base64FromBytes(arr) {
+    if (globalThis.Buffer) {
+        return globalThis.Buffer.from(arr).toString("base64");
+    }
+    else {
+        const bin = [];
+        arr.forEach((byte) => {
+            bin.push(String.fromCharCode(byte));
+        });
+        return globalThis.btoa(bin.join(""));
+    }
+}
 function longToNumber(long) {
     if (long.gt(Number.MAX_SAFE_INTEGER)) {
         throw new globalThis.Error("Value is larger than Number.MAX_SAFE_INTEGER");

package/build/types.d.ts

@@ -25,6 +25,21 @@ export declare enum CurrencyOptions {
     EUR = "EUR",
     USD = "USD"
 }
+export interface Permit2SubmitOptions {
+    r: string;
+    s: string;
+    v: number;
+    deadline: number;
+}
+export interface SubmitOptionsPayload {
+    signature?: string;
+    feeId?: string;
+    chargeFeeAtTarget?: boolean;
+    transactionIdSeed?: string;
+    transactionIdSignature?: string;
+    permit2?: Permit2SubmitOptions;
+    [key: string]: unknown;
+}
 export interface RequestHtlcReclaimProps {
     senderAddress: string;
     txHash: string;
@@ -65,6 +80,11 @@ export interface RequestSwapTxProps {
     fee: string;
     dex: string;
     slippage: string;
+    htlcExpirationTimestamp?: string;
+    htlcCreationHash?: string;
+    htlcCreationVout?: number;
+    htlcVersion?: string;
+    senderPubKey?: Uint8Array;
     options: string;
 }
 export interface RequestExternalTxProps {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kimafinance/kima-transaction-api",
-  "version": "1.5.11",
+  "version": "1.5.13",
   "description": "A wrapper around Kima's API, enabling sending and monitoring transactions (Beta version)",
   "repository": "https://github.com/kima-finance/kima-transaction-api",
   "author": "",

package/src/index.ts

@@ -24,6 +24,8 @@ import {
   RequestExternalTxProps,
 } from "./types";
 
+export * from "./types";
+
 const requestJson = async <T>(url: string): Promise<T> => {
   return new Promise((resolve, reject) => {
     const parsed = new URL(url);
@@ -192,7 +194,12 @@ export async function submitKimaSwapTransaction({
   fee,
   dex,
   slippage,
-  options,
+  htlcExpirationTimestamp,
+  htlcCreationHash,
+  htlcCreationVout,
+  htlcVersion,
+  senderPubKey,
+  options
 }: RequestSwapTxProps) {
   const wallet = await DirectSecp256k1HdWallet.fromMnemonic(
     process.env.KIMA_BACKEND_MNEMONIC as string,
@@ -213,6 +220,11 @@ export async function submitKimaSwapTransaction({
     fee: fee,
     dex: dex,
     slippage: slippage,
+    htlcExpirationTimestamp: htlcExpirationTimestamp || "",
+    htlcCreationHash: htlcCreationHash || "",
+    htlcCreationVout: htlcCreationVout || 0,
+    htlcVersion: htlcVersion || "",
+    senderPubKey: senderPubKey || new Uint8Array(),
     options: options,
   };
 

package/src/kima/swap_tx.ts

@@ -28,6 +28,16 @@ export interface MsgRequestSwapTransaction {
   dex: string;
   /** the slippage of the swap transaction */
   slippage: string;
+  /** the timestamp when the HTLC contract expires and the user can reclaim the funds locked there */
+  htlcExpirationTimestamp: string;
+  /** the txhash locking the funds in the HTLC */
+  htlcCreationHash: string;
+  /** the output index of the locked funds in the HTLC creation transaction */
+  htlcCreationVout: number;
+  /** a version denoting which HTLC script version is being used for the HTLC transaction */
+  htlcVersion: string;
+  /** for bitcoin transaction this is the public key of the sender */
+  senderPubKey: Uint8Array;
   /** the options of the swap transaction */
   options: string;
 }
@@ -142,6 +152,11 @@ function createBaseMsgRequestSwapTransaction(): MsgRequestSwapTransaction {
     fee: "",
     dex: "",
     slippage: "",
+    htlcExpirationTimestamp: "",
+    htlcCreationHash: "",
+    htlcCreationVout: 0,
+    htlcVersion: "",
+    senderPubKey: new Uint8Array(),
     options: "",
   };
 }
@@ -184,8 +199,23 @@ export const MsgRequestSwapTransaction = {
     if (message.slippage !== "") {
       writer.uint32(98).string(message.slippage);
     }
+    if (message.htlcExpirationTimestamp !== "") {
+      writer.uint32(106).string(message.htlcExpirationTimestamp);
+    }
+    if (message.htlcCreationHash !== "") {
+      writer.uint32(114).string(message.htlcCreationHash);
+    }
+    if (message.htlcCreationVout !== 0) {
+      writer.uint32(120).uint32(message.htlcCreationVout);
+    }
+    if (message.htlcVersion !== "") {
+      writer.uint32(130).string(message.htlcVersion);
+    }
+    if (message.senderPubKey.length !== 0) {
+      writer.uint32(138).bytes(message.senderPubKey);
+    }
     if (message.options !== "") {
-      writer.uint32(106).string(message.options);
+      writer.uint32(146).string(message.options);
     }
     return writer;
   },
@@ -234,6 +264,21 @@ export const MsgRequestSwapTransaction = {
           message.slippage = reader.string();
           break;
         case 13:
+          message.htlcExpirationTimestamp = reader.string();
+          break;
+        case 14:
+          message.htlcCreationHash = reader.string();
+          break;
+        case 15:
+          message.htlcCreationVout = reader.uint32();
+          break;
+        case 16:
+          message.htlcVersion = reader.string();
+          break;
+        case 17:
+          message.senderPubKey = reader.bytes();
+          break;
+        case 18:
           message.options = reader.string();
           break;
         default:
@@ -258,6 +303,11 @@ export const MsgRequestSwapTransaction = {
       fee: isSet(object.fee) ? String(object.fee) : "",
       dex: isSet(object.dex) ? String(object.dex) : "",
       slippage: isSet(object.slippage) ? String(object.slippage) : "",
+      htlcExpirationTimestamp: isSet(object.htlcExpirationTimestamp) ? String(object.htlcExpirationTimestamp) : "",
+      htlcCreationHash: isSet(object.htlcCreationHash) ? String(object.htlcCreationHash) : "",
+      htlcCreationVout: isSet(object.htlcCreationVout) ? Number(object.htlcCreationVout) : 0,
+      htlcVersion: isSet(object.htlcVersion) ? String(object.htlcVersion) : "",
+      senderPubKey: isSet(object.senderPubKey) ? bytesFromBase64(object.senderPubKey) : new Uint8Array(),
       options: isSet(object.options) ? String(object.options) : "",
     };
   },
@@ -276,6 +326,14 @@ export const MsgRequestSwapTransaction = {
     message.fee !== undefined && (obj.fee = message.fee);
     message.dex !== undefined && (obj.dex = message.dex);
     message.slippage !== undefined && (obj.slippage = message.slippage);
+    message.htlcExpirationTimestamp !== undefined && (obj.htlcExpirationTimestamp = message.htlcExpirationTimestamp);
+    message.htlcCreationHash !== undefined && (obj.htlcCreationHash = message.htlcCreationHash);
+    message.htlcCreationVout !== undefined && (obj.htlcCreationVout = Math.round(message.htlcCreationVout));
+    message.htlcVersion !== undefined && (obj.htlcVersion = message.htlcVersion);
+    message.senderPubKey !== undefined
+      && (obj.senderPubKey = base64FromBytes(
+        message.senderPubKey !== undefined ? message.senderPubKey : new Uint8Array(),
+      ));
     message.options !== undefined && (obj.options = message.options);
     return obj;
   },
@@ -294,6 +352,11 @@ export const MsgRequestSwapTransaction = {
     message.fee = object.fee ?? "";
     message.dex = object.dex ?? "";
     message.slippage = object.slippage ?? "";
+    message.htlcExpirationTimestamp = object.htlcExpirationTimestamp ?? "";
+    message.htlcCreationHash = object.htlcCreationHash ?? "";
+    message.htlcCreationVout = object.htlcCreationVout ?? 0;
+    message.htlcVersion = object.htlcVersion ?? "";
+    message.senderPubKey = object.senderPubKey ?? new Uint8Array();
     message.options = object.options ?? "";
     return message;
   },
@@ -1325,6 +1388,31 @@ var globalThis: any = (() => {
   throw "Unable to locate global object";
 })();
 
+function bytesFromBase64(b64: string): Uint8Array {
+  if (globalThis.Buffer) {
+    return Uint8Array.from(globalThis.Buffer.from(b64, "base64"));
+  } else {
+    const bin = globalThis.atob(b64);
+    const arr = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; ++i) {
+      arr[i] = bin.charCodeAt(i);
+    }
+    return arr;
+  }
+}
+
+function base64FromBytes(arr: Uint8Array): string {
+  if (globalThis.Buffer) {
+    return globalThis.Buffer.from(arr).toString("base64");
+  } else {
+    const bin: string[] = [];
+    arr.forEach((byte) => {
+      bin.push(String.fromCharCode(byte));
+    });
+    return globalThis.btoa(bin.join(""));
+  }
+}
+
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 
 export type DeepPartial<T> = T extends Builtin ? T

package/src/types.ts

@@ -28,6 +28,23 @@ export enum CurrencyOptions {
     USD = "USD",
 }
 
+export interface Permit2SubmitOptions {
+    r: string;
+    s: string;
+    v: number; // 27 | 28
+    deadline: number; // unix timestamp (seconds)
+}
+
+export interface SubmitOptionsPayload {
+    signature?: string;
+    feeId?: string;
+    chargeFeeAtTarget?: boolean;
+    transactionIdSeed?: string;
+    transactionIdSignature?: string;
+    permit2?: Permit2SubmitOptions;
+    [key: string]: unknown;
+}
+
 export interface RequestHtlcReclaimProps {
     senderAddress: string;
     txHash: string;
@@ -56,6 +73,7 @@ export interface RequestTransferTxProps {
     htlcExpirationTimestamp?: string;
     htlcVersion?: string;
     senderPubKey?: Uint8Array;
+    // JSON-serialized SubmitOptionsPayload
     options: string;
 }
 
@@ -71,6 +89,12 @@ export interface RequestSwapTxProps {
     fee: string;
     dex: string;
     slippage: string;
+    htlcExpirationTimestamp?: string;
+    htlcCreationHash?: string;
+    htlcCreationVout?: number;
+    htlcVersion?: string;
+    senderPubKey?: Uint8Array;
+    // JSON-serialized SubmitOptionsPayload
     options: string;
 }
 
@@ -83,6 +107,7 @@ export interface RequestExternalTxProps {
     targetSymbol: CurrencyOptions;
     amount: string;
     fee: string;
+    // JSON-serialized SubmitOptionsPayload
     options: string;
 }