vanishmax/foton

⚡ Create TON dApps with the speed of a foton

Foton

⚡ Create TON dApps with the speed of a photon

Warning: This project is under active development and is not ready for production use. Each release might and probably will contain breaking changes. If you find bugs when using it, please submit an issue.

Foton is a TypeScript toolkit for interacting with TON wallets and blockchain as a whole. The library wraps existing solutions into one comfortable API. It supports:

• ✅ Wallet connection
• ✅ Sending transactions
• ✅ Querying the blockchain
• ✅ Deploying and interacting with smart contracts
• ✅ Blueprint and TON Connect integration for easy code migrations
• ✅ Type safe interfaces with full auto-completion for contract methods and returns

Not sure where to start?

• Explore Foton documentation
• Try building a simple Counter dApp with React and Foton by following the tutorial.
• Ask for help or share your feedback in the Telegram chat
• Look for a ways to contribute or donate to the project

License

The source code is licensed under the terms of MIT License. 2024, Max Korsunov.

foton's Issues

Found broken `/docs/contract-client/create-contract-client` link. Please fix!

TypeError: (0 , S.default) is not a function

I receive this stack trace when trying to invoke createPublicClient in nodejs environment:

TypeError: (0 , S.default) is not a function
    at G (/Users/petrpotapov/Projects/lottery-smart-func/smart-func/node_modules/@fotonjs/api/dist/index.cjs:1:2864)
    at $ (/Users/petrpotapov/Projects/lottery-smart-func/smart-func/node_modules/@fotonjs/core/dist/index.cjs:1:1207)
    at Object.<anonymous> (/Users/petrpotapov/Projects/lottery-smart-func/smart-func/scripts/getLotteryResults.ts:16:47)
    at Module._compile (node:internal/modules/cjs/loader:1369:14)
    at Module.m._compile (/Users/petrpotapov/Projects/lottery-smart-func/smart-func/node_modules/ts-node/src/index.ts:1618:23)
    at Module._extensions..js (node:internal/modules/cjs/loader:1427:10)
    at Object.require.extensions.<computed> [as .ts] (/Users/petrpotapov/Projects/lottery-smart-func/smart-func/node_modules/ts-node/src/index.ts:1621:12)
    at Module.load (node:internal/modules/cjs/loader:1206:32)
    at Function.Module._load (node:internal/modules/cjs/loader:1022:12)
    at Module.require (node:internal/modules/cjs/loader:1231:19)

Environment:
"@fotonjs/core": "^0.0.7",
"@ton/core": "^0.56.3",

TS config (tested in different environments, didn't help):
{
"compilerOptions": {
"target": "ES2020",
"outDir": "dist",
"module": "commonjs",
"declaration": true,
"esModuleInterop": true,
"forceConsistentCasingInFileNames": true,
"strict": true,
"skipLibCheck": true
}
}

My current ideation process is that this library is designed to be used in browser environment with nodejs polyfills and isn't designed to be used on the backend. Is that correct assumption?

Add mnemonics for WalletClient

It would be great to add mnemonic initialization to the WalletClient in the foton library. This feature would allow users to import wallets using mnemonic phrases, derive key pairs, and sign transactions using those keys.

Requirements
Implement a method to initialize WalletClient with a mnemonic phrase.
Derive key pairs using a standard derivation path.
Enable transaction signing with the derived keys.