@relayprotocol/relay-ton-wallet-adapter 2.0.0

package/_esm/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

package/_esm/src/adapter.js

@@ -0,0 +1,199 @@
+import { LogLevel, getClient } from '@relayprotocol/relay-sdk';
+import { TonClient } from '@ton/ton';
+import { Address, Cell, beginCell, loadMessage, storeMessage } from '@ton/core';
+// TON Connect CHAIN identifier for mainnet (Relay only supports TON mainnet).
+const TON_MAINNET_CHAIN = '-239';
+// Relay's numeric chainId for TON mainnet. TON is single-chain for Relay, so
+// the adapter owns this rather than taking it as a parameter.
+const TON_CHAIN_ID = 224235520;
+const DEFAULT_VALID_FOR_SECONDS = 300;
+const CONFIRM_POLL_MS = 2000;
+const CONFIRM_TIMEOUT_MS = 120_000;
+const CONFIRM_TX_LOOKBACK = 32;
+/**
+ * Adapts a TON wallet for use with the Relay SDK.
+ *
+ * The user's key lives in their wallet (e.g. Dynamic / TON Connect), so this
+ * adapter never signs. It maps the Relay quote step into a TON Connect request,
+ * hands it to the wallet-provided `sendTransaction` callback (which signs +
+ * broadcasts), and then confirms the origin transaction landed successfully.
+ *
+ * @param walletAddress - The connected wallet's address.
+ * @param sendTransaction - Wallet callback that signs + broadcasts a request.
+ */
+export const adaptTonWallet = (walletAddress, sendTransaction) => {
+    if (typeof sendTransaction !== 'function') {
+        throw new Error('adaptTonWallet requires a sendTransaction function');
+    }
+    // Parse (and validate) the wallet address once, then reuse it for confirmation.
+    const walletAccount = Address.parse(walletAddress);
+    return {
+        vmType: 'tonvm',
+        getChainId: async () => TON_CHAIN_ID,
+        address: async () => walletAddress,
+        handleSignMessageStep: async () => {
+            // Not used by deposit/bridge flows; mirrors the other VM adapters.
+            throw new Error('Message signing not implemented for TON');
+        },
+        handleSendTransactionStep: async (_chainId, stepItem) => {
+            const client = getClient();
+            const messages = stepItem.data.messages;
+            if (!messages || messages.length === 0) {
+                throw new Error('TON transaction step is missing messages');
+            }
+            // Relay returns internal-message fields (to/value/body); map them to the
+            // TON Connect request shape the wallet expects (address/amount/payload).
+            // TON Connect has no per-message bounce flag — the wallet derives it from
+            // the address form — so honor the step's `bounce` field by re-encoding the
+            // address (e.g. bounce:false -> non-bounceable `UQ…`). Sending a deposit
+            // to the bounceable form makes the depository bounce the funds back.
+            const request = {
+                validUntil: Math.floor(Date.now() / 1000) + DEFAULT_VALID_FOR_SECONDS,
+                network: TON_MAINNET_CHAIN,
+                messages: messages.map((message) => ({
+                    address: encodeAddress(message.to, message.bounce),
+                    amount: message.value.toString(),
+                    ...(message.body ? { payload: message.body } : {}),
+                    ...(message.stateInit ? { stateInit: message.stateInit } : {})
+                }))
+            };
+            client.log(['Sending TON transaction', request], LogLevel.Verbose);
+            const result = await sendTransaction(request);
+            // The wallet returns the signed external-message BOC (base64). Reduce it
+            // to the external-message hash so callers get a clean identifier (the raw
+            // BOC mangles explorer URLs) that also matches the on-chain transaction.
+            const boc = result.boc ?? result.transactionHash;
+            if (!boc) {
+                throw new Error('No result returned from the TON wallet');
+            }
+            const messageHash = toMessageHash(boc, walletAccount);
+            client.log(['TON transaction submitted', messageHash], LogLevel.Verbose);
+            return messageHash;
+        },
+        handleConfirmTransactionStep: async (externalMessageHash, chainId) => {
+            const client = getClient();
+            // Read the TON RPC from the Relay client's chain config so integrators can
+            // override it by configuring the chain — no adapter-level endpoint option.
+            const rpcUrl = client.chains.find((chain) => chain.id === chainId)
+                ?.httpRpcUrl;
+            if (!rpcUrl) {
+                throw new Error(`No TON httpRpcUrl configured for chainId ${chainId} in the Relay client`);
+            }
+            const tonClient = new TonClient({ endpoint: rpcUrl });
+            // `handleSendTransactionStep` returns the external-message hash, which
+            // equals the inbound message hash of the transaction it produces. Poll the
+            // wallet's recent transactions for that one and confirm the origin
+            // (deposit) executed successfully. This confirms the wallet's external-in
+            // transaction; it does not independently verify each emitted internal
+            // message against the Relay step.
+            const start = Date.now();
+            const maxAttempts = Math.ceil(CONFIRM_TIMEOUT_MS / CONFIRM_POLL_MS) + 1;
+            for (let attempt = 0; attempt < maxAttempts; attempt++) {
+                let match;
+                try {
+                    const transactions = await tonClient.getTransactions(walletAccount, {
+                        limit: CONFIRM_TX_LOOKBACK
+                    });
+                    for (const tx of transactions) {
+                        if (!tx.inMessage) {
+                            continue;
+                        }
+                        if (hashMessage(tx.inMessage) === externalMessageHash) {
+                            match = {
+                                hash: tx.hash().toString('hex'),
+                                lt: tx.lt.toString(),
+                                description: tx.description
+                            };
+                            break;
+                        }
+                    }
+                }
+                catch (error) {
+                    client.log(['Error polling for TON transaction', error], LogLevel.Verbose);
+                }
+                if (match) {
+                    if (!isTransactionSuccessful(match.description)) {
+                        client.log(['TON transaction failed', match.description], LogLevel.Verbose);
+                        throw new Error('TON transaction failed');
+                    }
+                    return { hash: match.hash, lt: match.lt };
+                }
+                if (Date.now() - start > CONFIRM_TIMEOUT_MS) {
+                    break;
+                }
+                await new Promise((resolve) => setTimeout(resolve, CONFIRM_POLL_MS));
+            }
+            throw new Error('TON transaction confirmation timed out');
+        },
+        switchChain: () => Promise.resolve()
+    };
+};
+/** Canonical message hash, used identically for the BOC and on-chain messages. */
+const hashMessage = (message) => {
+    return beginCell()
+        .store(storeMessage(message))
+        .endCell()
+        .hash()
+        .toString('hex');
+};
+/**
+ * Reduce the wallet's result to the external-message hash. The wallet returns
+ * the signed external-message BOC; we parse it as a message and hash it via the
+ * same `hashMessage` used on-chain (so both sides use identical serialization).
+ * Validates it's an external-in message addressed to the expected wallet. Falls
+ * back only when the input is already a 64-char hex hash.
+ */
+const toMessageHash = (bocOrHash, expectedWallet) => {
+    try {
+        const message = loadMessage(Cell.fromBase64(bocOrHash).beginParse());
+        if (message.info.type !== 'external-in') {
+            throw new Error(`Expected an external-in message, got ${message.info.type}`);
+        }
+        if (expectedWallet && !message.info.dest.equals(expectedWallet)) {
+            throw new Error('TON wallet returned a BOC for an unexpected account');
+        }
+        return hashMessage(message);
+    }
+    catch (error) {
+        const normalized = bocOrHash.trim().replace(/^0x/, '').toLowerCase();
+        if (/^[0-9a-f]{64}$/.test(normalized)) {
+            return normalized;
+        }
+        throw error;
+    }
+};
+/**
+ * TON Connect derives a message's bounceability from the address form, so
+ * re-encode the destination to match the Relay step's `bounce` flag
+ * (`bounce: false` -> non-bounceable `UQ…`). When `bounce` is undefined the
+ * address is left as-is; a malformed address with an explicit flag is a bad
+ * step and fails loudly.
+ */
+const encodeAddress = (to, bounce) => {
+    if (bounce === undefined) {
+        return to;
+    }
+    return Address.parse(to).toString({ bounceable: bounce, urlSafe: true });
+};
+/**
+ * Origin success: the external message executed and the wallet emitted its
+ * action. Deliberately lenient — only an explicit failure (aborted, or a phase
+ * reporting `success: false`) is treated as failed, to avoid false negatives on
+ * a deposit that actually landed (the SDK's route polling catches real route
+ * failures separately).
+ */
+const isTransactionSuccessful = (description) => {
+    const desc = description;
+    if (desc?.type !== 'generic') {
+        return true;
+    }
+    if (desc.aborted === true) {
+        return false;
+    }
+    const computeOk = desc.computePhase?.type === 'vm'
+        ? desc.computePhase.success !== false
+        : true;
+    const actionOk = desc.actionPhase ? desc.actionPhase.success !== false : true;
+    return computeOk && actionOk;
+};
+//# sourceMappingURL=adapter.js.map

package/_esm/src/adapter.js.map

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

package/_esm/src/index.js

@@ -0,0 +1,3 @@
+export * from './adapter.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/_esm/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/_esm/src/types.js

@@ -0,0 +1,7 @@
+// TonConnect-compatible transaction request shapes.
+//
+// These mirror the TON Connect `SendTransactionRequest` spec and the request
+// shape accepted by wallet providers such as Dynamic's `sendTransaction`:
+// https://www.dynamic.xyz/docs/javascript/reference/ton/send-transaction
+export {};
+//# sourceMappingURL=types.js.map

package/_esm/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE"}