crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/ton/messages.js

@@ -0,0 +1,397 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_COMMENT_CELLS = exports.MAX_BODY_CELLS = exports.MAX_BODY_BOC_LENGTH = exports.MAX_ADDRESS_BOC_LENGTH = exports.MAX_MEMO_BYTES = exports.OP = void 0;
+exports.sdkAddress = sdkAddress;
+exports.memoBytes = memoBytes;
+exports.commentCell = commentCell;
+exports.nativeMessage = nativeMessage;
+exports.jettonMessage = jettonMessage;
+exports.addressArgument = addressArgument;
+exports.addressFromBoc = addressFromBoc;
+exports.decodeComment = decodeComment;
+exports.decodeJettonTransfer = decodeJettonTransfer;
+exports.decodeJettonInternalTransfer = decodeJettonInternalTransfer;
+exports.decodeJettonNotification = decodeJettonNotification;
+exports.requestHeaderOf = requestHeaderOf;
+exports.decodeWalletRequest = decodeWalletRequest;
+exports.messageFacts = messageFacts;
+exports.cellFromBoc = cellFromBoc;
+exports.messageBody = messageBody;
+/**
+ * TON message bodies over `@ton/core`: text comments (the memo), native transfers, TEP-74
+ * jetton transfers, and the decoders the verdict and history paths use. Loaded only
+ * through the adapter manifest's `load()`.
+ */
+const core_1 = require("@ton/core");
+const error_1 = require("../../core/errors/error");
+const address_1 = require("./address");
+const api_1 = require("./api");
+const fees_1 = require("./fees");
+/** TEP-74 op codes, and the text-comment op (0). */
+exports.OP = Object.freeze({
+    comment: 0,
+    jettonTransfer: 0x0f8a7ea5,
+    jettonInternalTransfer: 0x178d4519,
+    jettonNotification: 0x7362d09c,
+    jettonExcesses: 0xd53276db,
+    w5SignedExternal: 0x7369676e,
+    w5SignedInternal: 0x73696e74,
+});
+/** The longest memo, in UTF-8 bytes (library policy: comments stay a few cells). */
+exports.MAX_MEMO_BYTES = 1024;
+/**
+ * The longest provider text `addressFromBoc` decodes (untrusted text is capped before
+ * decoding). An address is one cell of at most 1023 bits, under 200 base64 characters as
+ * a BOC; the rest leaves room for a slice that still carries refs, so a jetton wallet is
+ * never refused for its encoding.
+ */
+exports.MAX_ADDRESS_BOC_LENGTH = 4096;
+// The body limits (`MAX_BODY_CELLS`, `MAX_BODY_BOC_LENGTH`) and their header check live
+// in the SDK-free `api.ts`, which bounds the cells it hands on the same way.
+var api_2 = require("./api");
+Object.defineProperty(exports, "MAX_BODY_BOC_LENGTH", { enumerable: true, get: function () { return api_2.MAX_BODY_BOC_LENGTH; } });
+Object.defineProperty(exports, "MAX_BODY_CELLS", { enumerable: true, get: function () { return api_2.MAX_BODY_CELLS; } });
+/**
+ * The most cells a comment's snake chain may span. A cell holds at most 127 bytes, so a
+ * memo of `MAX_MEMO_BYTES` spans 9 cells; 256 cells (about 32 KB of text) keeps the
+ * longer comments other wallets write readable while bounding the work on an untrusted
+ * body. A longer chain reads as no comment.
+ */
+exports.MAX_COMMENT_CELLS = 256;
+/**
+ * An address read from an untrusted body, in raw form; null for a workchain other than 0
+ * or -1, which names no TON account.
+ */
+function toRaw(address) {
+    const workchain = address.workChain;
+    if (workchain !== 0 && workchain !== -1)
+        return null;
+    return (0, address_1.rawAddress)(workchain, address.hash);
+}
+/**
+ * The SDK's `Address` for a raw address, parsed strictly: `Address.parseRaw` takes any
+ * `parseInt` workchain and throws a bare `Error`.
+ */
+function sdkAddress(raw) {
+    const parsed = (0, address_1.parseTonAddress)(raw);
+    if (parsed?.form !== 'raw') {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'not a raw TON address');
+    }
+    return new core_1.Address(parsed.workchain, Buffer.from(parsed.hash));
+}
+const MAX_QUERY_ID = (1n << 64n) - 1n;
+/**
+ * An amount that does not fit `Coins` is refused with a fixed text that never carries it
+ * (`@ton/core` would throw a bare `Error` naming the value).
+ */
+function coins(value) {
+    if (typeof value !== 'bigint' || value < 0n || value > fees_1.MAX_COINS) {
+        throw new error_1.ValidationError('INVALID_AMOUNT', 'a TON amount must be in [0, 2^120 - 1]');
+    }
+    return value;
+}
+/** A TEP-74 `query_id` is a uint64: range-checked here, never wrapped. */
+function queryIdOf(value) {
+    if (typeof value !== 'bigint' || value < 0n || value > MAX_QUERY_ID) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'a TON query id must be a uint64');
+    }
+    return value;
+}
+function memoBytes(memo) {
+    return Buffer.byteLength(memo, 'utf8');
+}
+/** A text comment: op 0, then the UTF-8 text as a snake string. */
+function commentCell(memo) {
+    return (0, core_1.comment)(memo);
+}
+/** A native transfer of `value` nanograms; `bounce` comes from the recipient's address. */
+function nativeMessage(args) {
+    return (0, core_1.internal)({
+        to: sdkAddress(args.to),
+        value: coins(args.value),
+        bounce: args.bounce,
+        ...(args.memo !== undefined ? { body: commentCell(args.memo) } : {}),
+    });
+}
+/**
+ * A TEP-74 `transfer` to the sender's own jetton wallet: `amount` base units to the owner
+ * `destination`, excess back to `responseDestination`, and `forwardAmount` nanograms with
+ * the memo (if any) as the recipient's notification payload.
+ */
+function jettonMessage(args) {
+    const to = sdkAddress(args.jettonWallet);
+    const attached = coins(args.attached);
+    const body = (0, core_1.beginCell)()
+        .storeUint(exports.OP.jettonTransfer, 32)
+        .storeUint(queryIdOf(args.queryId), 64)
+        .storeCoins(coins(args.amount))
+        .storeAddress(sdkAddress(args.destination))
+        .storeAddress(sdkAddress(args.responseDestination))
+        .storeMaybeRef(null)
+        .storeCoins(coins(args.forwardAmount));
+    if (args.memo !== undefined)
+        body.storeBit(true).storeRef(commentCell(args.memo));
+    else
+        body.storeBit(false);
+    return (0, core_1.internal)({
+        to,
+        value: attached,
+        bounce: true,
+        body: body.endCell(),
+    });
+}
+/** A one-cell slice holding `raw`: the `get_wallet_address` argument, as base64 BOC. */
+function addressArgument(raw) {
+    return (0, core_1.beginCell)().storeAddress(sdkAddress(raw)).endCell().toBoc().toString('base64');
+}
+/** The address a get-method returned in a cell or slice (base64 BOC); null if none. */
+function addressFromBoc(boc) {
+    if (typeof boc !== 'string' || boc.length > exports.MAX_ADDRESS_BOC_LENGTH)
+        return null;
+    try {
+        const address = core_1.Cell.fromBoc(Buffer.from(boc, 'base64'))[0]
+            ?.beginParse()
+            .loadMaybeAddress();
+        return address ? toRaw(address) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The text of a comment body, or undefined for any other body. The snake string is read
+ * in one pass: `@ton/core`'s `loadStringTail` recurses per cell and concatenates at each
+ * level, which is quadratic in the chain length (3.6 s for one 1 MB comment). Past
+ * `MAX_COMMENT_CELLS` cells, or for a cell that is not a whole number of bytes with at
+ * most one ref, it is no comment.
+ */
+function decodeComment(body) {
+    try {
+        let slice = body.beginParse();
+        if (slice.remainingBits < 32 || slice.loadUint(32) !== exports.OP.comment)
+            return undefined;
+        const chunks = [];
+        for (let cells = 1;; cells += 1) {
+            if (cells > exports.MAX_COMMENT_CELLS)
+                return undefined;
+            const bits = slice.remainingBits;
+            if (bits % 8 !== 0 || slice.remainingRefs > 1)
+                return undefined;
+            if (bits > 0)
+                chunks.push(slice.loadBuffer(bits / 8));
+            if (slice.remainingRefs === 0)
+                break;
+            slice = slice.loadRef().beginParse();
+        }
+        return Buffer.concat(chunks).toString('utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The comment carried in a `forward_payload:(Either Cell ^Cell)`, if it is one. */
+function forwardComment(slice) {
+    if (slice.remainingBits < 1)
+        return undefined;
+    const inRef = slice.loadBit();
+    if (inRef)
+        return slice.remainingRefs > 0 ? decodeComment(slice.loadRef()) : undefined;
+    return decodeComment((0, core_1.beginCell)().storeSlice(slice).endCell());
+}
+/** A TEP-74 `transfer` body, or null for any other body. */
+function decodeJettonTransfer(body) {
+    try {
+        const slice = body.beginParse();
+        if (slice.loadUint(32) !== exports.OP.jettonTransfer)
+            return null;
+        const queryId = slice.loadUintBig(64);
+        const amount = slice.loadCoins();
+        const destination = slice.loadAddress();
+        const response = slice.loadMaybeAddress();
+        const customPayload = slice.loadMaybeRef() !== null;
+        const forwardAmount = slice.loadCoins();
+        const memo = forwardComment(slice);
+        const recipient = toRaw(destination);
+        if (recipient === null)
+            return null;
+        return {
+            queryId,
+            amount,
+            destination: recipient,
+            responseDestination: response ? toRaw(response) : null,
+            customPayload,
+            forwardAmount,
+            ...(memo !== undefined ? { comment: memo } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** A TEP-74 `internal_transfer` body, or null for any other body. */
+function decodeJettonInternalTransfer(body) {
+    try {
+        const slice = body.beginParse();
+        if (slice.loadUint(32) !== exports.OP.jettonInternalTransfer)
+            return null;
+        const queryId = slice.loadUintBig(64);
+        const amount = slice.loadCoins();
+        const from = slice.loadMaybeAddress();
+        slice.loadMaybeAddress();
+        slice.loadCoins();
+        const memo = forwardComment(slice);
+        return {
+            queryId,
+            amount,
+            from: from ? toRaw(from) : null,
+            ...(memo !== undefined ? { comment: memo } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** A TEP-74 `transfer_notification` body, or null for any other body. */
+function decodeJettonNotification(body) {
+    try {
+        const slice = body.beginParse();
+        if (slice.loadUint(32) !== exports.OP.jettonNotification)
+            return null;
+        const queryId = slice.loadUintBig(64);
+        const amount = slice.loadCoins();
+        const sender = slice.loadMaybeAddress();
+        const memo = forwardComment(slice);
+        return {
+            queryId,
+            amount,
+            sender: sender ? toRaw(sender) : null,
+            ...(memo !== undefined ? { comment: memo } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** A W5 external request's bits: op, wallet id, `valid_until`, seqno, two flags, signature. */
+const W5_EXTERNAL_BITS = 32 + 32 + 32 + 32 + 1 + 1 + 512;
+/** A v4r2 request's least bits: signature, subwallet id, `valid_until`, seqno. */
+const V4_HEADER_BITS = 512 + 32 + 32 + 32;
+/**
+ * The signed header of an external wallet request, read alone, as the proof reads a
+ * consumer's seqno, so that the replay guard knows stored bytes whose message list does
+ * not decode: a W5 request's (its op, then the wallet id, `valid_until` and seqno, in a
+ * body of exactly a W5 request's length) or a v4r2 request's (after the signature,
+ * whatever the op). Null when the body cannot hold one. Nothing here says whose request
+ * it is.
+ */
+function requestHeaderOf(body) {
+    try {
+        const bits = body.bits.length;
+        const s = body.beginParse();
+        const w5 = bits === W5_EXTERNAL_BITS && s.preloadUint(32) === exports.OP.w5SignedExternal;
+        if (!w5 && bits < V4_HEADER_BITS)
+            return null;
+        s.skip(w5 ? 32 : 512);
+        const walletId = w5 ? s.loadInt(32) : s.loadUint(32);
+        const validUntil = s.loadUint(32);
+        return { walletId, validUntil, seqno: s.loadUint(32) };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The signed request inside a v4r2 or v5r1 external message body: its seqno, lifetime and
+ * the internal messages it asks for. Null for anything else (another wallet, a plugin or
+ * extension request): the verdict then has no evidence and decides nothing.
+ */
+function decodeWalletRequest(body) {
+    try {
+        const bits = body.bits.length;
+        const head = body.beginParse();
+        const op = bits >= 32 ? head.preloadUint(32) : undefined;
+        if (op === exports.OP.w5SignedExternal || op === exports.OP.w5SignedInternal) {
+            const s = body.beginParse();
+            s.skip(32);
+            const walletId = s.loadInt(32);
+            const validUntil = s.loadUint(32);
+            const seqno = s.loadUint(32);
+            const list = s.loadMaybeRef();
+            if (s.loadBit())
+                return null; // extended actions: not a plain transfer
+            if (s.remainingBits !== 512 || s.remainingRefs !== 0)
+                return null;
+            const actions = list ? (0, core_1.loadOutList)(list.beginParse()) : [];
+            const messages = [];
+            const modes = [];
+            for (const action of actions) {
+                if (action.type !== 'sendMsg')
+                    return null;
+                messages.push(action.outMsg);
+                modes.push(action.mode);
+            }
+            const auth = op === exports.OP.w5SignedExternal ? 'external' : 'internal';
+            return { auth, walletId, seqno, validUntil, messages, modes };
+        }
+        const s = body.beginParse();
+        s.skip(512);
+        const walletId = s.loadUint(32);
+        const validUntil = s.loadUint(32);
+        const seqno = s.loadUint(32);
+        if (s.loadUint(8) !== 0)
+            return null; // v4 op 0: simple send
+        const messages = [];
+        const modes = [];
+        while (s.remainingRefs > 0) {
+            modes.push(s.loadUint(8));
+            messages.push((0, core_1.loadMessageRelaxed)(s.loadRef().beginParse()));
+        }
+        if (s.remainingBits !== 0)
+            return null;
+        return { auth: 'external', walletId, seqno, validUntil, messages, modes };
+    }
+    catch {
+        return null;
+    }
+}
+/** A message's destination (raw), value and body hash (hex), for matching on chain. */
+function messageFacts(message) {
+    if (message.info.type !== 'internal')
+        return null;
+    const to = toRaw(message.info.dest);
+    if (to === null)
+        return null;
+    return {
+        to,
+        value: message.info.value.coins,
+        bodyHash: message.body.hash().toString('hex'),
+        body: message.body,
+    };
+}
+/** A body cell from a base64 BOC; null when it does not parse. */
+function cellFromBoc(boc) {
+    if (typeof boc !== 'string' || !(0, api_1.bocWithinLimits)(boc))
+        return null;
+    try {
+        const cells = core_1.Cell.fromBoc(Buffer.from(boc, 'base64'));
+        return cells.length === 1 ? cells[0] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * An indexed message's body, bound to the body hash the quorum keyed. A body that does
+ * not parse or hash to `bodyHash`, or that comes without one, is a malformed answer
+ * (retryable): no verdict or decoding ever reads an unbound body.
+ */
+function messageBody(message) {
+    if (message.body === undefined)
+        return null;
+    const cell = cellFromBoc(message.body);
+    if (!cell || !message.bodyHash || cell.hash().toString('hex') !== message.bodyHash) {
+        throw new error_1.ProviderError('PROVIDER_UNAVAILABLE', 'the indexer returned a message body that does not match its hash', { retryable: true });
+    }
+    return cell;
+}
+//# sourceMappingURL=messages.js.map

package/dist/adapters/ton/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/adapters/ton/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TON message bodies over `@ton/core`: text comments (the memo), native transfers, TEP-74\n * jetton transfers, and the decoders the verdict and history paths use. Loaded only\n * through the adapter manifest's `load()`.\n */\nimport {\n  Address,\n  Cell,\n  beginCell,\n  comment,\n  internal,\n  loadMessageRelaxed,\n  loadOutList,\n  type MessageRelaxed,\n} from '@ton/core';\nimport { ProviderError, ValidationError } from '../../core/errors/error';\nimport { parseTonAddress, rawAddress, type TonWorkchain } from './address';\nimport { bocWithinLimits } from './api';\nimport { MAX_COINS } from './fees';\n\n/** TEP-74 op codes, and the text-comment op (0). */\nexport const OP = Object.freeze({\n  comment: 0,\n  jettonTransfer: 0x0f8a7ea5,\n  jettonInternalTransfer: 0x178d4519,\n  jettonNotification: 0x7362d09c,\n  jettonExcesses: 0xd53276db,\n  w5SignedExternal: 0x7369676e,\n  w5SignedInternal: 0x73696e74,\n});\n\n/** The longest memo, in UTF-8 bytes (library policy: comments stay a few cells). */\nexport const MAX_MEMO_BYTES = 1024;\n\n/**\n * The longest provider text `addressFromBoc` decodes (untrusted text is capped before\n * decoding). An address is one cell of at most 1023 bits, under 200 base64 characters as\n * a BOC; the rest leaves room for a slice that still carries refs, so a jetton wallet is\n * never refused for its encoding.\n */\nexport const MAX_ADDRESS_BOC_LENGTH = 4096;\n\n// The body limits (`MAX_BODY_CELLS`, `MAX_BODY_BOC_LENGTH`) and their header check live\n// in the SDK-free `api.ts`, which bounds the cells it hands on the same way.\nexport { MAX_BODY_BOC_LENGTH, MAX_BODY_CELLS } from './api';\n\n/**\n * The most cells a comment's snake chain may span. A cell holds at most 127 bytes, so a\n * memo of `MAX_MEMO_BYTES` spans 9 cells; 256 cells (about 32 KB of text) keeps the\n * longer comments other wallets write readable while bounding the work on an untrusted\n * body. A longer chain reads as no comment.\n */\nexport const MAX_COMMENT_CELLS = 256;\n\n/**\n * An address read from an untrusted body, in raw form; null for a workchain other than 0\n * or -1, which names no TON account.\n */\nfunction toRaw(address: Address): string | null {\n  const workchain = address.workChain;\n  if (workchain !== 0 && workchain !== -1) return null;\n  return rawAddress(workchain as TonWorkchain, address.hash);\n}\n\n/**\n * The SDK's `Address` for a raw address, parsed strictly: `Address.parseRaw` takes any\n * `parseInt` workchain and throws a bare `Error`.\n */\nexport function sdkAddress(raw: string): Address {\n  const parsed = parseTonAddress(raw);\n  if (parsed?.form !== 'raw') {\n    throw new ValidationError('INVALID_ADDRESS', 'not a raw TON address');\n  }\n  return new Address(parsed.workchain, Buffer.from(parsed.hash));\n}\n\nconst MAX_QUERY_ID = (1n << 64n) - 1n;\n\n/**\n * An amount that does not fit `Coins` is refused with a fixed text that never carries it\n * (`@ton/core` would throw a bare `Error` naming the value).\n */\nfunction coins(value: bigint): bigint {\n  if (typeof value !== 'bigint' || value < 0n || value > MAX_COINS) {\n    throw new ValidationError('INVALID_AMOUNT', 'a TON amount must be in [0, 2^120 - 1]');\n  }\n  return value;\n}\n\n/** A TEP-74 `query_id` is a uint64: range-checked here, never wrapped. */\nfunction queryIdOf(value: bigint): bigint {\n  if (typeof value !== 'bigint' || value < 0n || value > MAX_QUERY_ID) {\n    throw new ValidationError('INVALID_INTENT', 'a TON query id must be a uint64');\n  }\n  return value;\n}\n\nexport function memoBytes(memo: string): number {\n  return Buffer.byteLength(memo, 'utf8');\n}\n\n/** A text comment: op 0, then the UTF-8 text as a snake string. */\nexport function commentCell(memo: string): Cell {\n  return comment(memo);\n}\n\n/** A native transfer of `value` nanograms; `bounce` comes from the recipient's address. */\nexport function nativeMessage(args: {\n  readonly to: string;\n  readonly value: bigint;\n  readonly bounce: boolean;\n  readonly memo?: string;\n}): MessageRelaxed {\n  return internal({\n    to: sdkAddress(args.to),\n    value: coins(args.value),\n    bounce: args.bounce,\n    ...(args.memo !== undefined ? { body: commentCell(args.memo) } : {}),\n  });\n}\n\n/**\n * A TEP-74 `transfer` to the sender's own jetton wallet: `amount` base units to the owner\n * `destination`, excess back to `responseDestination`, and `forwardAmount` nanograms with\n * the memo (if any) as the recipient's notification payload.\n */\nexport function jettonMessage(args: {\n  readonly jettonWallet: string;\n  readonly attached: bigint;\n  readonly queryId: bigint;\n  readonly amount: bigint;\n  readonly destination: string;\n  readonly responseDestination: string;\n  readonly forwardAmount: bigint;\n  readonly memo?: string;\n}): MessageRelaxed {\n  const to = sdkAddress(args.jettonWallet);\n  const attached = coins(args.attached);\n  const body = beginCell()\n    .storeUint(OP.jettonTransfer, 32)\n    .storeUint(queryIdOf(args.queryId), 64)\n    .storeCoins(coins(args.amount))\n    .storeAddress(sdkAddress(args.destination))\n    .storeAddress(sdkAddress(args.responseDestination))\n    .storeMaybeRef(null)\n    .storeCoins(coins(args.forwardAmount));\n  if (args.memo !== undefined) body.storeBit(true).storeRef(commentCell(args.memo));\n  else body.storeBit(false);\n  return internal({\n    to,\n    value: attached,\n    bounce: true,\n    body: body.endCell(),\n  });\n}\n\n/** A one-cell slice holding `raw`: the `get_wallet_address` argument, as base64 BOC. */\nexport function addressArgument(raw: string): string {\n  return beginCell().storeAddress(sdkAddress(raw)).endCell().toBoc().toString('base64');\n}\n\n/** The address a get-method returned in a cell or slice (base64 BOC); null if none. */\nexport function addressFromBoc(boc: string): string | null {\n  if (typeof boc !== 'string' || boc.length > MAX_ADDRESS_BOC_LENGTH) return null;\n  try {\n    const address = Cell.fromBoc(Buffer.from(boc, 'base64'))[0]\n      ?.beginParse()\n      .loadMaybeAddress();\n    return address ? toRaw(address) : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The text of a comment body, or undefined for any other body. The snake string is read\n * in one pass: `@ton/core`'s `loadStringTail` recurses per cell and concatenates at each\n * level, which is quadratic in the chain length (3.6 s for one 1 MB comment). Past\n * `MAX_COMMENT_CELLS` cells, or for a cell that is not a whole number of bytes with at\n * most one ref, it is no comment.\n */\nexport function decodeComment(body: Cell): string | undefined {\n  try {\n    let slice = body.beginParse();\n    if (slice.remainingBits < 32 || slice.loadUint(32) !== OP.comment) return undefined;\n    const chunks: Buffer[] = [];\n    for (let cells = 1; ; cells += 1) {\n      if (cells > MAX_COMMENT_CELLS) return undefined;\n      const bits = slice.remainingBits;\n      if (bits % 8 !== 0 || slice.remainingRefs > 1) return undefined;\n      if (bits > 0) chunks.push(slice.loadBuffer(bits / 8));\n      if (slice.remainingRefs === 0) break;\n      slice = slice.loadRef().beginParse();\n    }\n    return Buffer.concat(chunks).toString('utf8');\n  } catch {\n    return undefined;\n  }\n}\n\n/** The comment carried in a `forward_payload:(Either Cell ^Cell)`, if it is one. */\nfunction forwardComment(slice: ReturnType<Cell['beginParse']>): string | undefined {\n  if (slice.remainingBits < 1) return undefined;\n  const inRef = slice.loadBit();\n  if (inRef) return slice.remainingRefs > 0 ? decodeComment(slice.loadRef()) : undefined;\n  return decodeComment(beginCell().storeSlice(slice).endCell());\n}\n\nexport interface JettonTransferBody {\n  readonly queryId: bigint;\n  readonly amount: bigint;\n  readonly destination: string;\n  /** Where the excess goes; null for `addr_none` or a workchain other than 0 or -1. */\n  readonly responseDestination: string | null;\n  /** Whether a `custom_payload` rides along (for the jetton wallet's own code). */\n  readonly customPayload: boolean;\n  readonly forwardAmount: bigint;\n  readonly comment?: string;\n}\n\n/** A TEP-74 `transfer` body, or null for any other body. */\nexport function decodeJettonTransfer(body: Cell): JettonTransferBody | null {\n  try {\n    const slice = body.beginParse();\n    if (slice.loadUint(32) !== OP.jettonTransfer) return null;\n    const queryId = slice.loadUintBig(64);\n    const amount = slice.loadCoins();\n    const destination = slice.loadAddress();\n    const response = slice.loadMaybeAddress();\n    const customPayload = slice.loadMaybeRef() !== null;\n    const forwardAmount = slice.loadCoins();\n    const memo = forwardComment(slice);\n    const recipient = toRaw(destination);\n    if (recipient === null) return null;\n    return {\n      queryId,\n      amount,\n      destination: recipient,\n      responseDestination: response ? toRaw(response) : null,\n      customPayload,\n      forwardAmount,\n      ...(memo !== undefined ? { comment: memo } : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport interface JettonInternalTransferBody {\n  readonly queryId: bigint;\n  readonly amount: bigint;\n  /** The sending owner, when the body names one. */\n  readonly from: string | null;\n  readonly comment?: string;\n}\n\n/** A TEP-74 `internal_transfer` body, or null for any other body. */\nexport function decodeJettonInternalTransfer(\n  body: Cell,\n): JettonInternalTransferBody | null {\n  try {\n    const slice = body.beginParse();\n    if (slice.loadUint(32) !== OP.jettonInternalTransfer) return null;\n    const queryId = slice.loadUintBig(64);\n    const amount = slice.loadCoins();\n    const from = slice.loadMaybeAddress();\n    slice.loadMaybeAddress();\n    slice.loadCoins();\n    const memo = forwardComment(slice);\n    return {\n      queryId,\n      amount,\n      from: from ? toRaw(from) : null,\n      ...(memo !== undefined ? { comment: memo } : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport interface JettonNotificationBody {\n  readonly queryId: bigint;\n  readonly amount: bigint;\n  /** The sending owner, when the body names one. */\n  readonly sender: string | null;\n  readonly comment?: string;\n}\n\n/** A TEP-74 `transfer_notification` body, or null for any other body. */\nexport function decodeJettonNotification(body: Cell): JettonNotificationBody | null {\n  try {\n    const slice = body.beginParse();\n    if (slice.loadUint(32) !== OP.jettonNotification) return null;\n    const queryId = slice.loadUintBig(64);\n    const amount = slice.loadCoins();\n    const sender = slice.loadMaybeAddress();\n    const memo = forwardComment(slice);\n    return {\n      queryId,\n      amount,\n      sender: sender ? toRaw(sender) : null,\n      ...(memo !== undefined ? { comment: memo } : {}),\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport interface WalletRequest {\n  /**\n   * `internal`: a W5 signed request relayed in an internal message (gasless). Anyone can\n   * post such a body: it proves nothing until `requestIsOwn` authenticates it.\n   */\n  readonly auth: 'external' | 'internal';\n  /** v4r2: the subwallet id; v5r1: the signed 32-bit wallet id. */\n  readonly walletId: number;\n  readonly seqno: number;\n  readonly validUntil: number;\n  readonly messages: readonly MessageRelaxed[];\n  /** Each message's send mode, as the wallet reads it (`modes[i]` for `messages[i]`). */\n  readonly modes: readonly number[];\n}\n\n/** A W5 external request's bits: op, wallet id, `valid_until`, seqno, two flags, signature. */\nconst W5_EXTERNAL_BITS = 32 + 32 + 32 + 32 + 1 + 1 + 512;\n/** A v4r2 request's least bits: signature, subwallet id, `valid_until`, seqno. */\nconst V4_HEADER_BITS = 512 + 32 + 32 + 32;\n\n/**\n * The signed header of an external wallet request, read alone, as the proof reads a\n * consumer's seqno, so that the replay guard knows stored bytes whose message list does\n * not decode: a W5 request's (its op, then the wallet id, `valid_until` and seqno, in a\n * body of exactly a W5 request's length) or a v4r2 request's (after the signature,\n * whatever the op). Null when the body cannot hold one. Nothing here says whose request\n * it is.\n */\nexport function requestHeaderOf(body: Cell): {\n  readonly walletId: number;\n  readonly validUntil: number;\n  readonly seqno: number;\n} | null {\n  try {\n    const bits = body.bits.length;\n    const s = body.beginParse();\n    const w5 = bits === W5_EXTERNAL_BITS && s.preloadUint(32) === OP.w5SignedExternal;\n    if (!w5 && bits < V4_HEADER_BITS) return null;\n    s.skip(w5 ? 32 : 512);\n    const walletId = w5 ? s.loadInt(32) : s.loadUint(32);\n    const validUntil = s.loadUint(32);\n    return { walletId, validUntil, seqno: s.loadUint(32) };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The signed request inside a v4r2 or v5r1 external message body: its seqno, lifetime and\n * the internal messages it asks for. Null for anything else (another wallet, a plugin or\n * extension request): the verdict then has no evidence and decides nothing.\n */\nexport function decodeWalletRequest(body: Cell): WalletRequest | null {\n  try {\n    const bits = body.bits.length;\n    const head = body.beginParse();\n    const op = bits >= 32 ? head.preloadUint(32) : undefined;\n    if (op === OP.w5SignedExternal || op === OP.w5SignedInternal) {\n      const s = body.beginParse();\n      s.skip(32);\n      const walletId = s.loadInt(32);\n      const validUntil = s.loadUint(32);\n      const seqno = s.loadUint(32);\n      const list = s.loadMaybeRef();\n      if (s.loadBit()) return null; // extended actions: not a plain transfer\n      if (s.remainingBits !== 512 || s.remainingRefs !== 0) return null;\n      const actions = list ? loadOutList(list.beginParse()) : [];\n      const messages: MessageRelaxed[] = [];\n      const modes: number[] = [];\n      for (const action of actions) {\n        if (action.type !== 'sendMsg') return null;\n        messages.push(action.outMsg);\n        modes.push(action.mode);\n      }\n      const auth = op === OP.w5SignedExternal ? 'external' : 'internal';\n      return { auth, walletId, seqno, validUntil, messages, modes };\n    }\n    const s = body.beginParse();\n    s.skip(512);\n    const walletId = s.loadUint(32);\n    const validUntil = s.loadUint(32);\n    const seqno = s.loadUint(32);\n    if (s.loadUint(8) !== 0) return null; // v4 op 0: simple send\n    const messages: MessageRelaxed[] = [];\n    const modes: number[] = [];\n    while (s.remainingRefs > 0) {\n      modes.push(s.loadUint(8));\n      messages.push(loadMessageRelaxed(s.loadRef().beginParse()));\n    }\n    if (s.remainingBits !== 0) return null;\n    return { auth: 'external', walletId, seqno, validUntil, messages, modes };\n  } catch {\n    return null;\n  }\n}\n\n/** A message's destination (raw), value and body hash (hex), for matching on chain. */\nexport function messageFacts(message: MessageRelaxed): {\n  readonly to: string;\n  readonly value: bigint;\n  readonly bodyHash: string;\n  readonly body: Cell;\n} | null {\n  if (message.info.type !== 'internal') return null;\n  const to = toRaw(message.info.dest);\n  if (to === null) return null;\n  return {\n    to,\n    value: message.info.value.coins,\n    bodyHash: message.body.hash().toString('hex'),\n    body: message.body,\n  };\n}\n\n/** A body cell from a base64 BOC; null when it does not parse. */\nexport function cellFromBoc(boc: string | null | undefined): Cell | null {\n  if (typeof boc !== 'string' || !bocWithinLimits(boc)) return null;\n  try {\n    const cells = Cell.fromBoc(Buffer.from(boc, 'base64'));\n    return cells.length === 1 ? (cells[0] as Cell) : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * An indexed message's body, bound to the body hash the quorum keyed. A body that does\n * not parse or hash to `bodyHash`, or that comes without one, is a malformed answer\n * (retryable): no verdict or decoding ever reads an unbound body.\n */\nexport function messageBody(message: {\n  readonly body?: string;\n  readonly bodyHash?: string;\n}): Cell | null {\n  if (message.body === undefined) return null;\n  const cell = cellFromBoc(message.body);\n  if (!cell || !message.bodyHash || cell.hash().toString('hex') !== message.bodyHash) {\n    throw new ProviderError(\n      'PROVIDER_UNAVAILABLE',\n      'the indexer returned a message body that does not match its hash',\n      { retryable: true },\n    );\n  }\n  return cell;\n}\n"]}

package/dist/adapters/ton/native-client.d.ts

@@ -0,0 +1,10 @@
+import type { DisposableNativeClient } from '../../core/driver/types';
+import { type Transport } from '../../core/transport/types';
+/**
+ * A fresh `TonClient` over `transport` on every call; `crypto-aio/native` only. The
+ * client holds only a placeholder URL and no key (secrets stay in the transport), and
+ * nothing to close.
+ */
+export declare function tonNativeClient(transport: Transport): DisposableNativeClient;
+/** The `@ton/ton` adapter's driver factory; the manifest's `load()` returns it. */
+export declare const tonLibraryDriverFactory: import("../../core/driver/types").DriverFactory;

package/dist/adapters/ton/native-client.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tonLibraryDriverFactory = void 0;
+exports.tonNativeClient = tonNativeClient;
+/**
+ * The `@ton/ton` library module (the family shape: the client module exports the loadable
+ * factory). The native client is a `TonClient` whose `httpAdapter` posts to the
+ * transport, off the driver's own request path: the driver sends REST straight to the
+ * transport, because `TonClient` runs axios with a real request timer. SDKs are required
+ * by their bare peer names: the core turns a missing module into `DEPENDENCY_MISSING`
+ * only when the error names a peer dependency.
+ */
+const ton_1 = require("@ton/ton");
+const types_1 = require("../../core/transport/types");
+const api_1 = require("./api");
+const driver_1 = require("./driver");
+/**
+ * The tags of a native request: plain reads, except a toncenter `send*` method, which is a
+ * broadcast (as EVM's native client): a failure after the transport may have delivered
+ * it is `ambiguous`, never an invitation to sign again with a new seqno.
+ */
+const tagsOf = (body) => {
+    const method = body !== null && typeof body === 'object'
+        ? body.method
+        : undefined;
+    return typeof method === 'string' && method.startsWith('send') ? api_1.BROADCAST : api_1.READ;
+};
+/**
+ * A fresh `TonClient` over `transport` on every call; `crypto-aio/native` only. The
+ * client holds only a placeholder URL and no key (secrets stay in the transport), and
+ * nothing to close.
+ */
+function tonNativeClient(transport) {
+    const httpAdapter = (async (config) => {
+        const body = typeof config.data === 'string'
+            ? JSON.parse(config.data)
+            : config.data;
+        const data = await transport.http({ method: 'POST', path: '/jsonRPC', body, route: '/jsonRPC' }, tagsOf(body));
+        return { data, status: 200, statusText: 'OK', headers: {}, config, request: {} };
+    });
+    return {
+        client: new ton_1.TonClient({ endpoint: `${types_1.PLACEHOLDER_ORIGIN}/jsonRPC`, httpAdapter }),
+    };
+}
+/** The `@ton/ton` adapter's driver factory; the manifest's `load()` returns it. */
+exports.tonLibraryDriverFactory = (0, driver_1.tonDriverFactory)(tonNativeClient);
+//# sourceMappingURL=native-client.js.map

package/dist/adapters/ton/native-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-client.js","sourceRoot":"","sources":["../../../src/adapters/ton/native-client.ts"],"names":[],"mappings":";;;AAmCA,0CAeC;AAlDD;;;;;;;GAOG;AACH,kCAAqC;AAErC,sDAAgF;AAChF,+BAAwC;AACxC,qCAA4C;AAK5C;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,IAAa,EAAe,EAAE;IAC5C,MAAM,MAAM,GACV,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QACvC,CAAC,CAAE,IAAsC,CAAC,MAAM;QAChD,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAS,CAAC,CAAC,CAAC,UAAI,CAAC;AACpF,CAAC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,eAAe,CAAC,SAAoB;IAClD,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAA0B,EAAE,EAAE;QACxD,MAAM,IAAI,GACR,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC7B,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAa;YACtC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,CAC/B,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAC7D,MAAM,CAAC,IAAI,CAAC,CACb,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnF,CAAC,CAA2B,CAAC;IAC7B,OAAO;QACL,MAAM,EAAE,IAAI,eAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,0BAAkB,UAAU,EAAE,WAAW,EAAE,CAAC;KAClF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACtE,QAAA,uBAAuB,GAAG,IAAA,yBAAgB,EAAC,eAAe,CAAC,CAAC","sourcesContent":["/**\n * The `@ton/ton` library module (the family shape: the client module exports the loadable\n * factory). The native client is a `TonClient` whose `httpAdapter` posts to the\n * transport, off the driver's own request path: the driver sends REST straight to the\n * transport, because `TonClient` runs axios with a real request timer. SDKs are required\n * by their bare peer names: the core turns a missing module into `DEPENDENCY_MISSING`\n * only when the error names a peer dependency.\n */\nimport { TonClient } from '@ton/ton';\nimport type { DisposableNativeClient } from '../../core/driver/types';\nimport { PLACEHOLDER_ORIGIN, type Transport } from '../../core/transport/types';\nimport { BROADCAST, READ } from './api';\nimport { tonDriverFactory } from './driver';\nimport type { TonCallTags } from './types';\n\ntype HttpAdapter = NonNullable<ConstructorParameters<typeof TonClient>[0]['httpAdapter']>;\n\n/**\n * The tags of a native request: plain reads, except a toncenter `send*` method, which is a\n * broadcast (as EVM's native client): a failure after the transport may have delivered\n * it is `ambiguous`, never an invitation to sign again with a new seqno.\n */\nconst tagsOf = (body: unknown): TonCallTags => {\n  const method =\n    body !== null && typeof body === 'object'\n      ? (body as { readonly method?: unknown }).method\n      : undefined;\n  return typeof method === 'string' && method.startsWith('send') ? BROADCAST : READ;\n};\n\n/**\n * A fresh `TonClient` over `transport` on every call; `crypto-aio/native` only. The\n * client holds only a placeholder URL and no key (secrets stay in the transport), and\n * nothing to close.\n */\nexport function tonNativeClient(transport: Transport): DisposableNativeClient {\n  const httpAdapter = (async (config: { data?: unknown }) => {\n    const body =\n      typeof config.data === 'string'\n        ? (JSON.parse(config.data) as unknown)\n        : config.data;\n    const data = await transport.http(\n      { method: 'POST', path: '/jsonRPC', body, route: '/jsonRPC' },\n      tagsOf(body),\n    );\n    return { data, status: 200, statusText: 'OK', headers: {}, config, request: {} };\n  }) as unknown as HttpAdapter;\n  return {\n    client: new TonClient({ endpoint: `${PLACEHOLDER_ORIGIN}/jsonRPC`, httpAdapter }),\n  };\n}\n\n/** The `@ton/ton` adapter's driver factory; the manifest's `load()` returns it. */\nexport const tonLibraryDriverFactory = tonDriverFactory(tonNativeClient);\n"]}

package/dist/adapters/ton/network.d.ts

@@ -0,0 +1,58 @@
+import { type Capability } from '../../core/model/capability';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+/**
+ * The TON manifest's capabilities; `address-history` comes with the indexer. No
+ * `batch-transfer`: the verdict answers `failed` for a partly delivered batch, and
+ * a failed Operation sent again whole would pay twice the outputs that moved, so a TON
+ * transfer carries exactly one output.
+ */
+export declare const TON_CAPABILITIES: readonly Capability[];
+export declare const TON_INDEXER_CAPABILITIES: readonly Capability[];
+/** The ceiling of each workchain's `network` charge, in nanograms. */
+export interface TonFeeCeiling {
+    readonly basechain: bigint;
+    readonly masterchain: bigint;
+}
+/**
+ * The default economic ceiling on the `network` charge an endpoint's emulation suggests,
+ * which a network replaces with `params.maxNetworkFee`. TON signs no fee: the chain
+ * charges gas and forward fees by its config, so an inflated estimate cannot make a
+ * transfer pay more, but it would fail the funds check for good (`INSUFFICIENT_FUNDS`) or
+ * mislead whoever approves the fee. A basechain wallet's transfer costs about 0.001-0.01
+ * TON, and a whole gas limit (1M gas at 400 nanograms) 0.4 TON; a masterchain wallet pays
+ * about 25 times the gas and far more storage (about 6 TON a year for a v4r2 wallet at
+ * mainnet's config param 18), so 100 TON refuses only a wallet idle for more than about
+ * 13 years. Above the ceiling an estimate is a retryable `PROVIDER_INCONSISTENT`.
+ */
+export declare const DEFAULT_MAX_NETWORK_FEE: TonFeeCeiling;
+export interface TonNetworkConfig {
+    /** Config param 19; the network identity. */
+    readonly globalId: number;
+    readonly testnet: boolean;
+    /** A message's lifetime past chain time, in seconds. */
+    readonly validForSeconds: number;
+    /** Nanograms attached to each jetton wallet message; the unspent part is refunded. */
+    readonly jettonAttached: bigint;
+    /** Nanograms forwarded with each jetton notification. */
+    readonly jettonForwardAmount: bigint;
+    /** Masterchain blocks the attested head first trails the freshest endpoint by. */
+    readonly finalitySkewBlocks: number;
+    /** The most an estimate's `network` charge may be, per workchain of the sender. */
+    readonly maxNetworkFee: TonFeeCeiling;
+    readonly capabilities: ReadonlySet<Capability>;
+}
+/** The lifetimes a network may configure (`params.validForSeconds`), in seconds. */
+export declare const MIN_VALID_FOR_SECONDS = 10;
+export declare const MAX_VALID_FOR_SECONDS = 86400;
+/** How far an endpoint's `sync_utime` may be from the local clock, in seconds. */
+export declare const CHAIN_TIME_TOLERANCE = 300;
+/**
+ * A build's recorded chain time (`TonSeqnoOrdering.validFrom`) when the ordering holds
+ * a well-formed one for its lifetime: a safe integer at least the shortest lifetime before
+ * `validUntil`, and at most the longest (plus the chain-time tolerance) before it. Undefined
+ * otherwise (an attempt built before the field existed, or a damaged record).
+ */
+export declare function recordedValidFrom(slot: {
+    readonly validUntil: number;
+}): number | undefined;
+export declare function tonNetworkConfig(chain: ChainInfo, network: NetworkInfo, options?: Readonly<Record<string, unknown>>): TonNetworkConfig;