@t402/ton 2.0.0 → 2.3.0
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/cjs/exact/client/index.d.ts +63 -4
- package/dist/cjs/exact/client/index.js +29 -3
- package/dist/cjs/exact/client/index.js.map +1 -1
- package/dist/cjs/exact/facilitator/index.d.ts +63 -3
- package/dist/cjs/exact/facilitator/index.js +31 -4
- package/dist/cjs/exact/facilitator/index.js.map +1 -1
- package/dist/cjs/exact/server/index.d.ts +42 -17
- package/dist/cjs/exact/server/index.js +22 -40
- package/dist/cjs/exact/server/index.js.map +1 -1
- package/dist/cjs/index.d.ts +7 -2
- package/dist/cjs/index.js +496 -13
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/{signer-CFiw2DST.d.ts → signer-Bqn2K0b4.d.ts} +1 -1
- package/dist/esm/{chunk-6LOUEHJT.mjs → chunk-3BN2G4M7.mjs} +6 -1
- package/dist/esm/chunk-3BN2G4M7.mjs.map +1 -0
- package/dist/esm/{chunk-ZCMWKFVA.mjs → chunk-7OE2PWYP.mjs} +28 -4
- package/dist/esm/chunk-7OE2PWYP.mjs.map +1 -0
- package/dist/esm/chunk-NGYEU24R.mjs +271 -0
- package/dist/esm/chunk-NGYEU24R.mjs.map +1 -0
- package/dist/esm/chunk-ZJA7AWWH.mjs +284 -0
- package/dist/esm/chunk-ZJA7AWWH.mjs.map +1 -0
- package/dist/esm/exact/client/index.d.mts +63 -4
- package/dist/esm/exact/client/index.mjs +6 -4
- package/dist/esm/exact/facilitator/index.d.mts +63 -3
- package/dist/esm/exact/facilitator/index.mjs +6 -254
- package/dist/esm/exact/facilitator/index.mjs.map +1 -1
- package/dist/esm/exact/server/index.d.mts +42 -17
- package/dist/esm/exact/server/index.mjs +6 -208
- package/dist/esm/exact/server/index.mjs.map +1 -1
- package/dist/esm/index.d.mts +7 -2
- package/dist/esm/index.mjs +13 -5
- package/dist/esm/index.mjs.map +1 -1
- package/dist/esm/{signer-CFiw2DST.d.mts → signer-Bqn2K0b4.d.mts} +1 -1
- package/package.json +8 -7
- package/dist/esm/chunk-6LOUEHJT.mjs.map +0 -1
- package/dist/esm/chunk-RST5PY7E.mjs +0 -85
- package/dist/esm/chunk-RST5PY7E.mjs.map +0 -1
- package/dist/esm/chunk-ZCMWKFVA.mjs.map +0 -1
|
@@ -1,212 +1,10 @@
|
|
|
1
1
|
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
} from "../../chunk-RST5PY7E.mjs";
|
|
7
|
-
import {
|
|
8
|
-
SCHEME_EXACT,
|
|
9
|
-
normalizeNetwork
|
|
10
|
-
} from "../../chunk-6LOUEHJT.mjs";
|
|
11
|
-
|
|
12
|
-
// src/exact/server/scheme.ts
|
|
13
|
-
var ExactTonScheme = class {
|
|
14
|
-
constructor(config = {}) {
|
|
15
|
-
this.scheme = SCHEME_EXACT;
|
|
16
|
-
this.moneyParsers = [];
|
|
17
|
-
this.config = config;
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Register a custom money parser in the parser chain.
|
|
21
|
-
* Multiple parsers can be registered - they will be tried in registration order.
|
|
22
|
-
* Each parser receives a decimal amount (e.g., 1.50 for $1.50).
|
|
23
|
-
* If a parser returns null, the next parser in the chain will be tried.
|
|
24
|
-
* The default parser is always the final fallback.
|
|
25
|
-
*
|
|
26
|
-
* @param parser - Custom function to convert amount to AssetAmount (or null to skip)
|
|
27
|
-
* @returns The server instance for chaining
|
|
28
|
-
*
|
|
29
|
-
* @example
|
|
30
|
-
* tonServer.registerMoneyParser(async (amount, network) => {
|
|
31
|
-
* // Use custom Jetton for large amounts
|
|
32
|
-
* if (amount > 1000) {
|
|
33
|
-
* return {
|
|
34
|
-
* amount: (amount * 1e9).toString(),
|
|
35
|
-
* asset: "EQCustomJettonAddress...",
|
|
36
|
-
* extra: { tier: "premium" }
|
|
37
|
-
* };
|
|
38
|
-
* }
|
|
39
|
-
* return null; // Use next parser
|
|
40
|
-
* });
|
|
41
|
-
*/
|
|
42
|
-
registerMoneyParser(parser) {
|
|
43
|
-
this.moneyParsers.push(parser);
|
|
44
|
-
return this;
|
|
45
|
-
}
|
|
46
|
-
/**
|
|
47
|
-
* Parses a price into an asset amount.
|
|
48
|
-
* If price is already an AssetAmount, returns it directly.
|
|
49
|
-
* If price is Money (string | number), parses to decimal and tries custom parsers.
|
|
50
|
-
* Falls back to default conversion if all custom parsers return null.
|
|
51
|
-
*
|
|
52
|
-
* @param price - The price to parse
|
|
53
|
-
* @param network - The network to use
|
|
54
|
-
* @returns Promise that resolves to the parsed asset amount
|
|
55
|
-
*/
|
|
56
|
-
async parsePrice(price, network) {
|
|
57
|
-
const normalizedNetwork = normalizeNetwork(network);
|
|
58
|
-
if (typeof price === "object" && price !== null && "amount" in price) {
|
|
59
|
-
if (!price.asset) {
|
|
60
|
-
throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
|
|
61
|
-
}
|
|
62
|
-
return {
|
|
63
|
-
amount: price.amount,
|
|
64
|
-
asset: price.asset,
|
|
65
|
-
extra: price.extra || {}
|
|
66
|
-
};
|
|
67
|
-
}
|
|
68
|
-
const amount = this.parseMoneyToDecimal(price);
|
|
69
|
-
for (const parser of this.moneyParsers) {
|
|
70
|
-
const result = await parser(amount, normalizedNetwork);
|
|
71
|
-
if (result !== null) {
|
|
72
|
-
return result;
|
|
73
|
-
}
|
|
74
|
-
}
|
|
75
|
-
return this.defaultMoneyConversion(amount, normalizedNetwork);
|
|
76
|
-
}
|
|
77
|
-
/**
|
|
78
|
-
* Build payment requirements for this scheme/network combination.
|
|
79
|
-
* Adds TON-specific fields like gas sponsor if provided by facilitator.
|
|
80
|
-
*
|
|
81
|
-
* @param paymentRequirements - Base payment requirements with amount/asset already set
|
|
82
|
-
* @param supportedKind - The supported kind from facilitator's /supported endpoint
|
|
83
|
-
* @param extensionKeys - Extensions supported by the facilitator (unused)
|
|
84
|
-
* @returns Enhanced payment requirements ready to be sent to clients
|
|
85
|
-
*/
|
|
86
|
-
async enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
|
|
87
|
-
void extensionKeys;
|
|
88
|
-
const extra = { ...paymentRequirements.extra };
|
|
89
|
-
if (supportedKind.extra?.gasSponsor) {
|
|
90
|
-
extra.gasSponsor = supportedKind.extra.gasSponsor;
|
|
91
|
-
}
|
|
92
|
-
return {
|
|
93
|
-
...paymentRequirements,
|
|
94
|
-
extra
|
|
95
|
-
};
|
|
96
|
-
}
|
|
97
|
-
/**
|
|
98
|
-
* Parse Money (string | number) to a decimal number.
|
|
99
|
-
* Handles formats like "$1.50", "1.50", 1.50, etc.
|
|
100
|
-
*
|
|
101
|
-
* @param money - The money value to parse
|
|
102
|
-
* @returns Decimal number
|
|
103
|
-
*/
|
|
104
|
-
parseMoneyToDecimal(money) {
|
|
105
|
-
if (typeof money === "number") {
|
|
106
|
-
return money;
|
|
107
|
-
}
|
|
108
|
-
const cleanMoney = money.replace(/^\$/, "").trim();
|
|
109
|
-
const amount = parseFloat(cleanMoney);
|
|
110
|
-
if (isNaN(amount)) {
|
|
111
|
-
throw new Error(`Invalid money format: ${money}`);
|
|
112
|
-
}
|
|
113
|
-
return amount;
|
|
114
|
-
}
|
|
115
|
-
/**
|
|
116
|
-
* Default money conversion implementation.
|
|
117
|
-
* Converts decimal amount to the preferred Jetton on the specified network.
|
|
118
|
-
*
|
|
119
|
-
* @param amount - The decimal amount (e.g., 1.50)
|
|
120
|
-
* @param network - The network to use
|
|
121
|
-
* @returns The parsed asset amount
|
|
122
|
-
*/
|
|
123
|
-
defaultMoneyConversion(amount, network) {
|
|
124
|
-
const jetton = this.getDefaultAsset(network);
|
|
125
|
-
const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals);
|
|
126
|
-
return {
|
|
127
|
-
amount: tokenAmount,
|
|
128
|
-
asset: jetton.masterAddress,
|
|
129
|
-
extra: {
|
|
130
|
-
symbol: jetton.symbol,
|
|
131
|
-
name: jetton.name,
|
|
132
|
-
decimals: jetton.decimals
|
|
133
|
-
}
|
|
134
|
-
};
|
|
135
|
-
}
|
|
136
|
-
/**
|
|
137
|
-
* Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)
|
|
138
|
-
*
|
|
139
|
-
* @param decimalAmount - The decimal amount to convert
|
|
140
|
-
* @param decimals - Number of decimals for the token
|
|
141
|
-
* @returns The token amount as a string
|
|
142
|
-
*/
|
|
143
|
-
convertToTokenAmount(decimalAmount, decimals) {
|
|
144
|
-
const amount = parseFloat(decimalAmount);
|
|
145
|
-
if (isNaN(amount)) {
|
|
146
|
-
throw new Error(`Invalid amount: ${decimalAmount}`);
|
|
147
|
-
}
|
|
148
|
-
const tokenAmount = Math.floor(amount * Math.pow(10, decimals));
|
|
149
|
-
return tokenAmount.toString();
|
|
150
|
-
}
|
|
151
|
-
/**
|
|
152
|
-
* Get the default asset info for a network.
|
|
153
|
-
* Priority: configured preferredJetton > USDT > first available
|
|
154
|
-
*
|
|
155
|
-
* @param network - The network to get asset info for
|
|
156
|
-
* @returns The Jetton configuration
|
|
157
|
-
*/
|
|
158
|
-
getDefaultAsset(network) {
|
|
159
|
-
if (this.config.preferredJetton) {
|
|
160
|
-
const preferred = getJettonConfig(network, this.config.preferredJetton);
|
|
161
|
-
if (preferred) return preferred;
|
|
162
|
-
}
|
|
163
|
-
const defaultJetton = getDefaultJetton(network);
|
|
164
|
-
if (defaultJetton) return defaultJetton;
|
|
165
|
-
throw new Error(`No Jettons configured for network ${network}`);
|
|
166
|
-
}
|
|
167
|
-
/**
|
|
168
|
-
* Get Jetton info for a given symbol on a network
|
|
169
|
-
*
|
|
170
|
-
* @param symbol - The Jetton symbol (e.g., "USDT")
|
|
171
|
-
* @param network - The network to use
|
|
172
|
-
* @returns The Jetton configuration
|
|
173
|
-
*/
|
|
174
|
-
getAssetInfo(symbol, network) {
|
|
175
|
-
const jetton = getJettonConfig(network, symbol);
|
|
176
|
-
if (jetton) return jetton;
|
|
177
|
-
if (symbol.toUpperCase() === "USD") {
|
|
178
|
-
return this.getDefaultAsset(network);
|
|
179
|
-
}
|
|
180
|
-
throw new Error(`Unsupported Jetton: ${symbol} on network ${network}`);
|
|
181
|
-
}
|
|
182
|
-
/**
|
|
183
|
-
* Get the number of decimals for a Jetton on a network
|
|
184
|
-
*
|
|
185
|
-
* @param network - The network to use
|
|
186
|
-
* @param jettonAddress - Optional Jetton address to look up
|
|
187
|
-
* @returns The number of decimals for the Jetton
|
|
188
|
-
*/
|
|
189
|
-
getAssetDecimals(network, jettonAddress) {
|
|
190
|
-
if (jettonAddress) {
|
|
191
|
-
const jetton = getJettonByAddress(network, jettonAddress);
|
|
192
|
-
if (jetton) return jetton.decimals;
|
|
193
|
-
}
|
|
194
|
-
return 6;
|
|
195
|
-
}
|
|
196
|
-
/**
|
|
197
|
-
* Get all supported networks
|
|
198
|
-
*/
|
|
199
|
-
static getSupportedNetworks() {
|
|
200
|
-
return Object.keys(JETTON_REGISTRY);
|
|
201
|
-
}
|
|
202
|
-
/**
|
|
203
|
-
* Check if a network is supported
|
|
204
|
-
*/
|
|
205
|
-
static isNetworkSupported(network) {
|
|
206
|
-
return network in JETTON_REGISTRY;
|
|
207
|
-
}
|
|
208
|
-
};
|
|
2
|
+
ExactTonScheme,
|
|
3
|
+
registerExactTonScheme
|
|
4
|
+
} from "../../chunk-NGYEU24R.mjs";
|
|
5
|
+
import "../../chunk-3BN2G4M7.mjs";
|
|
209
6
|
export {
|
|
210
|
-
ExactTonScheme
|
|
7
|
+
ExactTonScheme,
|
|
8
|
+
registerExactTonScheme
|
|
211
9
|
};
|
|
212
10
|
//# sourceMappingURL=index.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../../src/exact/server/scheme.ts"],"sourcesContent":["/**\n * TON Server Scheme Implementation\n *\n * Handles price parsing and payment requirement enhancement for\n * TON Jetton payments using the exact scheme.\n */\n\nimport type {\n AssetAmount,\n Network,\n PaymentRequirements,\n Price,\n SchemeNetworkServer,\n MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT } from \"../../constants.js\";\nimport {\n getDefaultJetton,\n getJettonConfig,\n getJettonByAddress,\n JETTON_REGISTRY,\n} from \"../../tokens.js\";\nimport { normalizeNetwork } from \"../../utils.js\";\n\n/**\n * Configuration options for ExactTonScheme server\n */\nexport interface ExactTonSchemeConfig {\n /** Preferred Jetton symbol (e.g., \"USDT\"). Defaults to network's highest priority token. */\n preferredJetton?: string;\n}\n\n/**\n * TON server implementation for the Exact payment scheme.\n * Handles price parsing and converts user-friendly amounts to Jetton amounts.\n */\nexport class ExactTonScheme implements SchemeNetworkServer {\n readonly scheme = SCHEME_EXACT;\n private moneyParsers: MoneyParser[] = [];\n private config: ExactTonSchemeConfig;\n\n constructor(config: ExactTonSchemeConfig = {}) {\n this.config = config;\n }\n\n /**\n * Register a custom money parser in the parser chain.\n * Multiple parsers can be registered - they will be tried in registration order.\n * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n * If a parser returns null, the next parser in the chain will be tried.\n * The default parser is always the final fallback.\n *\n * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n * @returns The server instance for chaining\n *\n * @example\n * tonServer.registerMoneyParser(async (amount, network) => {\n * // Use custom Jetton for large amounts\n * if (amount > 1000) {\n * return {\n * amount: (amount * 1e9).toString(),\n * asset: \"EQCustomJettonAddress...\",\n * extra: { tier: \"premium\" }\n * };\n * }\n * return null; // Use next parser\n * });\n */\n registerMoneyParser(parser: MoneyParser): ExactTonScheme {\n this.moneyParsers.push(parser);\n return this;\n }\n\n /**\n * Parses a price into an asset amount.\n * If price is already an AssetAmount, returns it directly.\n * If price is Money (string | number), parses to decimal and tries custom parsers.\n * Falls back to default conversion if all custom parsers return null.\n *\n * @param price - The price to parse\n * @param network - The network to use\n * @returns Promise that resolves to the parsed asset amount\n */\n async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n // Normalize network to CAIP-2 format\n const normalizedNetwork = normalizeNetwork(network);\n\n // If already an AssetAmount, return it directly\n if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n if (!price.asset) {\n throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n }\n return {\n amount: price.amount,\n asset: price.asset,\n extra: price.extra || {},\n };\n }\n\n // Parse Money to decimal number\n const amount = this.parseMoneyToDecimal(price);\n\n // Try each custom money parser in order\n for (const parser of this.moneyParsers) {\n const result = await parser(amount, normalizedNetwork);\n if (result !== null) {\n return result;\n }\n }\n\n // All custom parsers returned null, use default conversion\n return this.defaultMoneyConversion(amount, normalizedNetwork);\n }\n\n /**\n * Build payment requirements for this scheme/network combination.\n * Adds TON-specific fields like gas sponsor if provided by facilitator.\n *\n * @param paymentRequirements - Base payment requirements with amount/asset already set\n * @param supportedKind - The supported kind from facilitator's /supported endpoint\n * @param extensionKeys - Extensions supported by the facilitator (unused)\n * @returns Enhanced payment requirements ready to be sent to clients\n */\n async enhancePaymentRequirements(\n paymentRequirements: PaymentRequirements,\n supportedKind: {\n t402Version: number;\n scheme: string;\n network: Network;\n extra?: Record<string, unknown>;\n },\n extensionKeys: string[],\n ): Promise<PaymentRequirements> {\n // Mark unused parameters to satisfy linter\n void extensionKeys;\n\n // Start with existing extra fields\n const extra = { ...paymentRequirements.extra };\n\n // Add gas sponsor from facilitator if provided\n if (supportedKind.extra?.gasSponsor) {\n extra.gasSponsor = supportedKind.extra.gasSponsor;\n }\n\n return {\n ...paymentRequirements,\n extra,\n };\n }\n\n /**\n * Parse Money (string | number) to a decimal number.\n * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n *\n * @param money - The money value to parse\n * @returns Decimal number\n */\n private parseMoneyToDecimal(money: string | number): number {\n if (typeof money === \"number\") {\n return money;\n }\n\n // Remove $ sign and whitespace, then parse\n const cleanMoney = money.replace(/^\\$/, \"\").trim();\n const amount = parseFloat(cleanMoney);\n\n if (isNaN(amount)) {\n throw new Error(`Invalid money format: ${money}`);\n }\n\n return amount;\n }\n\n /**\n * Default money conversion implementation.\n * Converts decimal amount to the preferred Jetton on the specified network.\n *\n * @param amount - The decimal amount (e.g., 1.50)\n * @param network - The network to use\n * @returns The parsed asset amount\n */\n private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n const jetton = this.getDefaultAsset(network);\n\n // Convert decimal amount to token amount\n const tokenAmount = this.convertToTokenAmount(amount.toString(), jetton.decimals);\n\n return {\n amount: tokenAmount,\n asset: jetton.masterAddress,\n extra: {\n symbol: jetton.symbol,\n name: jetton.name,\n decimals: jetton.decimals,\n },\n };\n }\n\n /**\n * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)\n *\n * @param decimalAmount - The decimal amount to convert\n * @param decimals - Number of decimals for the token\n * @returns The token amount as a string\n */\n private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n const amount = parseFloat(decimalAmount);\n if (isNaN(amount)) {\n throw new Error(`Invalid amount: ${decimalAmount}`);\n }\n // Convert to smallest unit (e.g., for USDT with 6 decimals: 0.10 * 10^6 = 100000)\n const tokenAmount = Math.floor(amount * Math.pow(10, decimals));\n return tokenAmount.toString();\n }\n\n /**\n * Get the default asset info for a network.\n * Priority: configured preferredJetton > USDT > first available\n *\n * @param network - The network to get asset info for\n * @returns The Jetton configuration\n */\n private getDefaultAsset(\n network: Network,\n ): { masterAddress: string; symbol: string; name: string; decimals: number } {\n // If a preferred Jetton is configured, try to use it\n if (this.config.preferredJetton) {\n const preferred = getJettonConfig(network, this.config.preferredJetton);\n if (preferred) return preferred;\n }\n\n // Use the network's default token (sorted by priority)\n const defaultJetton = getDefaultJetton(network);\n if (defaultJetton) return defaultJetton;\n\n throw new Error(`No Jettons configured for network ${network}`);\n }\n\n /**\n * Get Jetton info for a given symbol on a network\n *\n * @param symbol - The Jetton symbol (e.g., \"USDT\")\n * @param network - The network to use\n * @returns The Jetton configuration\n */\n private getAssetInfo(\n symbol: string,\n network: Network,\n ): { masterAddress: string; symbol: string; name: string; decimals: number } {\n const jetton = getJettonConfig(network, symbol);\n if (jetton) return jetton;\n\n // Fallback: treat \"USD\" as request for default stablecoin\n if (symbol.toUpperCase() === \"USD\") {\n return this.getDefaultAsset(network);\n }\n\n throw new Error(`Unsupported Jetton: ${symbol} on network ${network}`);\n }\n\n /**\n * Get the number of decimals for a Jetton on a network\n *\n * @param network - The network to use\n * @param jettonAddress - Optional Jetton address to look up\n * @returns The number of decimals for the Jetton\n */\n private getAssetDecimals(network: Network, jettonAddress?: string): number {\n if (jettonAddress) {\n const jetton = getJettonByAddress(network, jettonAddress);\n if (jetton) return jetton.decimals;\n }\n // Default to 6 decimals (USDT standard)\n return 6;\n }\n\n /**\n * Get all supported networks\n */\n static getSupportedNetworks(): string[] {\n return Object.keys(JETTON_REGISTRY);\n }\n\n /**\n * Check if a network is supported\n */\n static isNetworkSupported(network: string): boolean {\n return network in JETTON_REGISTRY;\n }\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
|
package/dist/esm/index.d.mts
CHANGED
|
@@ -1,7 +1,12 @@
|
|
|
1
|
-
export { ExactTonScheme } from './exact/client/index.mjs';
|
|
2
|
-
export {
|
|
1
|
+
export { ExactTonScheme, TonClientConfig, registerExactTonScheme as registerExactTonClientScheme } from './exact/client/index.mjs';
|
|
2
|
+
export { TonResourceServerConfig, registerExactTonScheme as registerExactTonServerScheme } from './exact/server/index.mjs';
|
|
3
|
+
export { C as ClientTonSigner, b as ExactTonPayload, E as ExactTonPayloadV2, F as FacilitatorTonSigner, S as SignMessageParams, T as TransactionConfirmation, V as VerifyMessageParams, c as VerifyMessageResult, W as WaitForTransactionParams, t as toClientTonSigner, a as toFacilitatorTonSigner } from './signer-Bqn2K0b4.mjs';
|
|
4
|
+
export { TonFacilitatorConfig, registerExactTonScheme as registerExactTonFacilitatorScheme } from './exact/facilitator/index.mjs';
|
|
3
5
|
import { Address, Cell } from '@ton/core';
|
|
4
6
|
import { Network } from '@t402/core/types';
|
|
7
|
+
import '@t402/core/client';
|
|
8
|
+
import '@t402/core/server';
|
|
9
|
+
import '@t402/core/facilitator';
|
|
5
10
|
|
|
6
11
|
/**
|
|
7
12
|
* TON Jetton Token Configuration
|
package/dist/esm/index.mjs
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import {
|
|
2
|
-
ExactTonScheme
|
|
3
|
-
|
|
2
|
+
ExactTonScheme,
|
|
3
|
+
registerExactTonScheme
|
|
4
|
+
} from "./chunk-7OE2PWYP.mjs";
|
|
4
5
|
import {
|
|
5
6
|
JETTON_REGISTRY,
|
|
6
7
|
USDT_ADDRESSES,
|
|
@@ -11,8 +12,12 @@ import {
|
|
|
11
12
|
getNetworksForJetton,
|
|
12
13
|
getSupportedNetworks,
|
|
13
14
|
getUsdtNetworks,
|
|
14
|
-
isNetworkSupported
|
|
15
|
-
|
|
15
|
+
isNetworkSupported,
|
|
16
|
+
registerExactTonScheme as registerExactTonScheme2
|
|
17
|
+
} from "./chunk-NGYEU24R.mjs";
|
|
18
|
+
import {
|
|
19
|
+
registerExactTonScheme as registerExactTonScheme3
|
|
20
|
+
} from "./chunk-ZJA7AWWH.mjs";
|
|
16
21
|
import {
|
|
17
22
|
DEFAULT_FORWARD_TON,
|
|
18
23
|
DEFAULT_JETTON_TRANSFER_TON,
|
|
@@ -46,7 +51,7 @@ import {
|
|
|
46
51
|
parseJettonTransferBody,
|
|
47
52
|
parseTonAddress,
|
|
48
53
|
validateTonAddress
|
|
49
|
-
} from "./chunk-
|
|
54
|
+
} from "./chunk-3BN2G4M7.mjs";
|
|
50
55
|
|
|
51
56
|
// src/signer.ts
|
|
52
57
|
function toClientTonSigner(signer) {
|
|
@@ -101,6 +106,9 @@ export {
|
|
|
101
106
|
normalizeNetwork,
|
|
102
107
|
parseJettonTransferBody,
|
|
103
108
|
parseTonAddress,
|
|
109
|
+
registerExactTonScheme as registerExactTonClientScheme,
|
|
110
|
+
registerExactTonScheme3 as registerExactTonFacilitatorScheme,
|
|
111
|
+
registerExactTonScheme2 as registerExactTonServerScheme,
|
|
104
112
|
toClientTonSigner,
|
|
105
113
|
toFacilitatorTonSigner,
|
|
106
114
|
validateTonAddress
|
package/dist/esm/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["/**\n * TON Signer Interfaces\n *\n * Defines the signer interfaces for t402 client and facilitator operations.\n * These interfaces abstract away the specific wallet implementation,\n * allowing integration with various TON wallets and signing mechanisms.\n */\n\nimport type { Address, Cell, SendMode } from
|
|
1
|
+
{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["/**\n * TON Signer Interfaces\n *\n * Defines the signer interfaces for t402 client and facilitator operations.\n * These interfaces abstract away the specific wallet implementation,\n * allowing integration with various TON wallets and signing mechanisms.\n */\n\nimport type { Address, Cell, SendMode } from '@ton/core'\nimport type { VerifyMessageResult, TransactionConfirmation } from './types.js'\n\n/**\n * Parameters for signing a TON internal message\n */\nexport type SignMessageParams = {\n /** Destination address (typically Jetton wallet contract) */\n to: Address\n /** Amount of TON to attach (for gas) in nanoTON */\n value: bigint\n /** Message body (Jetton transfer cell) */\n body: Cell\n /** Send mode flags (optional, defaults to PAY_GAS_SEPARATELY) */\n sendMode?: SendMode\n /** Bounce flag (optional, defaults to true) */\n bounce?: boolean\n /** Message validity timeout in seconds (optional) */\n timeout?: number\n}\n\n/**\n * ClientTonSigner - Used by t402 clients to sign Jetton transfer messages\n *\n * This interface represents a TON wallet that can:\n * - Sign internal messages for Jetton transfers\n * - Query its own seqno (sequence number)\n *\n * Implementations may include:\n * - WalletContractV4 with private key\n * - TonConnect wallet adapter\n * - Hardware wallet integration\n */\nexport type ClientTonSigner = {\n /** The wallet address */\n readonly address: Address\n\n /**\n * Sign an internal message for Jetton transfer\n * Returns the complete signed external message ready for broadcast\n *\n * @param params - Message parameters\n * @returns Signed external message as Cell (BOC)\n */\n signMessage(params: SignMessageParams): Promise<Cell>\n\n /**\n * Get current seqno for the wallet\n * Used for replay protection\n *\n * @returns Current sequence number\n */\n getSeqno(): Promise<number>\n}\n\n/**\n * Parameters for verifying a signed message\n */\nexport type VerifyMessageParams = {\n /** The signed BOC from client (base64) */\n signedBoc: string\n /** Expected sender address */\n expectedFrom: string\n /** Expected Jetton transfer details */\n expectedTransfer: {\n /** Expected Jetton amount */\n jettonAmount: bigint\n /** Expected destination address */\n destination: string\n /** Jetton master address */\n jettonMaster: string\n }\n}\n\n/**\n * Parameters for waiting on transaction confirmation\n */\nexport type WaitForTransactionParams = {\n /** Address to monitor */\n address: string\n /** Expected seqno after transaction */\n seqno: number\n /** Timeout in milliseconds (optional) */\n timeout?: number\n}\n\n/**\n * FacilitatorTonSigner - Used by t402 facilitators to verify and settle payments\n *\n * This interface combines RPC capabilities with signing abilities:\n * - Query Jetton balances and wallet addresses\n * - Verify signed messages\n * - Broadcast transactions\n * - Wait for confirmations\n */\nexport type FacilitatorTonSigner = {\n /**\n * Get all addresses this facilitator can use for signing\n * Enables dynamic address selection for load balancing\n */\n getAddresses(): readonly string[]\n\n /**\n * Query Jetton balance for an owner\n *\n * @param params - Owner and Jetton master addresses\n * @returns Balance in smallest units\n */\n getJettonBalance(params: { ownerAddress: string; jettonMasterAddress: string }): Promise<bigint>\n\n /**\n * Get Jetton wallet address for an owner\n * Derives the associated Jetton wallet contract address\n *\n * @param params - Owner and Jetton master addresses\n * @returns Jetton wallet address\n */\n getJettonWalletAddress(params: {\n ownerAddress: string\n jettonMasterAddress: string\n }): Promise<string>\n\n /**\n * Verify a signed message matches expected parameters\n * Validates the BOC structure and transfer details\n *\n * @param params - Verification parameters\n * @returns Verification result\n */\n verifyMessage(params: VerifyMessageParams): Promise<VerifyMessageResult>\n\n /**\n * Send a pre-signed external message to the network\n *\n * @param signedBoc - Base64 encoded signed BOC\n * @returns Transaction hash or identifier\n */\n sendExternalMessage(signedBoc: string): Promise<string>\n\n /**\n * Wait for transaction confirmation\n *\n * @param params - Transaction monitoring parameters\n * @returns Confirmation result\n */\n waitForTransaction(params: WaitForTransactionParams): Promise<TransactionConfirmation>\n\n /**\n * Get current seqno for an address\n *\n * @param address - Wallet address to query\n * @returns Current seqno\n */\n getSeqno(address: string): Promise<number>\n\n /**\n * Check if a wallet is deployed (active)\n *\n * @param address - Address to check\n * @returns true if deployed\n */\n isDeployed(address: string): Promise<boolean>\n}\n\n/**\n * Converts a TON wallet to a ClientTonSigner\n * Identity function for type compatibility\n *\n * @param signer - The signer to convert\n * @returns The same signer with ClientTonSigner type\n */\nexport function toClientTonSigner(signer: ClientTonSigner): ClientTonSigner {\n return signer\n}\n\n/**\n * Creates a FacilitatorTonSigner from a single-address facilitator\n * Wraps the single address in a getAddresses() function for compatibility\n *\n * @param client - Facilitator client with single address\n * @returns FacilitatorTonSigner with getAddresses() support\n */\nexport function toFacilitatorTonSigner(\n client: Omit<FacilitatorTonSigner, 'getAddresses'> & { address: string },\n): FacilitatorTonSigner {\n return {\n ...client,\n getAddresses: () => [client.address],\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmLO,SAAS,kBAAkB,QAA0C;AAC1E,SAAO;AACT;AASO,SAAS,uBACd,QACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,CAAC,OAAO,OAAO;AAAA,EACrC;AACF;","names":[]}
|
|
@@ -270,7 +270,7 @@ declare function toClientTonSigner(signer: ClientTonSigner): ClientTonSigner;
|
|
|
270
270
|
* @param client - Facilitator client with single address
|
|
271
271
|
* @returns FacilitatorTonSigner with getAddresses() support
|
|
272
272
|
*/
|
|
273
|
-
declare function toFacilitatorTonSigner(client: Omit<FacilitatorTonSigner,
|
|
273
|
+
declare function toFacilitatorTonSigner(client: Omit<FacilitatorTonSigner, 'getAddresses'> & {
|
|
274
274
|
address: string;
|
|
275
275
|
}): FacilitatorTonSigner;
|
|
276
276
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@t402/ton",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.3.0",
|
|
4
4
|
"main": "./dist/cjs/index.js",
|
|
5
5
|
"module": "./dist/esm/index.js",
|
|
6
6
|
"types": "./dist/cjs/index.d.ts",
|
|
@@ -25,19 +25,20 @@
|
|
|
25
25
|
"eslint-plugin-import": "^2.31.0",
|
|
26
26
|
"eslint-plugin-jsdoc": "^50.6.9",
|
|
27
27
|
"eslint-plugin-prettier": "^5.2.6",
|
|
28
|
+
"glob": "^13.0.0",
|
|
28
29
|
"prettier": "3.5.2",
|
|
29
30
|
"tsup": "^8.4.0",
|
|
30
|
-
"tsx": "^4.
|
|
31
|
+
"tsx": "^4.21.0",
|
|
31
32
|
"typescript": "^5.7.3",
|
|
32
|
-
"vite": "^
|
|
33
|
+
"vite": "^7.3.1",
|
|
33
34
|
"vite-tsconfig-paths": "^5.1.4",
|
|
34
|
-
"vitest": "^3.
|
|
35
|
+
"vitest": "^3.2.4"
|
|
35
36
|
},
|
|
36
37
|
"dependencies": {
|
|
37
|
-
"@ton/core": "^0.62.
|
|
38
|
-
"@ton/ton": "^15.0.0",
|
|
38
|
+
"@ton/core": "^0.62.1",
|
|
39
39
|
"@ton/crypto": "^3.2.0",
|
|
40
|
-
"@
|
|
40
|
+
"@ton/ton": "^16.1.0",
|
|
41
|
+
"@t402/core": "2.3.0"
|
|
41
42
|
},
|
|
42
43
|
"exports": {
|
|
43
44
|
".": {
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/constants.ts","../../src/utils.ts"],"sourcesContent":["/**\n * TON Network Constants\n *\n * This module provides constants for TON blockchain integration including:\n * - CAIP-2 network identifiers\n * - RPC endpoints\n * - Jetton transfer operation codes\n * - Default gas amounts\n */\n\n/**\n * CAIP-2 Network Identifiers for TON\n * Using simple identifiers for mainnet/testnet\n */\nexport const TON_MAINNET_CAIP2 = \"ton:mainnet\";\nexport const TON_TESTNET_CAIP2 = \"ton:testnet\";\n\n/**\n * Supported TON networks\n */\nexport const TON_NETWORKS = [TON_MAINNET_CAIP2, TON_TESTNET_CAIP2] as const;\n\nexport type TonNetwork = (typeof TON_NETWORKS)[number];\n\n/**\n * Default RPC endpoints (TonCenter API v2)\n */\nexport const TON_MAINNET_ENDPOINT = \"https://toncenter.com/api/v2/jsonRPC\";\nexport const TON_TESTNET_ENDPOINT = \"https://testnet.toncenter.com/api/v2/jsonRPC\";\n\n/**\n * TON API v4 endpoints (for @ton/ton TonClient4)\n */\nexport const TON_MAINNET_V4_ENDPOINT = \"https://mainnet-v4.tonhubapi.com\";\nexport const TON_TESTNET_V4_ENDPOINT = \"https://testnet-v4.tonhubapi.com\";\n\n/**\n * Network endpoint mapping\n */\nexport const NETWORK_ENDPOINTS: Record<string, string> = {\n [TON_MAINNET_CAIP2]: TON_MAINNET_ENDPOINT,\n [TON_TESTNET_CAIP2]: TON_TESTNET_ENDPOINT,\n};\n\nexport const NETWORK_V4_ENDPOINTS: Record<string, string> = {\n [TON_MAINNET_CAIP2]: TON_MAINNET_V4_ENDPOINT,\n [TON_TESTNET_CAIP2]: TON_TESTNET_V4_ENDPOINT,\n};\n\n/**\n * Jetton Transfer Operation Codes (TEP-74)\n * @see https://github.com/ton-blockchain/TEPs/blob/master/text/0074-jettons-standard.md\n */\nexport const JETTON_TRANSFER_OP = 0x0f8a7ea5; // transfer\nexport const JETTON_INTERNAL_TRANSFER_OP = 0x178d4519; // internal_transfer\nexport const JETTON_TRANSFER_NOTIFICATION_OP = 0x7362d09c; // transfer_notification\nexport const JETTON_BURN_OP = 0x595f07bc; // burn\n\n/**\n * Default gas amounts for Jetton transfers\n * TON requires attaching TON for gas to internal messages\n */\nexport const DEFAULT_JETTON_TRANSFER_TON = 100_000_000n; // 0.1 TON for gas\nexport const DEFAULT_FORWARD_TON = 1n; // Minimal forward amount (notification)\nexport const MIN_JETTON_TRANSFER_TON = 50_000_000n; // 0.05 TON minimum\n\n/**\n * Maximum gas amounts to prevent excessive fees\n */\nexport const MAX_JETTON_TRANSFER_TON = 500_000_000n; // 0.5 TON maximum\n\n/**\n * Scheme identifier for exact payments\n */\nexport const SCHEME_EXACT = \"exact\";\n\n/**\n * Default timeout for payment validity (in seconds)\n */\nexport const DEFAULT_VALIDITY_DURATION = 3600; // 1 hour\n\n/**\n * Address format constants\n */\nexport const TON_ADDRESS_LENGTH = 48; // Friendly format length (base64url)\nexport const TON_RAW_ADDRESS_LENGTH = 66; // Raw format: workchain:hash (0:64hex)\n","/**\n * TON Utility Functions\n *\n * Helper functions for TON address handling, message building,\n * and network operations.\n */\n\nimport { Address, beginCell, Cell } from \"@ton/core\";\nimport type { Network } from \"@t402/core/types\";\nimport {\n TON_MAINNET_CAIP2,\n TON_TESTNET_CAIP2,\n TON_NETWORKS,\n NETWORK_ENDPOINTS,\n JETTON_TRANSFER_OP,\n} from \"./constants.js\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n *\n * @param network - Network identifier (may be legacy format)\n * @returns Normalized CAIP-2 network identifier\n * @throws Error if network is not supported\n */\nexport function normalizeNetwork(network: Network): Network {\n // Already in CAIP-2 format\n if (network.startsWith(\"ton:\")) {\n if (!TON_NETWORKS.includes(network as (typeof TON_NETWORKS)[number])) {\n throw new Error(`Unsupported TON network: ${network}`);\n }\n return network as Network;\n }\n\n // Handle legacy format conversions\n const mapping: Record<string, Network> = {\n ton: TON_MAINNET_CAIP2 as Network,\n \"ton-mainnet\": TON_MAINNET_CAIP2 as Network,\n mainnet: TON_MAINNET_CAIP2 as Network,\n \"ton-testnet\": TON_TESTNET_CAIP2 as Network,\n testnet: TON_TESTNET_CAIP2 as Network,\n };\n\n const caip2 = mapping[network.toLowerCase()];\n if (!caip2) {\n throw new Error(`Unsupported TON network: ${network}`);\n }\n return caip2;\n}\n\n/**\n * Get RPC endpoint for a network\n *\n * @param network - Network identifier\n * @returns RPC endpoint URL\n */\nexport function getEndpoint(network: Network): string {\n const caip2 = normalizeNetwork(network);\n const endpoint = NETWORK_ENDPOINTS[caip2];\n if (!endpoint) {\n throw new Error(`No endpoint configured for network: ${network}`);\n }\n return endpoint;\n}\n\n/**\n * Check if a network identifier is a supported TON network\n *\n * @param network - Network identifier to check\n * @returns true if supported\n */\nexport function isTonNetwork(network: string): boolean {\n try {\n normalizeNetwork(network as Network);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * Validate TON address format\n *\n * @param address - Address to validate\n * @returns true if valid TON address\n */\nexport function validateTonAddress(address: string): boolean {\n try {\n Address.parse(address);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * Parse TON address from string\n *\n * @param address - Address string (friendly or raw format)\n * @returns Parsed Address object\n * @throws Error if invalid format\n */\nexport function parseTonAddress(address: string): Address {\n return Address.parse(address);\n}\n\n/**\n * Compare two TON addresses for equality\n * Handles different address formats (friendly, raw, bounceable/non-bounceable)\n *\n * @param addr1 - First address\n * @param addr2 - Second address\n * @returns true if addresses are equal\n */\nexport function addressesEqual(addr1: string, addr2: string): boolean {\n try {\n const a1 = Address.parse(addr1);\n const a2 = Address.parse(addr2);\n return a1.equals(a2);\n } catch {\n return false;\n }\n}\n\n/**\n * Format address to friendly format\n *\n * @param address - Address to format\n * @param options - Formatting options\n * @returns Friendly format address string\n */\nexport function formatAddress(\n address: string | Address,\n options?: { bounceable?: boolean; testOnly?: boolean },\n): string {\n const addr = typeof address === \"string\" ? Address.parse(address) : address;\n return addr.toString({\n bounceable: options?.bounceable ?? true,\n testOnly: options?.testOnly ?? false,\n });\n}\n\n/**\n * Convert decimal amount to smallest units (e.g., nano-Jettons)\n *\n * @param decimalAmount - Amount in decimal format (e.g., \"1.50\")\n * @param decimals - Number of decimal places\n * @returns Amount in smallest units as string\n */\nexport function convertToJettonAmount(decimalAmount: string, decimals: number): string {\n const amount = parseFloat(decimalAmount);\n if (isNaN(amount)) {\n throw new Error(`Invalid amount: ${decimalAmount}`);\n }\n const jettonAmount = Math.floor(amount * Math.pow(10, decimals));\n return jettonAmount.toString();\n}\n\n/**\n * Convert smallest units to decimal amount\n *\n * @param jettonAmount - Amount in smallest units\n * @param decimals - Number of decimal places\n * @returns Amount in decimal format as string\n */\nexport function convertFromJettonAmount(jettonAmount: string | bigint, decimals: number): string {\n const amount = typeof jettonAmount === \"string\" ? BigInt(jettonAmount) : jettonAmount;\n const divisor = BigInt(Math.pow(10, decimals));\n const wholePart = amount / divisor;\n const fractionalPart = amount % divisor;\n\n if (fractionalPart === 0n) {\n return wholePart.toString();\n }\n\n const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n return `${wholePart}.${fractionalStr}`.replace(/\\.?0+$/, \"\");\n}\n\n/**\n * Generate a unique query ID for Jetton transfer\n * Uses timestamp + random component for uniqueness\n *\n * @returns BigInt query ID\n */\nexport function generateQueryId(): bigint {\n const timestamp = BigInt(Date.now());\n const random = BigInt(Math.floor(Math.random() * 1000000));\n return timestamp * 1000000n + random;\n}\n\n/**\n * Build Jetton transfer message body (TEP-74)\n *\n * @param params - Transfer parameters\n * @returns Cell containing the transfer message\n */\nexport function buildJettonTransferBody(params: {\n queryId: bigint;\n amount: bigint;\n destination: Address;\n responseDestination: Address;\n forwardAmount?: bigint;\n forwardPayload?: Cell;\n}): Cell {\n const builder = beginCell()\n .storeUint(JETTON_TRANSFER_OP, 32) // op: transfer\n .storeUint(params.queryId, 64) // query_id\n .storeCoins(params.amount) // amount\n .storeAddress(params.destination) // destination\n .storeAddress(params.responseDestination) // response_destination\n .storeBit(false); // no custom payload\n\n // Forward amount (for notification)\n builder.storeCoins(params.forwardAmount ?? 1n);\n\n // Forward payload (optional)\n if (params.forwardPayload) {\n builder.storeBit(true).storeRef(params.forwardPayload);\n } else {\n builder.storeBit(false);\n }\n\n return builder.endCell();\n}\n\n/**\n * Parse Jetton transfer message from Cell\n *\n * @param body - Cell containing the message\n * @returns Parsed transfer parameters\n * @throws Error if not a valid Jetton transfer message\n */\nexport function parseJettonTransferBody(body: Cell): {\n op: number;\n queryId: bigint;\n amount: bigint;\n destination: Address;\n responseDestination: Address;\n forwardAmount: bigint;\n forwardPayload?: Cell;\n} {\n const slice = body.beginParse();\n\n const op = slice.loadUint(32);\n if (op !== JETTON_TRANSFER_OP) {\n throw new Error(`Not a Jetton transfer message. Expected op ${JETTON_TRANSFER_OP}, got ${op}`);\n }\n\n const queryId = slice.loadUintBig(64);\n const amount = slice.loadCoins();\n const destination = slice.loadAddress();\n const responseDestination = slice.loadAddress();\n\n // Skip custom_payload bit\n const hasCustomPayload = slice.loadBit();\n if (hasCustomPayload) {\n slice.loadRef(); // Skip custom payload\n }\n\n const forwardAmount = slice.loadCoins();\n\n // Forward payload\n const hasForwardPayload = slice.loadBit();\n const forwardPayload = hasForwardPayload ? slice.loadRef() : undefined;\n\n return {\n op,\n queryId,\n amount,\n destination,\n responseDestination,\n forwardAmount,\n forwardPayload,\n };\n}\n\n/**\n * Calculate estimated gas for Jetton transfer\n * Based on typical TON network fees\n *\n * @param params - Optional parameters for estimation\n * @returns Estimated gas in nanoTON\n */\nexport function estimateJettonTransferGas(_params?: {\n hasForwardPayload?: boolean;\n}): bigint {\n // Base cost for Jetton transfer (typical)\n // Includes: external message, wallet internal message, Jetton wallet message\n return 100_000_000n; // 0.1 TON (conservative estimate)\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
TON_MAINNET_CAIP2,
|
|
3
|
-
TON_TESTNET_CAIP2
|
|
4
|
-
} from "./chunk-6LOUEHJT.mjs";
|
|
5
|
-
|
|
6
|
-
// src/tokens.ts
|
|
7
|
-
var USDT_ADDRESSES = {
|
|
8
|
-
// TON Mainnet - Official Tether USDT
|
|
9
|
-
[TON_MAINNET_CAIP2]: "EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs",
|
|
10
|
-
// TON Testnet - Test USDT (may vary)
|
|
11
|
-
[TON_TESTNET_CAIP2]: "kQBqSpvo4S87mX9tTc4FX3Sfqf4uSp3Tx-Fz4RBUfTRWBx"
|
|
12
|
-
};
|
|
13
|
-
var JETTON_REGISTRY = {
|
|
14
|
-
// TON Mainnet
|
|
15
|
-
[TON_MAINNET_CAIP2]: {
|
|
16
|
-
USDT: {
|
|
17
|
-
masterAddress: USDT_ADDRESSES[TON_MAINNET_CAIP2],
|
|
18
|
-
symbol: "USDT",
|
|
19
|
-
name: "Tether USD",
|
|
20
|
-
decimals: 6,
|
|
21
|
-
priority: 1
|
|
22
|
-
}
|
|
23
|
-
},
|
|
24
|
-
// TON Testnet
|
|
25
|
-
[TON_TESTNET_CAIP2]: {
|
|
26
|
-
USDT: {
|
|
27
|
-
masterAddress: USDT_ADDRESSES[TON_TESTNET_CAIP2],
|
|
28
|
-
symbol: "USDT",
|
|
29
|
-
name: "Tether USD (Testnet)",
|
|
30
|
-
decimals: 6,
|
|
31
|
-
priority: 1
|
|
32
|
-
}
|
|
33
|
-
}
|
|
34
|
-
};
|
|
35
|
-
function getJettonConfig(network, symbol) {
|
|
36
|
-
return JETTON_REGISTRY[network]?.[symbol.toUpperCase()];
|
|
37
|
-
}
|
|
38
|
-
function getNetworkJettons(network) {
|
|
39
|
-
const jettons = JETTON_REGISTRY[network];
|
|
40
|
-
if (!jettons) return [];
|
|
41
|
-
return Object.values(jettons).sort((a, b) => a.priority - b.priority);
|
|
42
|
-
}
|
|
43
|
-
function getDefaultJetton(network) {
|
|
44
|
-
const jettons = getNetworkJettons(network);
|
|
45
|
-
return jettons[0];
|
|
46
|
-
}
|
|
47
|
-
function getJettonByAddress(network, address) {
|
|
48
|
-
const jettons = JETTON_REGISTRY[network];
|
|
49
|
-
if (!jettons) return void 0;
|
|
50
|
-
return Object.values(jettons).find(
|
|
51
|
-
(j) => j.masterAddress.toLowerCase() === address.toLowerCase()
|
|
52
|
-
);
|
|
53
|
-
}
|
|
54
|
-
function getNetworksForJetton(symbol) {
|
|
55
|
-
const networks = [];
|
|
56
|
-
for (const [network, jettons] of Object.entries(JETTON_REGISTRY)) {
|
|
57
|
-
if (jettons[symbol.toUpperCase()]) {
|
|
58
|
-
networks.push(network);
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
return networks;
|
|
62
|
-
}
|
|
63
|
-
function getUsdtNetworks() {
|
|
64
|
-
return getNetworksForJetton("USDT");
|
|
65
|
-
}
|
|
66
|
-
function isNetworkSupported(network) {
|
|
67
|
-
return network in JETTON_REGISTRY;
|
|
68
|
-
}
|
|
69
|
-
function getSupportedNetworks() {
|
|
70
|
-
return Object.keys(JETTON_REGISTRY);
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
export {
|
|
74
|
-
USDT_ADDRESSES,
|
|
75
|
-
JETTON_REGISTRY,
|
|
76
|
-
getJettonConfig,
|
|
77
|
-
getNetworkJettons,
|
|
78
|
-
getDefaultJetton,
|
|
79
|
-
getJettonByAddress,
|
|
80
|
-
getNetworksForJetton,
|
|
81
|
-
getUsdtNetworks,
|
|
82
|
-
isNetworkSupported,
|
|
83
|
-
getSupportedNetworks
|
|
84
|
-
};
|
|
85
|
-
//# sourceMappingURL=chunk-RST5PY7E.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/tokens.ts"],"sourcesContent":["/**\n * TON Jetton Token Configuration\n *\n * This module provides comprehensive Jetton token definitions including:\n * - USDT (Tether USD on TON)\n * - Network-specific configurations\n * - Helper functions for token lookups\n */\n\nimport { TON_MAINNET_CAIP2, TON_TESTNET_CAIP2 } from \"./constants.js\";\n\n/**\n * Jetton token configuration\n */\nexport interface JettonConfig {\n /** Jetton master contract address (friendly format) */\n masterAddress: string;\n /** Token symbol */\n symbol: string;\n /** Token name */\n name: string;\n /** Number of decimal places */\n decimals: number;\n /** Payment priority (lower = higher priority) */\n priority: number;\n}\n\n/**\n * Network token registry mapping network -> symbol -> config\n */\nexport type NetworkJettonRegistry = Record<string, Record<string, JettonConfig>>;\n\n/**\n * USDT Jetton Master Contract Addresses by Network\n *\n * USDT on TON follows the TEP-74 Jetton standard.\n * @see https://docs.tether.to/tether-on-ton\n */\nexport const USDT_ADDRESSES: Record<string, string> = {\n // TON Mainnet - Official Tether USDT\n [TON_MAINNET_CAIP2]: \"EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs\",\n // TON Testnet - Test USDT (may vary)\n [TON_TESTNET_CAIP2]: \"kQBqSpvo4S87mX9tTc4FX3Sfqf4uSp3Tx-Fz4RBUfTRWBx\",\n};\n\n/**\n * Complete Jetton registry with all supported tokens per network\n */\nexport const JETTON_REGISTRY: NetworkJettonRegistry = {\n // TON Mainnet\n [TON_MAINNET_CAIP2]: {\n USDT: {\n masterAddress: USDT_ADDRESSES[TON_MAINNET_CAIP2],\n symbol: \"USDT\",\n name: \"Tether USD\",\n decimals: 6,\n priority: 1,\n },\n },\n\n // TON Testnet\n [TON_TESTNET_CAIP2]: {\n USDT: {\n masterAddress: USDT_ADDRESSES[TON_TESTNET_CAIP2],\n symbol: \"USDT\",\n name: \"Tether USD (Testnet)\",\n decimals: 6,\n priority: 1,\n },\n },\n};\n\n/**\n * Get Jetton configuration for a specific token on a network\n *\n * @param network - Network identifier (CAIP-2 format)\n * @param symbol - Token symbol (e.g., \"USDT\")\n * @returns Jetton configuration or undefined\n */\nexport function getJettonConfig(network: string, symbol: string): JettonConfig | undefined {\n return JETTON_REGISTRY[network]?.[symbol.toUpperCase()];\n}\n\n/**\n * Get all Jettons available on a network\n *\n * @param network - Network identifier\n * @returns Array of Jetton configurations sorted by priority\n */\nexport function getNetworkJettons(network: string): JettonConfig[] {\n const jettons = JETTON_REGISTRY[network];\n if (!jettons) return [];\n return Object.values(jettons).sort((a, b) => a.priority - b.priority);\n}\n\n/**\n * Get the default/preferred Jetton for a network\n * Prefers USDT based on priority\n *\n * @param network - Network identifier\n * @returns Default Jetton configuration or undefined\n */\nexport function getDefaultJetton(network: string): JettonConfig | undefined {\n const jettons = getNetworkJettons(network);\n return jettons[0]; // Already sorted by priority\n}\n\n/**\n * Get Jetton by master contract address on a network\n *\n * @param network - Network identifier\n * @param address - Jetton master contract address\n * @returns Jetton configuration or undefined\n */\nexport function getJettonByAddress(network: string, address: string): JettonConfig | undefined {\n const jettons = JETTON_REGISTRY[network];\n if (!jettons) return undefined;\n\n // Normalize address comparison (case-insensitive for base64)\n return Object.values(jettons).find(\n (j) => j.masterAddress.toLowerCase() === address.toLowerCase(),\n );\n}\n\n/**\n * Get all networks that support a specific Jetton\n *\n * @param symbol - Token symbol\n * @returns Array of network identifiers\n */\nexport function getNetworksForJetton(symbol: string): string[] {\n const networks: string[] = [];\n for (const [network, jettons] of Object.entries(JETTON_REGISTRY)) {\n if (jettons[symbol.toUpperCase()]) {\n networks.push(network);\n }\n }\n return networks;\n}\n\n/**\n * Get USDT networks on TON\n *\n * @returns Array of networks supporting USDT\n */\nexport function getUsdtNetworks(): string[] {\n return getNetworksForJetton(\"USDT\");\n}\n\n/**\n * Check if a network is supported\n *\n * @param network - Network identifier to check\n * @returns true if network has configured Jettons\n */\nexport function isNetworkSupported(network: string): boolean {\n return network in JETTON_REGISTRY;\n}\n\n/**\n * Get all supported networks\n *\n * @returns Array of all supported network identifiers\n */\nexport function getSupportedNetworks(): string[] {\n return Object.keys(JETTON_REGISTRY);\n}\n"],"mappings":";;;;;;AAsCO,IAAM,iBAAyC;AAAA;AAAA,EAEpD,CAAC,iBAAiB,GAAG;AAAA;AAAA,EAErB,CAAC,iBAAiB,GAAG;AACvB;AAKO,IAAM,kBAAyC;AAAA;AAAA,EAEpD,CAAC,iBAAiB,GAAG;AAAA,IACnB,MAAM;AAAA,MACJ,eAAe,eAAe,iBAAiB;AAAA,MAC/C,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AAAA;AAAA,EAGA,CAAC,iBAAiB,GAAG;AAAA,IACnB,MAAM;AAAA,MACJ,eAAe,eAAe,iBAAiB;AAAA,MAC/C,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,EACF;AACF;AASO,SAAS,gBAAgB,SAAiB,QAA0C;AACzF,SAAO,gBAAgB,OAAO,IAAI,OAAO,YAAY,CAAC;AACxD;AAQO,SAAS,kBAAkB,SAAiC;AACjE,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,CAAC,QAAS,QAAO,CAAC;AACtB,SAAO,OAAO,OAAO,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACtE;AASO,SAAS,iBAAiB,SAA2C;AAC1E,QAAM,UAAU,kBAAkB,OAAO;AACzC,SAAO,QAAQ,CAAC;AAClB;AASO,SAAS,mBAAmB,SAAiB,SAA2C;AAC7F,QAAM,UAAU,gBAAgB,OAAO;AACvC,MAAI,CAAC,QAAS,QAAO;AAGrB,SAAO,OAAO,OAAO,OAAO,EAAE;AAAA,IAC5B,CAAC,MAAM,EAAE,cAAc,YAAY,MAAM,QAAQ,YAAY;AAAA,EAC/D;AACF;AAQO,SAAS,qBAAqB,QAA0B;AAC7D,QAAM,WAAqB,CAAC;AAC5B,aAAW,CAAC,SAAS,OAAO,KAAK,OAAO,QAAQ,eAAe,GAAG;AAChE,QAAI,QAAQ,OAAO,YAAY,CAAC,GAAG;AACjC,eAAS,KAAK,OAAO;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,kBAA4B;AAC1C,SAAO,qBAAqB,MAAM;AACpC;AAQO,SAAS,mBAAmB,SAA0B;AAC3D,SAAO,WAAW;AACpB;AAOO,SAAS,uBAAiC;AAC/C,SAAO,OAAO,KAAK,eAAe;AACpC;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/exact/client/scheme.ts"],"sourcesContent":["/**\n * TON Client Scheme Implementation\n *\n * Creates payment payloads for TON Jetton transfers using the exact scheme.\n * Builds and signs external messages for Jetton wallet interactions.\n */\n\nimport { Address, SendMode } from \"@ton/core\";\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@t402/core/types\";\nimport type { ClientTonSigner } from \"../../signer.js\";\nimport type { ExactTonPayloadV2 } from \"../../types.js\";\nimport { SCHEME_EXACT, DEFAULT_JETTON_TRANSFER_TON, DEFAULT_FORWARD_TON } from \"../../constants.js\";\nimport {\n generateQueryId,\n buildJettonTransferBody,\n normalizeNetwork,\n parseTonAddress,\n} from \"../../utils.js\";\n\n/**\n * Configuration for ExactTonScheme client\n */\nexport interface ExactTonSchemeConfig {\n /** Override the TON amount attached for gas (in nanoTON) */\n gasAmount?: bigint;\n /** Override the forward TON amount (in nanoTON) */\n forwardAmount?: bigint;\n}\n\n/**\n * TON client implementation for the Exact payment scheme.\n *\n * Creates signed Jetton transfer messages that can be broadcast\n * by a facilitator to complete the payment.\n */\nexport class ExactTonScheme implements SchemeNetworkClient {\n readonly scheme = SCHEME_EXACT;\n\n /**\n * Creates a new ExactTonScheme instance.\n *\n * @param signer - The TON signer for client operations\n * @param getJettonWalletAddress - Function to derive Jetton wallet address\n * @param config - Optional configuration overrides\n */\n constructor(\n private readonly signer: ClientTonSigner,\n private readonly getJettonWalletAddress: (\n ownerAddress: string,\n jettonMasterAddress: string,\n ) => Promise<string>,\n private readonly config: ExactTonSchemeConfig = {},\n ) {}\n\n /**\n * Creates a payment payload for the Exact scheme.\n *\n * The payload contains a pre-signed external message that performs\n * a Jetton transfer from the client to the recipient.\n *\n * @param t402Version - The t402 protocol version\n * @param paymentRequirements - The payment requirements\n * @returns Promise resolving to a payment payload\n */\n async createPaymentPayload(\n t402Version: number,\n paymentRequirements: PaymentRequirements,\n ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n // Normalize and validate network\n const network = normalizeNetwork(paymentRequirements.network);\n\n // Validate required fields\n if (!paymentRequirements.asset) {\n throw new Error(\"Asset (Jetton master address) is required\");\n }\n if (!paymentRequirements.payTo) {\n throw new Error(\"PayTo address is required\");\n }\n if (!paymentRequirements.amount) {\n throw new Error(\"Amount is required\");\n }\n\n // Parse addresses\n const jettonMasterAddress = paymentRequirements.asset;\n const destinationAddress = parseTonAddress(paymentRequirements.payTo);\n\n // Get client's Jetton wallet address\n const senderJettonWalletAddress = await this.getJettonWalletAddress(\n this.signer.address.toString(),\n jettonMasterAddress,\n );\n const senderJettonWallet = Address.parse(senderJettonWalletAddress);\n\n // Get current seqno for replay protection\n const seqno = await this.signer.getSeqno();\n\n // Calculate validity period\n const now = Math.floor(Date.now() / 1000);\n const validUntil = now + paymentRequirements.maxTimeoutSeconds;\n\n // Generate unique query ID\n const queryId = generateQueryId();\n\n // Parse amount\n const jettonAmount = BigInt(paymentRequirements.amount);\n\n // Build Jetton transfer body\n const jettonTransferBody = buildJettonTransferBody({\n queryId,\n amount: jettonAmount,\n destination: destinationAddress,\n responseDestination: this.signer.address,\n forwardAmount: this.config.forwardAmount ?? DEFAULT_FORWARD_TON,\n });\n\n // Gas amount for the transfer\n const tonAmount = this.config.gasAmount ?? DEFAULT_JETTON_TRANSFER_TON;\n\n // Sign the message\n const signedMessage = await this.signer.signMessage({\n to: senderJettonWallet,\n value: tonAmount,\n body: jettonTransferBody,\n sendMode: SendMode.PAY_GAS_SEPARATELY,\n timeout: paymentRequirements.maxTimeoutSeconds,\n });\n\n // Encode to base64\n const signedBoc = signedMessage.toBoc().toString(\"base64\");\n\n // Build authorization metadata\n const authorization: ExactTonPayloadV2[\"authorization\"] = {\n from: this.signer.address.toString({ bounceable: true }),\n to: paymentRequirements.payTo,\n jettonMaster: jettonMasterAddress,\n jettonAmount: jettonAmount.toString(),\n tonAmount: tonAmount.toString(),\n validUntil,\n seqno,\n queryId: queryId.toString(),\n };\n\n // Create payload\n const payload: ExactTonPayloadV2 = {\n signedBoc,\n authorization,\n };\n\n // Mark network as used\n void network;\n\n return {\n t402Version,\n payload,\n };\n }\n}\n"],"mappings":";;;;;;;;;;;AAOA,SAAS,SAAS,gBAAgB;AA4B3B,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUzD,YACmB,QACA,wBAIA,SAA+B,CAAC,GACjD;AANiB;AACA;AAIA;AAfnB,SAAS,SAAS;AAAA,EAgBf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYH,MAAM,qBACJ,aACA,qBAC0D;AAE1D,UAAM,UAAU,iBAAiB,oBAAoB,OAAO;AAG5D,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AACA,QAAI,CAAC,oBAAoB,QAAQ;AAC/B,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AAGA,UAAM,sBAAsB,oBAAoB;AAChD,UAAM,qBAAqB,gBAAgB,oBAAoB,KAAK;AAGpE,UAAM,4BAA4B,MAAM,KAAK;AAAA,MAC3C,KAAK,OAAO,QAAQ,SAAS;AAAA,MAC7B;AAAA,IACF;AACA,UAAM,qBAAqB,QAAQ,MAAM,yBAAyB;AAGlE,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS;AAGzC,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,UAAM,aAAa,MAAM,oBAAoB;AAG7C,UAAM,UAAU,gBAAgB;AAGhC,UAAM,eAAe,OAAO,oBAAoB,MAAM;AAGtD,UAAM,qBAAqB,wBAAwB;AAAA,MACjD;AAAA,MACA,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,qBAAqB,KAAK,OAAO;AAAA,MACjC,eAAe,KAAK,OAAO,iBAAiB;AAAA,IAC9C,CAAC;AAGD,UAAM,YAAY,KAAK,OAAO,aAAa;AAG3C,UAAM,gBAAgB,MAAM,KAAK,OAAO,YAAY;AAAA,MAClD,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU,SAAS;AAAA,MACnB,SAAS,oBAAoB;AAAA,IAC/B,CAAC;AAGD,UAAM,YAAY,cAAc,MAAM,EAAE,SAAS,QAAQ;AAGzD,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO,QAAQ,SAAS,EAAE,YAAY,KAAK,CAAC;AAAA,MACvD,IAAI,oBAAoB;AAAA,MACxB,cAAc;AAAA,MACd,cAAc,aAAa,SAAS;AAAA,MACpC,WAAW,UAAU,SAAS;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,SAAS,QAAQ,SAAS;AAAA,IAC5B;AAGA,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAGA,SAAK;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
|