@pioneer-platform/ton-network 8.11.0

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+
+$ tsc -p .

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export declare const NETWORK_ID = "ton:-239";
+export declare const CHAIN_SYMBOL = "TON";
+export declare const DECIMALS = 9;

package/lib/index.js

@@ -0,0 +1,488 @@
+"use strict";
+/*
+    TON (The Open Network) Network Module
+
+    Provides connectivity to the TON blockchain network.
+
+    Network ID: ton:-239
+    SLIP44: 607
+    Decimals: 9 (nanotons)
+
+    Public API Endpoints:
+    - https://toncenter.com/api/v2 (TonCenter)
+    - https://tonapi.io/v2 (TonAPI)
+
+    TON addresses use two formats:
+    - Raw: workchain:hex_hash (e.g., 0:abc123...)
+    - User-friendly: Base64 encoded with checksum (e.g., EQ...)
+
+    TODO: Implement full network functionality
+    - Transaction building (TL-B cells)
+    - Transaction signing coordination with KeepKey
+    - Balance fetching
+    - Jetton (TRC-20) token queries
+    - NFT support
+*/
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DECIMALS = exports.CHAIN_SYMBOL = exports.NETWORK_ID = void 0;
+var TAG = " | ton-network | ";
+require("dotenv").config({ path: '../../../../.env' });
+var axiosLib = require('axios');
+var Axios = axiosLib.default || axiosLib;
+var https = require('https');
+var log = require('@pioneer-platform/loggerdog')();
+// Default TON mainnet API (TonCenter)
+var DEFAULT_API_URL = "https://toncenter.com/api/v2";
+// Network constants
+exports.NETWORK_ID = 'ton:-239';
+exports.CHAIN_SYMBOL = 'TON';
+exports.DECIMALS = 9;
+// Create axios instance for API calls
+var axios = Axios.create({
+    httpsAgent: new https.Agent({
+        rejectUnauthorized: false
+    }),
+    headers: {
+        'Content-Type': 'application/json'
+    }
+});
+// Module state
+var apiUrl = DEFAULT_API_URL;
+var apiKey = null;
+var isInitialized = false;
+/**********************************
+ // Module Exports
+ //**********************************/
+module.exports = {
+    /**
+     * Initialize the TON network module
+     * @param url - Optional custom API URL
+     * @param settings - Optional settings object (may contain apiKey)
+     */
+    init: function (url, settings) {
+        return __awaiter(this, void 0, void 0, function () {
+            var tag, headers, testResult, e_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        tag = TAG + " | init | ";
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        apiUrl = url || process.env['TON_API_URL'] || DEFAULT_API_URL;
+                        apiKey = (settings === null || settings === void 0 ? void 0 : settings.apiKey) || process.env['TONCENTER_API_KEY'] || null;
+                        log.info(tag, "Initializing TON network...");
+                        log.info(tag, "API Endpoint:", apiUrl);
+                        log.info(tag, "API Key configured:", apiKey ? "Yes" : "No (rate limited)");
+                        headers = { 'Content-Type': 'application/json' };
+                        if (apiKey) {
+                            headers['X-API-Key'] = apiKey;
+                        }
+                        return [4 /*yield*/, axios({
+                                url: "".concat(apiUrl, "/getMasterchainInfo"),
+                                method: 'GET',
+                                headers: headers
+                            })];
+                    case 2:
+                        testResult = _a.sent();
+                        if (testResult.data && testResult.data.ok) {
+                            log.info(tag, "Successfully connected to TON API");
+                            log.info(tag, "Masterchain seqno:", testResult.data.result.last.seqno);
+                            isInitialized = true;
+                            return [2 /*return*/, true];
+                        }
+                        else {
+                            throw new Error("Invalid response from TON API");
+                        }
+                        return [3 /*break*/, 4];
+                    case 3:
+                        e_1 = _a.sent();
+                        log.error(tag, "Failed to initialize:", e_1.message);
+                        throw e_1;
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    },
+    /**
+     * Check if the module is online and initialized
+     */
+    isOnline: function () {
+        return isInitialized;
+    },
+    /**
+     * Get the balance of a TON address
+     * @param address - TON address (user-friendly or raw format)
+     * @returns Balance in TON
+     */
+    getBalance: function (address) {
+        return get_balance(address);
+    },
+    /**
+     * Get address info for a TON address
+     * @param address - TON address
+     */
+    getAddressInfo: function (address) {
+        return get_address_info(address);
+    },
+    /**
+     * Get wallet seqno (sequence number for transactions)
+     * @param address - TON address
+     */
+    getWalletSeqno: function (address) {
+        return get_wallet_seqno(address);
+    },
+    /**
+     * Broadcast a signed transaction (BOC)
+     * @param boc - Base64 encoded BOC (Bag of Cells)
+     */
+    broadcast: function (boc) {
+        return broadcast_transaction(boc);
+    },
+    /**
+     * Get transaction details
+     * @param address - Address involved in transaction
+     * @param lt - Logical time of transaction
+     * @param hash - Transaction hash
+     */
+    getTransaction: function (address, lt, hash) {
+        return get_transaction(address, lt, hash);
+    },
+    /**
+     * Get transactions for an address
+     * @param address - TON address
+     * @param limit - Number of transactions to fetch (default 10)
+     */
+    getTransactions: function (address, limit) {
+        if (limit === void 0) { limit = 10; }
+        return get_transactions(address, limit);
+    },
+    /**
+     * Get masterchain info
+     */
+    getMasterchainInfo: function () {
+        return get_masterchain_info();
+    },
+    // Network constants
+    NETWORK_ID: exports.NETWORK_ID,
+    CHAIN_SYMBOL: exports.CHAIN_SYMBOL,
+    DECIMALS: exports.DECIMALS
+};
+/**********************************
+ // Implementation Functions
+ //**********************************/
+function getHeaders() {
+    var headers = { 'Content-Type': 'application/json' };
+    if (apiKey) {
+        headers['X-API-Key'] = apiKey;
+    }
+    return headers;
+}
+function get_balance(address) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tag, response, balanceInNanotons, balanceInTON, e_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    tag = TAG + " | get_balance | ";
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    log.debug(tag, "Getting balance for:", address);
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/getAddressBalance"),
+                            method: 'GET',
+                            headers: getHeaders(),
+                            params: { address: address }
+                        })];
+                case 2:
+                    response = _a.sent();
+                    if (response.data && response.data.ok) {
+                        balanceInNanotons = BigInt(response.data.result);
+                        balanceInTON = Number(balanceInNanotons) / Math.pow(10, exports.DECIMALS);
+                        log.debug(tag, "Balance retrieved:", balanceInTON, "TON");
+                        return [2 /*return*/, balanceInTON];
+                    }
+                    if (response.data && !response.data.ok) {
+                        log.warn(tag, "API error:", response.data.error);
+                        return [2 /*return*/, 0];
+                    }
+                    return [2 /*return*/, 0];
+                case 3:
+                    e_2 = _a.sent();
+                    log.error(tag, "Error getting balance:", e_2.message);
+                    return [2 /*return*/, 0];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function get_address_info(address) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tag, response, result, e_3;
+        var _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    tag = TAG + " | get_address_info | ";
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 3, , 4]);
+                    log.debug(tag, "Getting address info for:", address);
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/getAddressInformation"),
+                            method: 'GET',
+                            headers: getHeaders(),
+                            params: { address: address }
+                        })];
+                case 2:
+                    response = _c.sent();
+                    if (response.data && response.data.ok) {
+                        result = response.data.result;
+                        return [2 /*return*/, {
+                                balance: Number(BigInt(result.balance)) / Math.pow(10, exports.DECIMALS),
+                                state: result.state,
+                                lastTransactionLt: (_a = result.last_transaction_id) === null || _a === void 0 ? void 0 : _a.lt,
+                                lastTransactionHash: (_b = result.last_transaction_id) === null || _b === void 0 ? void 0 : _b.hash
+                            }];
+                    }
+                    return [2 /*return*/, null];
+                case 3:
+                    e_3 = _c.sent();
+                    log.error(tag, "Error getting address info:", e_3.message);
+                    throw e_3;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function get_wallet_seqno(address) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tag, response, stack, e_4;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    tag = TAG + " | get_wallet_seqno | ";
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    log.debug(tag, "Getting wallet seqno for:", address);
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/runGetMethod"),
+                            method: 'POST',
+                            headers: getHeaders(),
+                            data: {
+                                address: address,
+                                method: "seqno",
+                                stack: []
+                            }
+                        })];
+                case 2:
+                    response = _a.sent();
+                    if (response.data && response.data.ok) {
+                        stack = response.data.result.stack;
+                        if (stack && stack.length > 0) {
+                            // seqno is returned as a number on the stack
+                            return [2 /*return*/, parseInt(stack[0][1], 16)];
+                        }
+                    }
+                    return [2 /*return*/, null];
+                case 3:
+                    e_4 = _a.sent();
+                    // If seqno fails, it might be an uninitialized wallet
+                    log.warn(tag, "Error getting seqno (wallet may be uninitialized):", e_4.message);
+                    return [2 /*return*/, 0];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function broadcast_transaction(boc) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tag, output, response, e_5;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    tag = TAG + " | broadcast_transaction | ";
+                    output = { success: false };
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    log.debug(tag, "Broadcasting transaction...");
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/sendBoc"),
+                            method: 'POST',
+                            headers: getHeaders(),
+                            data: { boc: boc }
+                        })];
+                case 2:
+                    response = _b.sent();
+                    if (response.data) {
+                        if (response.data.ok) {
+                            output.success = true;
+                            output.hash = (_a = response.data.result) === null || _a === void 0 ? void 0 : _a.hash;
+                            log.info(tag, "Transaction broadcast successful");
+                        }
+                        else {
+                            output.success = false;
+                            output.error = response.data.error || 'Unknown error';
+                            log.error(tag, "Broadcast error:", output.error);
+                        }
+                    }
+                    return [2 /*return*/, output];
+                case 3:
+                    e_5 = _b.sent();
+                    log.error(tag, "Broadcast error:", e_5.message);
+                    output.error = e_5.message;
+                    return [2 /*return*/, output];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function get_transaction(address, lt, hash) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tag, response, e_6;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    tag = TAG + " | get_transaction | ";
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    log.debug(tag, "Getting transaction:", { address: address, lt: lt, hash: hash });
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/getTransactions"),
+                            method: 'GET',
+                            headers: getHeaders(),
+                            params: {
+                                address: address,
+                                lt: lt,
+                                hash: hash,
+                                limit: 1
+                            }
+                        })];
+                case 2:
+                    response = _a.sent();
+                    if (response.data && response.data.ok && response.data.result.length > 0) {
+                        return [2 /*return*/, response.data.result[0]];
+                    }
+                    return [2 /*return*/, null];
+                case 3:
+                    e_6 = _a.sent();
+                    log.error(tag, "Error getting transaction:", e_6.message);
+                    throw e_6;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function get_transactions(address_1) {
+    return __awaiter(this, arguments, void 0, function (address, limit) {
+        var tag, response, e_7;
+        if (limit === void 0) { limit = 10; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    tag = TAG + " | get_transactions | ";
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    log.debug(tag, "Getting transactions for:", address);
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/getTransactions"),
+                            method: 'GET',
+                            headers: getHeaders(),
+                            params: {
+                                address: address,
+                                limit: limit
+                            }
+                        })];
+                case 2:
+                    response = _a.sent();
+                    if (response.data && response.data.ok) {
+                        return [2 /*return*/, response.data.result];
+                    }
+                    return [2 /*return*/, []];
+                case 3:
+                    e_7 = _a.sent();
+                    log.error(tag, "Error getting transactions:", e_7.message);
+                    throw e_7;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+function get_masterchain_info() {
+    return __awaiter(this, void 0, void 0, function () {
+        var tag, response, e_8;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    tag = TAG + " | get_masterchain_info | ";
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, axios({
+                            url: "".concat(apiUrl, "/getMasterchainInfo"),
+                            method: 'GET',
+                            headers: getHeaders()
+                        })];
+                case 2:
+                    response = _a.sent();
+                    if (response.data && response.data.ok) {
+                        return [2 /*return*/, {
+                                workchain: response.data.result.last.workchain,
+                                shard: response.data.result.last.shard,
+                                seqno: response.data.result.last.seqno,
+                                rootHash: response.data.result.last.root_hash,
+                                fileHash: response.data.result.last.file_hash
+                            }];
+                    }
+                    return [2 /*return*/, null];
+                case 3:
+                    e_8 = _a.sent();
+                    log.error(tag, "Error getting masterchain info:", e_8.message);
+                    throw e_8;
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@pioneer-platform/ton-network",
+  "version": "8.11.0",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "description": "Pioneer Platform TON Network module",
+  "keywords": [
+    "ton",
+    "toncoin",
+    "blockchain",
+    "pioneer"
+  ],
+  "scripts": {
+    "create": "pnpm run build && pnpm run test",
+    "build": "tsc -p .",
+    "test": "pnpm run build && node __tests__/test-module.js",
+    "prepublish": "rm -R lib && pnpm run build",
+    "refresh": "rm -rf ./node_modules ./package-lock.json && pnpm install"
+  },
+  "dependencies": {
+    "@pioneer-platform/loggerdog": "^8.11.0",
+    "axios": "^1.6.0",
+    "dotenv": "^16.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.16.0",
+    "typescript": "^5.0.4"
+  },
+  "gitHead": "aeae28273014ab69b42f22abec159c6693a56c40"
+}