@meshconnect/uwc-ton-connector 0.8.3 → 0.9.0-snapshot.2007cea

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2,6 +2,7 @@ export { NamespacedStorage } from './namespaced-storage';
2
2
  export { isValidBase64 } from './validation';
3
3
  export { buildTonTransactionRequest, buildSignDataPayload, executeSignData, unwrapBoc, bocToHash, toFriendlyAddress } from './ton-transaction-utils';
4
4
  export { buildJettonTransferPayload, buildTonNativeRequestFromJettonTransfer } from './jetton-transfer';
5
+ export { buildTonCommentPayload, MAX_TON_COMMENT_BYTES } from './text-comment';
5
6
  export { TonConnectConnector } from './ton-connect-connector';
6
7
  export { WALLET_RESPONSE_TIMEOUT_MS, withWalletResponseTimeout } from './ton-connect-session-restore';
7
8
  export { TON_CONNECT_INJECTED_STORAGE_PREFIX, tryRestoreInjectedSession } from './ton-connect-injected-restore';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,SAAS,EACT,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,0BAA0B,EAC1B,uCAAuC,EACxC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,gCAAgC,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,SAAS,EACT,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,0BAA0B,EAC1B,uCAAuC,EACxC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,gCAAgC,CAAA"}
package/dist/index.js CHANGED
@@ -2,6 +2,7 @@ export { NamespacedStorage } from './namespaced-storage';
2
2
  export { isValidBase64 } from './validation';
3
3
  export { buildTonTransactionRequest, buildSignDataPayload, executeSignData, unwrapBoc, bocToHash, toFriendlyAddress } from './ton-transaction-utils';
4
4
  export { buildJettonTransferPayload, buildTonNativeRequestFromJettonTransfer } from './jetton-transfer';
5
+ export { buildTonCommentPayload, MAX_TON_COMMENT_BYTES } from './text-comment';
5
6
  export { TonConnectConnector } from './ton-connect-connector';
6
7
  export { WALLET_RESPONSE_TIMEOUT_MS, withWalletResponseTimeout } from './ton-connect-session-restore';
7
8
  export { TON_CONNECT_INJECTED_STORAGE_PREFIX, tryRestoreInjectedSession } from './ton-connect-injected-restore';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,SAAS,EACT,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,0BAA0B,EAC1B,uCAAuC,EACxC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,gCAAgC,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,SAAS,EACT,iBAAiB,EAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,0BAA0B,EAC1B,uCAAuC,EACxC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,gCAAgC,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"jetton-transfer.d.ts","sourceRoot":"","sources":["../src/jetton-transfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,wBAAwB,CAAA;AAiB/B;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA8DjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uCAAuC,CAC3D,MAAM,EAAE,uBAAuB,EAC/B,yBAAyB,EAAE,MAAM,EACjC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,wBAAwB,CAAC,CAQnC"}
1
+ {"version":3,"file":"jetton-transfer.d.ts","sourceRoot":"","sources":["../src/jetton-transfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,wBAAwB,CAAA;AAe/B;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA2EjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uCAAuC,CAC3D,MAAM,EAAE,uBAAuB,EAC/B,yBAAyB,EAAE,MAAM,EACjC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,wBAAwB,CAAC,CAQnC"}
@@ -1,4 +1,5 @@
1
1
  import { importTonCore } from './ton-core';
2
+ import { buildTextCommentCell } from './text-comment';
2
3
  /**
3
4
  * TEP-74 Jetton transfer op code. Identifies the message as a token transfer.
4
5
  * This is a protocol-level constant defined in the standard — all Jetton contracts
@@ -6,8 +7,6 @@ import { importTonCore } from './ton-core';
6
7
  * @see https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md
7
8
  */
8
9
  const JETTON_TRANSFER_OP = 0x0f8a7ea5;
9
- /** TEP-74 forward_payload comment op code (0 = text comment). */
10
- const FORWARD_PAYLOAD_OP_COMMENT = 0;
11
10
  /** Max value for a 64-bit unsigned integer (TEP-74 query_id). */
12
11
  const MAX_UINT64 = 18446744073709551615n;
13
12
  /**
@@ -22,7 +21,7 @@ const MAX_UINT64 = 18446744073709551615n;
22
21
  * @returns Base64-encoded BOC of the transfer cell (use as payload in TonNativeTransferRequest)
23
22
  */
24
23
  export async function buildJettonTransferPayload(params) {
25
- const { beginCell, Address } = await importTonCore();
24
+ const { beginCell, Address, comment } = await importTonCore();
26
25
  let queryId;
27
26
  try {
28
27
  queryId = BigInt(params.queryId ?? '0');
@@ -55,9 +54,21 @@ export async function buildJettonTransferPayload(params) {
55
54
  if (forwardTonAmount < 0n) {
56
55
  throw new Error('forwardTonAmount must be non-negative');
57
56
  }
58
- const hasForwardComment = params.forwardComment != null &&
59
- params.forwardComment.length > 0 &&
60
- forwardTonAmount > 0n;
57
+ // An absent or empty comment means "no comment" — the conventional reading of an
58
+ // optional string. Anything else is a comment the caller means to deliver, and
59
+ // `buildTextCommentCell` is the authority on whether it can be (a whitespace-only
60
+ // memo attributes nothing, so it is rejected rather than sent).
61
+ const forwardComment = params.forwardComment != null && params.forwardComment !== ''
62
+ ? params.forwardComment
63
+ : undefined;
64
+ // TEP-74 only delivers forward_payload alongside forwarded TON: with zero
65
+ // forwardTonAmount the recipient's jetton wallet is never notified and the
66
+ // comment is discarded on-chain. Silently dropping it is the exact failure this
67
+ // encoder exists to prevent, so refuse the combination instead.
68
+ if (forwardComment !== undefined && forwardTonAmount === 0n) {
69
+ throw new Error('forwardComment requires a non-zero forwardTonAmount; with no TON forwarded the ' +
70
+ 'comment is not delivered to the recipient');
71
+ }
61
72
  const body = beginCell()
62
73
  .storeUint(JETTON_TRANSFER_OP, 32)
63
74
  .storeUint(queryId, 64)
@@ -66,13 +77,11 @@ export async function buildJettonTransferPayload(params) {
66
77
  .storeAddress(responseDestination)
67
78
  .storeBit(0) // no custom_payload
68
79
  .storeCoins(forwardTonAmount);
69
- if (hasForwardComment) {
70
- const forwardPayload = beginCell()
71
- .storeUint(FORWARD_PAYLOAD_OP_COMMENT, 32)
72
- .storeStringTail(params.forwardComment)
73
- .endCell();
80
+ if (forwardComment !== undefined) {
81
+ // Same text-comment encoding as a native transfer's comment payload, so the
82
+ // op code and the single-cell bound have one implementation between them.
74
83
  body.storeBit(1);
75
- body.storeRef(forwardPayload);
84
+ body.storeRef(buildTextCommentCell(comment, forwardComment));
76
85
  }
77
86
  else {
78
87
  body.storeBit(0);
@@ -1 +1 @@
1
- {"version":3,"file":"jetton-transfer.js","sourceRoot":"","sources":["../src/jetton-transfer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"jetton-transfer.js","sourceRoot":"","sources":["../src/jetton-transfer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import type { Cell } from '@ton/core';
2
+ /** `@ton/core`'s canonical text-comment encoder. */
3
+ type CommentEncoder = typeof import('@ton/core').comment;
4
+ /**
5
+ * Comment bytes that fit in one cell alongside the op code.
6
+ *
7
+ * Exported so a caller can reject an unusable memo up front. The encoder throws
8
+ * on one too, but by then the caller is usually mid-transfer — Link reaches it
9
+ * only after pre-registering and emitting `transferInitiated`, which would leave
10
+ * a registered transfer that never gets signed.
11
+ *
12
+ * A cell holds 1023 bits; the 32-bit op leaves 991, or 123 whole bytes.
13
+ * `@ton/core` would silently chain the remainder into ref cells (TON's "snake"
14
+ * string layout). That is valid on-chain, but consumers vary in how faithfully
15
+ * they reassemble it, and a deposit memo that the receiving venue reads back
16
+ * truncated is worse than one we refused to send. So a comment is held to a
17
+ * single cell and anything longer is rejected.
18
+ */
19
+ export declare const MAX_TON_COMMENT_BYTES = 123;
20
+ /**
21
+ * Build the text-comment cell for a message body.
22
+ *
23
+ * The encoding itself is `@ton/core`'s `comment()` — 32 zero bits followed by
24
+ * the UTF-8 string. Those leading bits are what makes the body unambiguously
25
+ * text: without them its first four bytes are read as an op code, so a comment
26
+ * colliding with a real op (a jetton transfer, an NFT transfer) would be
27
+ * executed as a command by the receiving contract instead of displayed. This
28
+ * wrapper exists for the length and blankness bounds, not to reimplement the
29
+ * layout — Tonkeeper encodes its own comments through the same function.
30
+ *
31
+ * Shared by the native-transfer comment payload and the TEP-74 jetton
32
+ * `forward_payload` so both carry identical bounds.
33
+ *
34
+ * @param encodeComment - `comment` from {@link importTonCore}; injected so
35
+ * callers that already hold the module don't import it twice.
36
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
37
+ */
38
+ export declare function buildTextCommentCell(encodeComment: CommentEncoder, text: string): Cell;
39
+ /**
40
+ * Encode a text comment as a base64 BOC, ready to pass as the `payload` of a
41
+ * `TonNativeTransferRequest`.
42
+ *
43
+ * TON has no memo field. Exchanges that hand out a shared deposit address plus
44
+ * a per-user memo expect that memo as the message's comment, so a native
45
+ * transfer to such an address must carry this payload or the deposit arrives
46
+ * unattributable — confirmed on-chain, but credited to nobody.
47
+ *
48
+ * Callers must not hand-roll the BOC: `payload` is an opaque base64 cell, and
49
+ * `@tonconnect/sdk` rejects anything that isn't one — at send time, after the
50
+ * user has already committed to the transfer.
51
+ *
52
+ * @example
53
+ * const payload = await buildTonCommentPayload('846504056')
54
+ * await sendTransaction({ from, to, amount, payload })
55
+ *
56
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
57
+ */
58
+ export declare function buildTonCommentPayload(text: string): Promise<string>;
59
+ export {};
60
+ //# sourceMappingURL=text-comment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text-comment.d.ts","sourceRoot":"","sources":["../src/text-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGrC,oDAAoD;AACpD,KAAK,cAAc,GAAG,cAAc,WAAW,EAAE,OAAO,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAuBxC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,cAAc,EAC7B,IAAI,EAAE,MAAM,GACX,IAAI,CAGN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E"}
@@ -0,0 +1,79 @@
1
+ import { importTonCore } from './ton-core';
2
+ /**
3
+ * Comment bytes that fit in one cell alongside the op code.
4
+ *
5
+ * Exported so a caller can reject an unusable memo up front. The encoder throws
6
+ * on one too, but by then the caller is usually mid-transfer — Link reaches it
7
+ * only after pre-registering and emitting `transferInitiated`, which would leave
8
+ * a registered transfer that never gets signed.
9
+ *
10
+ * A cell holds 1023 bits; the 32-bit op leaves 991, or 123 whole bytes.
11
+ * `@ton/core` would silently chain the remainder into ref cells (TON's "snake"
12
+ * string layout). That is valid on-chain, but consumers vary in how faithfully
13
+ * they reassemble it, and a deposit memo that the receiving venue reads back
14
+ * truncated is worse than one we refused to send. So a comment is held to a
15
+ * single cell and anything longer is rejected.
16
+ */
17
+ export const MAX_TON_COMMENT_BYTES = 123;
18
+ /** Stateless across `encode` calls, so one instance serves every comment. */
19
+ const utf8 = new TextEncoder();
20
+ /**
21
+ * Reject comments that cannot serve as an attribution key before encoding them.
22
+ *
23
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
24
+ */
25
+ function assertEncodableComment(text) {
26
+ if (typeof text !== 'string' || text.trim().length === 0) {
27
+ throw new Error('TON comment must be a non-empty, non-blank string');
28
+ }
29
+ const byteLength = utf8.encode(text).length;
30
+ if (byteLength > MAX_TON_COMMENT_BYTES) {
31
+ throw new Error(`TON comment is ${byteLength} bytes; the maximum that fits a single cell is ${MAX_TON_COMMENT_BYTES}`);
32
+ }
33
+ }
34
+ /**
35
+ * Build the text-comment cell for a message body.
36
+ *
37
+ * The encoding itself is `@ton/core`'s `comment()` — 32 zero bits followed by
38
+ * the UTF-8 string. Those leading bits are what makes the body unambiguously
39
+ * text: without them its first four bytes are read as an op code, so a comment
40
+ * colliding with a real op (a jetton transfer, an NFT transfer) would be
41
+ * executed as a command by the receiving contract instead of displayed. This
42
+ * wrapper exists for the length and blankness bounds, not to reimplement the
43
+ * layout — Tonkeeper encodes its own comments through the same function.
44
+ *
45
+ * Shared by the native-transfer comment payload and the TEP-74 jetton
46
+ * `forward_payload` so both carry identical bounds.
47
+ *
48
+ * @param encodeComment - `comment` from {@link importTonCore}; injected so
49
+ * callers that already hold the module don't import it twice.
50
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
51
+ */
52
+ export function buildTextCommentCell(encodeComment, text) {
53
+ assertEncodableComment(text);
54
+ return encodeComment(text);
55
+ }
56
+ /**
57
+ * Encode a text comment as a base64 BOC, ready to pass as the `payload` of a
58
+ * `TonNativeTransferRequest`.
59
+ *
60
+ * TON has no memo field. Exchanges that hand out a shared deposit address plus
61
+ * a per-user memo expect that memo as the message's comment, so a native
62
+ * transfer to such an address must carry this payload or the deposit arrives
63
+ * unattributable — confirmed on-chain, but credited to nobody.
64
+ *
65
+ * Callers must not hand-roll the BOC: `payload` is an opaque base64 cell, and
66
+ * `@tonconnect/sdk` rejects anything that isn't one — at send time, after the
67
+ * user has already committed to the transfer.
68
+ *
69
+ * @example
70
+ * const payload = await buildTonCommentPayload('846504056')
71
+ * await sendTransaction({ from, to, amount, payload })
72
+ *
73
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
74
+ */
75
+ export async function buildTonCommentPayload(text) {
76
+ const { comment } = await importTonCore();
77
+ return buildTextCommentCell(comment, text).toBoc().toString('base64');
78
+ }
79
+ //# sourceMappingURL=text-comment.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text-comment.js","sourceRoot":"","sources":["../src/text-comment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAK1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;AAExC,6EAA6E;AAC7E,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAA;AAE9B;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;IAC3C,IAAI,UAAU,GAAG,qBAAqB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,kBAAkB,UAAU,kDAAkD,qBAAqB,EAAE,CACtG,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAA6B,EAC7B,IAAY;IAEZ,sBAAsB,CAAC,IAAI,CAAC,CAAA;IAC5B,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,EAAE,CAAA;IACzC,OAAO,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AACvE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"ton-connect-connector.d.ts","sourceRoot":"","sources":["../src/ton-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EAExB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAEf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAA;AAmC/B,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,uBAAuB,CAEhB;IACf,OAAO,CAAC,qBAAqB,CAAiD;IAC9E,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,qBAAqB,CAAwC;IACrE,OAAO,CAAC,iBAAiB,CAAI;gBAEjB,MAAM,EAAE,gBAAgB;IAIpC,oEAAoE;IAC9D,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,eAAe,CAAC;YA6Bb,cAAc;IAqG5B,sEAAsE;IACtE,gBAAgB,IAAI,MAAM;IAO1B,iDAAiD;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA0C5D,uDAAuD;IACjD,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IA8B7B,qEAAqE;IAC/D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOnE,yDAAyD;IACnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAG/C,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAiB3B;;;;;;;;;OASG;IACH,iBAAiB,CACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,EAGtC,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IA6C3B,4DAA4D;IACtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,qBAAqB;IA2FnC,OAAO,CAAC,sBAAsB;YAWhB,UAAU;IAWxB,OAAO,CAAC,mBAAmB;CAM5B"}
1
+ {"version":3,"file":"ton-connect-connector.d.ts","sourceRoot":"","sources":["../src/ton-connect-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EAExB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAEf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAA;AAmC/B,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,uBAAuB,CAC8B;IAC7D,OAAO,CAAC,qBAAqB,CAAiD;IAC9E,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,qBAAqB,CAAwC;IACrE,OAAO,CAAC,iBAAiB,CAAI;gBAEjB,MAAM,EAAE,gBAAgB;IAIpC,oEAAoE;IAC9D,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,eAAe,CAAC;YA6Bb,cAAc;IAqG5B,sEAAsE;IACtE,gBAAgB,IAAI,MAAM;IAO1B,iDAAiD;IAC3C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA0C5D,uDAAuD;IACjD,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IA8B7B,qEAAqE;IAC/D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOnE,yDAAyD;IACnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC;;;;;;;;;;OAUG;IACH,gBAAgB,CACd,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAG/C,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IAiB3B;;;;;;;;;OASG;IACH,iBAAiB,CACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,EAGtC,QAAQ,EAAE,sBAAsB,GAC/B,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS;IA6C3B,4DAA4D;IACtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,qBAAqB;IA2FnC,OAAO,CAAC,sBAAsB;YAWhB,UAAU;IAWxB,OAAO,CAAC,mBAAmB;CAM5B"}
@@ -1 +1 @@
1
- {"version":3,"file":"ton-connect-connector.js","sourceRoot":"","sources":["../src/ton-connect-connector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ton-connect-connector.js","sourceRoot":"","sources":["../src/ton-connect-connector.ts"],"names":[],"mappings":"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"}
@@ -28,12 +28,14 @@ export declare function buildTonTransactionMessage(request: TonNativeTransferReq
28
28
  * The SDK expects `from` in raw format; the UI's user-friendly address (UQ...) is a fallback only.
29
29
  *
30
30
  * `validUntil` defaults to now + 5 min (TX_EXPIRY_SECONDS). TON transactions require an expiry.
31
- * `sendMode` — bit flags for message handling (e.g. 128 = send entire balance).
32
- * See: https://docs.ton.org/v3/documentation/smart-contracts/message-management/message-modes-cookbook
31
+ *
32
+ * The request carries exactly `validUntil` / `network` / `from` / `messages`.
33
+ * `@tonconnect/sdk` validates the shape before the wallet sees it and throws on
34
+ * any other top-level key, so nothing else may be added here.
35
+ *
36
+ * @throws if `request.sendMode` is set — see {@link TonNativeTransferRequest.sendMode}.
33
37
  */
34
- export declare function buildTonTransactionRequest(request: TonNativeTransferRequest, senderRawAddress?: string): SendTransactionRequest & {
35
- sendMode?: number;
36
- };
38
+ export declare function buildTonTransactionRequest(request: TonNativeTransferRequest, senderRawAddress?: string): SendTransactionRequest;
37
39
  export declare function buildSignDataPayload(message: string, override?: TonSignDataPayload): TonSignDataPayload;
38
40
  /**
39
41
  * Execute signData on the SDK, normalizing errors for wallets that don't support it.
@@ -1 +1 @@
1
- {"version":3,"file":"ton-transaction-utils.d.ts","sourceRoot":"","sources":["../src/ton-transaction-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAQ7D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,GACjD,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB;;;;;EAkB3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,CAAC,EAAE,MAAM,GACxB,sBAAsB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAahD;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,kBAAkB,CAEpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE;IACH,QAAQ,CAAC,EAAE,CACT,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvE,EACD,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAClD,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5D"}
1
+ {"version":3,"file":"ton-transaction-utils.d.ts","sourceRoot":"","sources":["../src/ton-transaction-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAQ7D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,MAAM,GACjD,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB;;;;;EAkB3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,CAAC,EAAE,MAAM,GACxB,sBAAsB,CAqBxB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,kBAAkB,CAEpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE;IACH,QAAQ,CAAC,EAAE,CACT,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvE,EACD,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAClD,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5D"}
@@ -45,20 +45,29 @@ export function buildTonTransactionMessage(request) {
45
45
  * The SDK expects `from` in raw format; the UI's user-friendly address (UQ...) is a fallback only.
46
46
  *
47
47
  * `validUntil` defaults to now + 5 min (TX_EXPIRY_SECONDS). TON transactions require an expiry.
48
- * `sendMode` — bit flags for message handling (e.g. 128 = send entire balance).
49
- * See: https://docs.ton.org/v3/documentation/smart-contracts/message-management/message-modes-cookbook
48
+ *
49
+ * The request carries exactly `validUntil` / `network` / `from` / `messages`.
50
+ * `@tonconnect/sdk` validates the shape before the wallet sees it and throws on
51
+ * any other top-level key, so nothing else may be added here.
52
+ *
53
+ * @throws if `request.sendMode` is set — see {@link TonNativeTransferRequest.sendMode}.
50
54
  */
51
55
  export function buildTonTransactionRequest(request, senderRawAddress) {
56
+ // TON Connect has no request-level send mode: the wallet picks one (Tonkeeper
57
+ // uses pay-gas-separately + ignore-errors). Forwarding `sendMode` produced a
58
+ // request the SDK rejected with "Request contains extra properties" — a
59
+ // failure that only surfaced at send time. Refuse it here, with the reason.
60
+ if (request.sendMode !== undefined) {
61
+ throw new Error('TON Connect does not accept a request-level sendMode; the wallet chooses the ' +
62
+ 'message mode. Remove sendMode — to send an entire balance, compute the amount instead.');
63
+ }
52
64
  const message = buildTonTransactionMessage(request);
53
- const txRequest = {
65
+ return {
54
66
  validUntil: request.validUntil ?? Math.floor(Date.now() / 1000) + TX_EXPIRY_SECONDS,
55
67
  network: TON_MAINNET_CHAIN_ID,
56
68
  from: senderRawAddress ?? request.from,
57
69
  messages: [message]
58
70
  };
59
- if (request.sendMode !== undefined)
60
- txRequest.sendMode = request.sendMode;
61
- return txRequest;
62
71
  }
63
72
  export function buildSignDataPayload(message, override) {
64
73
  return override ?? { type: 'text', text: message };
@@ -1 +1 @@
1
- {"version":3,"file":"ton-transaction-utils.js","sourceRoot":"","sources":["../src/ton-transaction-utils.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ton-transaction-utils.js","sourceRoot":"","sources":["../src/ton-transaction-utils.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@meshconnect/uwc-ton-connector",
3
- "version": "0.8.3",
3
+ "version": "0.9.0-snapshot.2007cea",
4
4
  "description": "TON Connect connector for Universal Wallet Connector — mobile QR/URI wallet connections",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -18,8 +18,8 @@
18
18
  "dependencies": {
19
19
  "@ton/core": "^0.63.1",
20
20
  "@tonconnect/sdk": "^3.0.5",
21
- "@meshconnect/uwc-constants": "0.7.5",
22
- "@meshconnect/uwc-types": "0.27.0"
21
+ "@meshconnect/uwc-constants": "0.7.6-snapshot.2007cea",
22
+ "@meshconnect/uwc-types": "0.27.1-snapshot.2007cea"
23
23
  },
24
24
  "devDependencies": {
25
25
  "typescript": "^5.9.3"
package/src/index.ts CHANGED
@@ -12,6 +12,7 @@ export {
12
12
  buildJettonTransferPayload,
13
13
  buildTonNativeRequestFromJettonTransfer
14
14
  } from './jetton-transfer'
15
+ export { buildTonCommentPayload, MAX_TON_COMMENT_BYTES } from './text-comment'
15
16
  export { TonConnectConnector } from './ton-connect-connector'
16
17
  export {
17
18
  WALLET_RESPONSE_TIMEOUT_MS,
@@ -60,6 +60,55 @@ describe('buildJettonTransferPayload', () => {
60
60
  expect(comment).toBe('for coffee')
61
61
  })
62
62
 
63
+ it('refuses a forward comment with no forwarded TON rather than dropping it', async () => {
64
+ // TEP-74 only delivers forward_payload alongside forwarded TON, so this
65
+ // combination would encode a comment the recipient never receives.
66
+ await expect(
67
+ buildJettonTransferPayload({
68
+ destination: DEST,
69
+ amount: '500000',
70
+ responseDestination: RESPONSE_DEST,
71
+ forwardComment: 'invoice-42'
72
+ })
73
+ ).rejects.toThrow(/requires a non-zero forwardTonAmount/)
74
+ })
75
+
76
+ it.each([
77
+ ['undefined', undefined],
78
+ ['empty string', '']
79
+ ])(
80
+ 'treats a %s forward comment as absent, with no forward ref',
81
+ async (_, forwardComment) => {
82
+ const payload = await buildJettonTransferPayload({
83
+ destination: DEST,
84
+ amount: '500000',
85
+ responseDestination: RESPONSE_DEST,
86
+ forwardComment
87
+ })
88
+ const slice = Cell.fromBase64(payload).beginParse()
89
+ slice.loadUint(32) // op
90
+ slice.loadUintBig(64) // query_id
91
+ slice.loadCoins() // amount
92
+ slice.loadAddress() // destination
93
+ slice.loadAddress() // response_destination
94
+ slice.loadBit() // custom_payload
95
+ slice.loadCoins() // forward_ton_amount
96
+ expect(slice.loadBit()).toBe(false) // no forward_payload ref
97
+ }
98
+ )
99
+
100
+ it('rejects a whitespace-only forward comment — it attributes nothing', async () => {
101
+ await expect(
102
+ buildJettonTransferPayload({
103
+ destination: DEST,
104
+ amount: '500000',
105
+ responseDestination: RESPONSE_DEST,
106
+ forwardTonAmount: '20000000',
107
+ forwardComment: ' '
108
+ })
109
+ ).rejects.toThrow(/non-empty, non-blank/)
110
+ })
111
+
63
112
  it('uses custom queryId when provided', async () => {
64
113
  const params: TonJettonTransferParams = {
65
114
  destination: DEST,
@@ -3,6 +3,7 @@ import type {
3
3
  TonNativeTransferRequest
4
4
  } from '@meshconnect/uwc-types'
5
5
  import { importTonCore } from './ton-core'
6
+ import { buildTextCommentCell } from './text-comment'
6
7
 
7
8
  /**
8
9
  * TEP-74 Jetton transfer op code. Identifies the message as a token transfer.
@@ -12,9 +13,6 @@ import { importTonCore } from './ton-core'
12
13
  */
13
14
  const JETTON_TRANSFER_OP = 0x0f8a7ea5
14
15
 
15
- /** TEP-74 forward_payload comment op code (0 = text comment). */
16
- const FORWARD_PAYLOAD_OP_COMMENT = 0
17
-
18
16
  /** Max value for a 64-bit unsigned integer (TEP-74 query_id). */
19
17
  const MAX_UINT64 = 18446744073709551615n
20
18
 
@@ -32,7 +30,7 @@ const MAX_UINT64 = 18446744073709551615n
32
30
  export async function buildJettonTransferPayload(
33
31
  params: TonJettonTransferParams
34
32
  ): Promise<string> {
35
- const { beginCell, Address } = await importTonCore()
33
+ const { beginCell, Address, comment } = await importTonCore()
36
34
 
37
35
  let queryId: bigint
38
36
  try {
@@ -66,10 +64,25 @@ export async function buildJettonTransferPayload(
66
64
  if (forwardTonAmount < 0n) {
67
65
  throw new Error('forwardTonAmount must be non-negative')
68
66
  }
69
- const hasForwardComment =
70
- params.forwardComment != null &&
71
- params.forwardComment.length > 0 &&
72
- forwardTonAmount > 0n
67
+ // An absent or empty comment means "no comment" — the conventional reading of an
68
+ // optional string. Anything else is a comment the caller means to deliver, and
69
+ // `buildTextCommentCell` is the authority on whether it can be (a whitespace-only
70
+ // memo attributes nothing, so it is rejected rather than sent).
71
+ const forwardComment =
72
+ params.forwardComment != null && params.forwardComment !== ''
73
+ ? params.forwardComment
74
+ : undefined
75
+
76
+ // TEP-74 only delivers forward_payload alongside forwarded TON: with zero
77
+ // forwardTonAmount the recipient's jetton wallet is never notified and the
78
+ // comment is discarded on-chain. Silently dropping it is the exact failure this
79
+ // encoder exists to prevent, so refuse the combination instead.
80
+ if (forwardComment !== undefined && forwardTonAmount === 0n) {
81
+ throw new Error(
82
+ 'forwardComment requires a non-zero forwardTonAmount; with no TON forwarded the ' +
83
+ 'comment is not delivered to the recipient'
84
+ )
85
+ }
73
86
 
74
87
  const body = beginCell()
75
88
  .storeUint(JETTON_TRANSFER_OP, 32)
@@ -80,13 +93,11 @@ export async function buildJettonTransferPayload(
80
93
  .storeBit(0) // no custom_payload
81
94
  .storeCoins(forwardTonAmount)
82
95
 
83
- if (hasForwardComment) {
84
- const forwardPayload = beginCell()
85
- .storeUint(FORWARD_PAYLOAD_OP_COMMENT, 32)
86
- .storeStringTail(params.forwardComment as string)
87
- .endCell()
96
+ if (forwardComment !== undefined) {
97
+ // Same text-comment encoding as a native transfer's comment payload, so the
98
+ // op code and the single-cell bound have one implementation between them.
88
99
  body.storeBit(1)
89
- body.storeRef(forwardPayload)
100
+ body.storeRef(buildTextCommentCell(comment, forwardComment))
90
101
  } else {
91
102
  body.storeBit(0)
92
103
  }
@@ -0,0 +1,113 @@
1
+ import { describe, it, expect } from 'vitest'
2
+ import { Cell } from '@ton/core'
3
+ import { buildTonCommentPayload, MAX_TON_COMMENT_BYTES } from './text-comment'
4
+ import { buildTonTransactionMessage } from './ton-transaction-utils'
5
+ import { isValidBase64 } from './validation'
6
+
7
+ /** Decode a base64 BOC the way a wallet or explorer would, via @ton/core. */
8
+ function decode(payload: string) {
9
+ const slice = Cell.fromBase64(payload).beginParse()
10
+ return { op: slice.loadUint(32), comment: slice.loadStringTail() }
11
+ }
12
+
13
+ describe('buildTonCommentPayload', () => {
14
+ it('encodes a deposit memo as an op-0 text comment', async () => {
15
+ const payload = await buildTonCommentPayload('846504056')
16
+ expect(decode(payload)).toEqual({ op: 0, comment: '846504056' })
17
+ })
18
+
19
+ it('encodes a hex-style memo', async () => {
20
+ const payload = await buildTonCommentPayload('9FA1703C4278A5269762')
21
+ expect(decode(payload).comment).toBe('9FA1703C4278A5269762')
22
+ })
23
+
24
+ it('round-trips multi-byte UTF-8 without mangling', async () => {
25
+ const payload = await buildTonCommentPayload('メモ-café-😀')
26
+ expect(decode(payload).comment).toBe('メモ-café-😀')
27
+ })
28
+
29
+ it('preserves surrounding whitespace rather than silently trimming it', async () => {
30
+ const payload = await buildTonCommentPayload(' 42 ')
31
+ expect(decode(payload).comment).toBe(' 42 ')
32
+ })
33
+
34
+ it('produces base64 that survives the payload guard', async () => {
35
+ const payload = await buildTonCommentPayload('846504056')
36
+ expect(isValidBase64(payload)).toBe(true)
37
+ expect(
38
+ buildTonTransactionMessage({
39
+ from: 'UQDmiMK-9hmTn5b8FKuh-ovRVAdx4u-TXuwInN9yGIuhcTiP',
40
+ to: 'UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR',
41
+ amount: '100900900',
42
+ payload
43
+ })
44
+ ).toMatchObject({ payload })
45
+ })
46
+
47
+ it('keeps the comment in a single cell at the documented maximum', async () => {
48
+ const payload = await buildTonCommentPayload(
49
+ 'x'.repeat(MAX_TON_COMMENT_BYTES)
50
+ )
51
+ const cell = Cell.fromBase64(payload)
52
+ expect(cell.refs).toHaveLength(0)
53
+ expect(decode(payload).comment).toHaveLength(MAX_TON_COMMENT_BYTES)
54
+ })
55
+
56
+ it('rejects a comment one byte past the single-cell maximum', async () => {
57
+ await expect(
58
+ buildTonCommentPayload('x'.repeat(MAX_TON_COMMENT_BYTES + 1))
59
+ ).rejects.toThrow(/124 bytes/)
60
+ })
61
+
62
+ it('measures the limit in bytes, not characters', async () => {
63
+ // 62 two-byte characters = 124 bytes, but only 62 characters.
64
+ await expect(buildTonCommentPayload('é'.repeat(62))).rejects.toThrow(
65
+ /124 bytes/
66
+ )
67
+ await expect(buildTonCommentPayload('é'.repeat(61))).resolves.toBeTypeOf(
68
+ 'string'
69
+ )
70
+ })
71
+
72
+ it.each([
73
+ ['empty', ''],
74
+ ['spaces', ' '],
75
+ ['tab and newline', '\t\n']
76
+ ])(
77
+ 'rejects a %s comment — a blank memo attributes nothing',
78
+ async (_, value) => {
79
+ await expect(buildTonCommentPayload(value)).rejects.toThrow(
80
+ /non-empty, non-blank/
81
+ )
82
+ }
83
+ )
84
+
85
+ // @tonconnect/sdk validates every message payload before the wallet sees it
86
+ // (`validateSendTransactionRequest` → `isValidBoc`) and throws a TonConnectError
87
+ // when it fails. Its check is a standard-base64 charset plus a literal 'te6cc'
88
+ // prefix — the base64 of a BOC's magic bytes. Encoding the cell any other way
89
+ // (base64url, hex, a bare string) would be refused at send time, so the shape
90
+ // is pinned here rather than discovered on a real transfer.
91
+ describe('@tonconnect/sdk payload validation', () => {
92
+ const SDK_BASE64 =
93
+ /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/
94
+
95
+ it.each([
96
+ ['a numeric memo', '846504056'],
97
+ ['a hex-style memo', '9FA1703C4278A5269762'],
98
+ ['multi-byte UTF-8', 'メモ-café-😀'],
99
+ ['a maximum-length comment', 'x'.repeat(MAX_TON_COMMENT_BYTES)]
100
+ ])('%s serializes to a BOC the SDK accepts', async (_, text) => {
101
+ const payload = await buildTonCommentPayload(text)
102
+ expect(payload.startsWith('te6cc')).toBe(true)
103
+ expect(SDK_BASE64.test(payload)).toBe(true)
104
+ })
105
+ })
106
+
107
+ it('never emits a body that could be read as another op code', async () => {
108
+ // A comment whose text is itself a jetton-transfer op code must still land
109
+ // as text: the 32 zero bits in front are what makes that unambiguous.
110
+ const payload = await buildTonCommentPayload('0f8a7ea5')
111
+ expect(decode(payload)).toEqual({ op: 0, comment: '0f8a7ea5' })
112
+ })
113
+ })
@@ -0,0 +1,93 @@
1
+ import type { Cell } from '@ton/core'
2
+ import { importTonCore } from './ton-core'
3
+
4
+ /** `@ton/core`'s canonical text-comment encoder. */
5
+ type CommentEncoder = typeof import('@ton/core').comment
6
+
7
+ /**
8
+ * Comment bytes that fit in one cell alongside the op code.
9
+ *
10
+ * Exported so a caller can reject an unusable memo up front. The encoder throws
11
+ * on one too, but by then the caller is usually mid-transfer — Link reaches it
12
+ * only after pre-registering and emitting `transferInitiated`, which would leave
13
+ * a registered transfer that never gets signed.
14
+ *
15
+ * A cell holds 1023 bits; the 32-bit op leaves 991, or 123 whole bytes.
16
+ * `@ton/core` would silently chain the remainder into ref cells (TON's "snake"
17
+ * string layout). That is valid on-chain, but consumers vary in how faithfully
18
+ * they reassemble it, and a deposit memo that the receiving venue reads back
19
+ * truncated is worse than one we refused to send. So a comment is held to a
20
+ * single cell and anything longer is rejected.
21
+ */
22
+ export const MAX_TON_COMMENT_BYTES = 123
23
+
24
+ /** Stateless across `encode` calls, so one instance serves every comment. */
25
+ const utf8 = new TextEncoder()
26
+
27
+ /**
28
+ * Reject comments that cannot serve as an attribution key before encoding them.
29
+ *
30
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
31
+ */
32
+ function assertEncodableComment(text: string): void {
33
+ if (typeof text !== 'string' || text.trim().length === 0) {
34
+ throw new Error('TON comment must be a non-empty, non-blank string')
35
+ }
36
+
37
+ const byteLength = utf8.encode(text).length
38
+ if (byteLength > MAX_TON_COMMENT_BYTES) {
39
+ throw new Error(
40
+ `TON comment is ${byteLength} bytes; the maximum that fits a single cell is ${MAX_TON_COMMENT_BYTES}`
41
+ )
42
+ }
43
+ }
44
+
45
+ /**
46
+ * Build the text-comment cell for a message body.
47
+ *
48
+ * The encoding itself is `@ton/core`'s `comment()` — 32 zero bits followed by
49
+ * the UTF-8 string. Those leading bits are what makes the body unambiguously
50
+ * text: without them its first four bytes are read as an op code, so a comment
51
+ * colliding with a real op (a jetton transfer, an NFT transfer) would be
52
+ * executed as a command by the receiving contract instead of displayed. This
53
+ * wrapper exists for the length and blankness bounds, not to reimplement the
54
+ * layout — Tonkeeper encodes its own comments through the same function.
55
+ *
56
+ * Shared by the native-transfer comment payload and the TEP-74 jetton
57
+ * `forward_payload` so both carry identical bounds.
58
+ *
59
+ * @param encodeComment - `comment` from {@link importTonCore}; injected so
60
+ * callers that already hold the module don't import it twice.
61
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
62
+ */
63
+ export function buildTextCommentCell(
64
+ encodeComment: CommentEncoder,
65
+ text: string
66
+ ): Cell {
67
+ assertEncodableComment(text)
68
+ return encodeComment(text)
69
+ }
70
+
71
+ /**
72
+ * Encode a text comment as a base64 BOC, ready to pass as the `payload` of a
73
+ * `TonNativeTransferRequest`.
74
+ *
75
+ * TON has no memo field. Exchanges that hand out a shared deposit address plus
76
+ * a per-user memo expect that memo as the message's comment, so a native
77
+ * transfer to such an address must carry this payload or the deposit arrives
78
+ * unattributable — confirmed on-chain, but credited to nobody.
79
+ *
80
+ * Callers must not hand-roll the BOC: `payload` is an opaque base64 cell, and
81
+ * `@tonconnect/sdk` rejects anything that isn't one — at send time, after the
82
+ * user has already committed to the transfer.
83
+ *
84
+ * @example
85
+ * const payload = await buildTonCommentPayload('846504056')
86
+ * await sendTransaction({ from, to, amount, payload })
87
+ *
88
+ * @throws if the comment is blank or exceeds {@link MAX_TON_COMMENT_BYTES}.
89
+ */
90
+ export async function buildTonCommentPayload(text: string): Promise<string> {
91
+ const { comment } = await importTonCore()
92
+ return buildTextCommentCell(comment, text).toBoc().toString('base64')
93
+ }
@@ -55,8 +55,7 @@ export class TonConnectConnector implements Connector {
55
55
  private connectedNetworkId: NetworkId | null = null
56
56
  private connectTimeout: ReturnType<typeof setTimeout> | null = null
57
57
  private toUserFriendlyAddressFn:
58
- | ((hex: string, testOnly?: boolean) => string)
59
- | null = null
58
+ ((hex: string, testOnly?: boolean) => string) | null = null
60
59
  private UserRejectsErrorClass: (new (...args: never[]) => Error) | null = null
61
60
  private connectInFlight = false
62
61
  private abortPendingConnect: (() => void) | null = null
@@ -55,19 +55,30 @@ describe('buildTonTransactionRequest', () => {
55
55
  expect(result.validUntil).toBe(9999999)
56
56
  })
57
57
 
58
- it('includes sendMode when provided', () => {
59
- const result = buildTonTransactionRequest({
60
- ...baseRequest,
61
- sendMode: 3
62
- } as TonNativeTransferRequest)
63
-
64
- expect(result.sendMode).toBe(3)
58
+ it('refuses a sendMode instead of building a request the SDK will reject', () => {
59
+ // TON Connect has no request-level send mode. Forwarding it added a
60
+ // top-level key outside the allowed set, and @tonconnect/sdk threw
61
+ // "Request contains extra properties" at send time — after the caller had
62
+ // already committed to a transfer. Fail at build time, with the reason.
63
+ expect(() =>
64
+ buildTonTransactionRequest({
65
+ ...baseRequest,
66
+ sendMode: 3
67
+ } as TonNativeTransferRequest)
68
+ ).toThrow(/does not accept a request-level sendMode/)
65
69
  })
66
70
 
67
- it('omits sendMode when not provided', () => {
71
+ it('emits only the top-level keys @tonconnect/sdk allows', () => {
72
+ // Mirrors validateSendTransactionRequest's allowed-keys check. Anything else
73
+ // here is rejected before the wallet is ever asked to sign.
68
74
  const result = buildTonTransactionRequest(baseRequest)
69
75
 
70
- expect(result).not.toHaveProperty('sendMode')
76
+ expect(Object.keys(result).sort()).toEqual([
77
+ 'from',
78
+ 'messages',
79
+ 'network',
80
+ 'validUntil'
81
+ ])
71
82
  })
72
83
 
73
84
  it('overrides from with senderRawAddress when provided', () => {
@@ -62,25 +62,37 @@ export function buildTonTransactionMessage(request: TonNativeTransferRequest) {
62
62
  * The SDK expects `from` in raw format; the UI's user-friendly address (UQ...) is a fallback only.
63
63
  *
64
64
  * `validUntil` defaults to now + 5 min (TX_EXPIRY_SECONDS). TON transactions require an expiry.
65
- * `sendMode` — bit flags for message handling (e.g. 128 = send entire balance).
66
- * See: https://docs.ton.org/v3/documentation/smart-contracts/message-management/message-modes-cookbook
65
+ *
66
+ * The request carries exactly `validUntil` / `network` / `from` / `messages`.
67
+ * `@tonconnect/sdk` validates the shape before the wallet sees it and throws on
68
+ * any other top-level key, so nothing else may be added here.
69
+ *
70
+ * @throws if `request.sendMode` is set — see {@link TonNativeTransferRequest.sendMode}.
67
71
  */
68
72
  export function buildTonTransactionRequest(
69
73
  request: TonNativeTransferRequest,
70
74
  senderRawAddress?: string
71
- ): SendTransactionRequest & { sendMode?: number } {
75
+ ): SendTransactionRequest {
76
+ // TON Connect has no request-level send mode: the wallet picks one (Tonkeeper
77
+ // uses pay-gas-separately + ignore-errors). Forwarding `sendMode` produced a
78
+ // request the SDK rejected with "Request contains extra properties" — a
79
+ // failure that only surfaced at send time. Refuse it here, with the reason.
80
+ if (request.sendMode !== undefined) {
81
+ throw new Error(
82
+ 'TON Connect does not accept a request-level sendMode; the wallet chooses the ' +
83
+ 'message mode. Remove sendMode — to send an entire balance, compute the amount instead.'
84
+ )
85
+ }
86
+
72
87
  const message = buildTonTransactionMessage(request)
73
88
 
74
- const txRequest: SendTransactionRequest & { sendMode?: number } = {
89
+ return {
75
90
  validUntil:
76
91
  request.validUntil ?? Math.floor(Date.now() / 1000) + TX_EXPIRY_SECONDS,
77
92
  network: TON_MAINNET_CHAIN_ID,
78
93
  from: senderRawAddress ?? request.from,
79
94
  messages: [message]
80
95
  }
81
- if (request.sendMode !== undefined) txRequest.sendMode = request.sendMode
82
-
83
- return txRequest
84
96
  }
85
97
 
86
98
  export function buildSignDataPayload(