diff --git a/contract-dev/testing/testnet-tokens.mdx b/contract-dev/testing/testnet-tokens.mdx new file mode 100644 index 000000000..c0a10804e --- /dev/null +++ b/contract-dev/testing/testnet-tokens.mdx @@ -0,0 +1,117 @@ +--- +title: "How to get Toncoin on testnet" +sidebarTitle: "Get Toncoin on testnet" +--- + +import { Image } from '/snippets/image.jsx'; +import { Aside } from '/snippets/aside.jsx'; + +Testnet Toncoin are free coins used for development and testing on the TON testnet. + +To obtain testnet Toncoin, a testnet wallet is required. +See [wallets overview](/ecosystem/wallet-apps/overview) for available options. + +Depending on the required amount of Toncoin, choose one of the following options: + +- For regular requests of 2 TON per hour, use Telegram [Testgiver TON bot](/contract-dev/testing/testnet-tokens#use-testgiver-ton-bot). +- For larger allocations of up to 5,000 TON, submit a [request form](/contract-dev/testing/testnet-tokens#use-request-form). + +## Use Testgiver TON Bot + +1. Download [Telegram](https://telegram.org/) and create an account. + +1. Open [`@testgiver_ton_bot`](https://t.me/testgiver_ton_bot) in a browser and click Open Telegram. + + Open Telegram prompt + +1. Once the bot opens, click Start to initiate the session. + + Start bot screen + +1. After the `/start` command is sent, the bot displays a welcome message. Click Get 2 TON in testnet to request test coins. + + Bot welcome screen + +1. A captcha prompt appears. Open the image to view it in full size and enter the displayed characters. + + Captcha screen + +1. Once the captcha is complete, enter the testnet wallet address. + + Enter wallet address + + + +1. After submitting the address, a message confirms that the request is queued. Then, the bot processes it and sends 2 Toncoin in testnet. + + Request confirmed + +1. No additional confirmation is sent when the request is processed. + To confirm receipt of the testnet Toncoin, see [Verify the transfer](/contract-dev/testing/testnet-tokens#verify-the-transfer). + +1. To request again, open the menu in the lower-left corner, select `/get`, and repeat the steps. + + Bot menu + +## Use request form + +Request up to 5,000 testnet TON by completing the [token request form](https://builders.ton.org/profile/projects/new?applicationSlug=testnet-form). +The TON Foundation reviews the submission and transfers the tokens directly to the specified testnet wallet address. + +## Verify the transfer + +After requesting tokens, use the Tonviewer Testnet explorer to verify that the transfer occurred. + +1. Open [Tonviewer Testnet](https://testnet.tonviewer.com/), enter the wallet address in the search bar, and click Find. + + Tonviewer search + +1. The explorer shows the current balance and transaction history, including the testnet Toncoin received from the bot. The account state is `uninit`, indicating that the account is not deployed. + + Wallet balance showing uninit state + +1. To [deploy the account](/ecosystem/wallet-apps/web#deploy-the-code) send any transaction from the wallet. diff --git a/docs.json b/docs.json index f7b670ab6..3cc592aaf 100644 --- a/docs.json +++ b/docs.json @@ -373,6 +373,7 @@ "group": "Testing", "pages": [ "contract-dev/testing/overview", + "contract-dev/testing/testnet-tokens", "contract-dev/testing/testing-on-real-network", "contract-dev/testing/styleguide", "contract-dev/testing/reference" diff --git a/resources/dictionaries/custom.txt b/resources/dictionaries/custom.txt index 0adaf9a7e..12863cbbd 100644 --- a/resources/dictionaries/custom.txt +++ b/resources/dictionaries/custom.txt @@ -5,44 +5,397 @@ # ~ is a prefix that tells the spell checker to only use the word when case sensitivity is turned off. -ary -tos -abelian ABI* -accountchain -Accountchain -accountchains -addon -adnl ADNL +AMM* +API +APIs +APY +AVX +Accountchain Aigerim -aigerimu Aiogram -akifoq Alefman Alejandbel AlexG -algorithm Aliaksandr Alibaba +Altcoin +Andr +Andrew +Andrey +Anton +Antonoff +Avacoin +Axios +B4ckSl4sh +BCM +BCP +BFT +BLS +Bahdanau +Baranov +Basechain +Bemo +Binance +Birman +Bitmask +Bitshares +Blockchain +Blockscout +BoC +BoCs +Booleans +Bounceable +Brodie +Brujn +Buildx +Burnosov +Buterin +CCITT +CEX +CEXes +CEXs +CLion +CMC +CMake +CPUs +CTA +CTAs +Callables +Catchain +Catchains +Certik +Chainbase +Ciphertexts +Circom +Coalus +Codepage +Codepages +Codepoint +Codespaces +Codium +Coinbase +Combinator +Combinators +Configs +Configurator +Coq +Crosschain +Crowdin +Cryptobot +Cryptocurrencies +Cryptosystem +Cryptosystems +DApp +DApps +DCA +DEX +DEXes +DEXs +DHT +DHTs +DYOR +DYX +Daniil +Datagram +Decompiled +Decompiler +Deduplication +Dehasher +Deployer +Diffie +Dockerize +Dockerized +Dodis +Domínguez +Duif +Durov +Dyor +EIP +EOA +EOAs +ERC +EVAA +EVM +EVMs +Emelyanenko +Endian +Enums +Eruda +Ethena +Ethereum +Ethernaut +Ethers +Etherscan +Everscale +FTs +Favour +Fift +Figma +Flappy +Frontmatter +GTon +Ganache +Gb +Gbps +Gigadrop +Gigatons +Gilmanova +Gitpod +Goldschlag +Golev +Grafana +Gunicorn +Gutarev +Hackathon +Hashmap +Hashmaps +Hasse +Hetzner +Highload +Homotopy +Héctor +IHR +IPFS +Imedashvili +Inclusivity +Initializer +Interchain +JDK +Jesús +Jetbrains +Jettons +KYC +Kademlia +Kaladin13 +Karkarmath +Kelmer +Kelvin +Keyblock +Keyblocks +Kiayas +Kol +Kolya +LLM +LSB +LSP +Lamport +Lange +Larimer +Lateinit +Latinisms +Lavinia +Leaderboard +Lebedev +Liskov +Liteclient +Litecoin +Liteserver +Liteservers +Lottie +Luby +Luhn +Lynis +MPP +MTProto +MTon +Mainnet +Masterchain +Maymounkov +Memoizing +Mempool +Merkle +Metafile +Metaverse +Micropayments +Microtransaction +Minimalistic +Mintlify +Monero +Multicasting +Multichain +Multiplatform +Mytonctrl +NFA +NFTs +NOPs +NVMe +Nakamoto +Namespace +Namespaces +Navbar +Neovim +Nginx +Niels +Nikolay +Nota +Notcoin +Novus +Nowarp +Nullability +Nullable +Nullables +OCaml +OVH +Offchaining +Oleg +Ona +Onchain +Onda +PDFs +PRNG +PRNGs +Pavel +Pease +Permissionless +Peyton +Phaser +Pitaya +Pragmas +Precompiled +Preloads +Prolog +Prometheus +Pseudocode +Pushgateway +Pyth +Qodo +RIST +RLDP +RPCs +Ratelance +Redistributable +Reindex +Reindexes +Reindexing +Relatedly +Reputational +Reth +Retracer +Revm +Ristretto +Rollup +SBTs +SCCCG +SDKs +SECD +SELinux +SEO +STON.fi +SVM +Scannability +Schnorr +Sedov +Serializable +Sharding +Shokrollahi +Shostak +Sild +Singlechain +Snarkjs +Solana +Soulbound +Spellbook +Stablecoin +Stablecoins +Ston +Syverson +Sánchez +TASM +TEP +TEPs +TES +TLB +TMA +TMAs +TVL +TVM +TVMs +Tal +Talpas +Tanenbaum +Tanja +Tblkch +Tencent +Testgiver +Testnet +Tezos +Tock +Tokenomics +Tolk +Toncenter +Toncoin +Toncoins +Toncx +Tonhub +Tonkeeper +Tonkey +Tonlib +Tonstarter +Tonviewer +Tradoor +TransactionDescr +Trunov +TxTracer +UIs +URIs +USDe +USDt +Uint +Uiua +Unary +Underload +Uninit +Universa +Upgradability +VMs +VPNs +VSCodium +VSX +Vadim +Validator +Validators +Viem +Vladas +Vladimir +Volkov +Vultr +WDK +Wagmi +Walkthrough +Walletconnect +Watchlist +Webserver +Weil +XMM +XMPL +XORing +Xia +Yolo +Yu +Yung +ZK-proof +Zakrevskis +Zellic +abelian +accountchain +accountchains +addon +adnl +aigerimu +akifoq +algorithm allowlist allowlists altcoin -Altcoin altcoins -AMM* -Andr andrei -Andrew -Andrey antecessor antecessors -Anton -Antonoff anycast aor api -API -APIs -APY arith arity asin @@ -50,167 +403,95 @@ asm asms asynchrony autogenerates -Avacoin -AVX axios -Axios -B4ckSl4sh -Bahdanau -Baranov basechain -Basechain bb -BCM -BCP befor -Bemo bene -BFT -Binance birational birationally -Birman bitcode bitmask -Bitmask -Bitshares bitshift bitstring bitstrings bitwise blazingly blockchain -Blockchain blockchains blockquote blockquotes -Blockscout -BLS -BoC -BoCs booleans -Booleans bounceability bounceable -Bounceable -Brodie browseability -Brujn buildx -Buildx bundler -Burnosov -Buterin +cNFT +cNFTs callables -Callables callee callout callouts canonicalization catchain -Catchain catchains -Catchains catchchain cbcast cbcasts -CCITT celldb -Certik -CEX -CEXes -CEXs chainable -Chainbase cheatsheet chksig ciphertexts -Ciphertexts circom -Circom clcf -CLion -CMake -CMC -cNFT -cNFTs -Coalus codegen codepage -Codepage codepages -Codepages -Codepoint codepoints codespace codespaces -Codespaces -Codium codomain cofactor cofactors -Coinbase combinator -Combinator combinators -Combinators componentwise composable concatenative configs -Configs configurator -Configurator consortiums constructivization constructivized cooldown -Coq counterparty -CPUs cron crosschain -Crosschain -Crowdin crypto -Cryptobot cryptocurrencies -Cryptocurrencies cryptocurrency cryptosystem -Cryptosystem cryptosystems -Cryptosystems cryptowallet cta -CTA -CTAs d3fl4t3 -Daniil dApp -DApp dApps -DApps datacenters datagram -Datagram datagrams -DCA declarator decodable -Decompiled -Decompiler deduplicate deduplicates deduplicating deduplication -Deduplication -Dehasher delegators den_lavi denylist deployer -Deployer dequeued dequeueing dereference @@ -220,208 +501,98 @@ deserialized deserializes deserializing devnet -DEX -DEXes -DEXs -DHT -DHTs -Diffie dockerize -Dockerize dockerized -Dockerized -Dodis -Domínguez dotenv dton -Duif -Durov -Dyor -DYOR -DYX -EIP -Emelyanenko enablement endian -Endian enqueued -Enums -EOA -EOAs -ERC -Eruda -Ethena -Ethereum -Ethernaut -Ethers -Etherscan -EVAA -Everscale -EVM -EVMs failover -Favour favourkelvin17 fift -Fift -Figma -Flappy forall -frontmatter -Frontmatter -FTs -Ganache +frontmatter gasless gatekeeping -Gb -Gbps geo getgems getters -Gigadrop gigaton -Gigatons -Gilmanova gitbook -Gitpod globals -Goldschlag -Golev -Grafana grammY -GTon -Gunicorn gusarich -Gutarev gwei hackathon -Hackathon hackathons hard-code hard-coded hardcode hardcoded hashmap -Hashmap -Hashmaps -Hasse -Héctor -Hetzner highload -Highload -Homotopy hostname iconUrl ident -IHR -Imedashvili impactful incentivizes inclusivity -Inclusivity indeterministic infobox init initializer -Initializer injective injectivity inlined inlines inlining -Interchain involutive -IPFS isogeny -JDK jemalloc jeshecdom -Jesús -Jetbrains jettons -Jettons js -Kademlia -Kaladin13 -Karkarmath -Kelmer -Kelvin +kTon keyblock -Keyblock keyblocks -Keyblocks keypair keystore keystores -Kiayas -Kol -Kolya -kTon -KYC -Lamport -Lange -Larimer -Lateinit -Latinisms -Lavinia leaderboard -Leaderboard -Lebedev linkability -Liskov -Liteclient -Litecoin liteserver -Liteserver liteservers -Liteservers liveness -LLM llms lockdown lookups lottie -Lottie -LSB -LSP lt -Luby -Luhn -Lynis mainnet -Mainnet masterchain -Masterchain masterchains matchers +mathbb +mathbf mathlib -Maymounkov memearchivarius memecoin memoization -Memoizing mempool -Mempool mergesort merkle -Merkle metafile -Metafile -Metaverse micropayment micropayments -Micropayments microton microtransaction -Microtransaction microtransactions milli minimalistic -Minimalistic minmax mintable mintless -Mintlify mintmachine misclick misclicks @@ -429,92 +600,51 @@ misconfiguration misconfigured misti mitigations -Monero monoid monorepo monospace monospaced montgomery -MPP -MTon -MTProto multibyte multicast -Multicasting multichain -Multichain multiplatform -Multiplatform multiset multisig multisignature mytoncore mytonctrl -Mytonctrl -Nakamoto namespace -Namespace namespaces -Namespaces nano +nanoTon +nanoToncoin nanogram nanoton -nanoTon nanotoncoin -nanoToncoin nanotoncoins nanotons navbar -Navbar -Neovim -NFA nft -NFTs -Nginx -Niels -Nikolay nonexist -NOPs nota -Nota -Notcoin -Novus novusnota -Nowarp nullability -Nullability nullable -Nullable nullables -Nullables nullary -NVMe -OCaml offchain -Offchaining -Oleg -Ona onchain -Onchain -Onda onwards openlib openrouter outcoming -OVH param parameterization pasteable -Pavel paywalled -PDFs -Pease performant permissionless -Permissionless -Peyton -Phaser -Pitaya plaintext plaintexts plsc @@ -522,9 +652,7 @@ pluggable postprocessed pragma pragmas -Pragmas precommitted -Precompiled preconfigure preconfigured preconfigures @@ -533,83 +661,48 @@ prefetch preimages preloading preloads -Preloads -PRNG -PRNGs projectId -Prolog prometheus -Prometheus proxying pseudocode -Pseudocode pseudorandom pseudorandomly pushgateway -Pushgateway px pyAndr3w -Pyth pytoniq -Qodo queryable ragpull -Ratelance reconnections recv redeclaration redeclared redistributable -Redistributable reindex -Reindex reindexes -Reindexes reindexing -Reindexing reinitializes reinstalls relatedly -Relatedly relayer -Reputational resharding resynced -Reth retracer -Retracer reveloper -Revm -RIST -Ristretto -RLDP rollup -Rollup -RPCs ruleset runbooks runtimes -Sánchez sandboxing savelist savelists sbt -SBTs scannability -Scannability -SCCCG -Schnorr sdks -SDKs -SECD -Sedov -SELinux semver sendBoc -SEO seqno seqnos -Serializable serializer serializers setwebpass @@ -618,33 +711,20 @@ shardchain shardchains sharded sharding -Sharding sharedlibrary -Shokrollahi shorteners -Shostak sidechain sidechains -Sild silddev -Singlechain skillset skywardboundd smartcont -Snarkjs -Solana -Soulbound -Spellbook sse stablecoin -Stablecoin stablecoins -Stablecoins stakers standart stdlib -Ston -STON.fi styleguide subarrays subcase @@ -677,86 +757,42 @@ subwallet subwallets sudo superserver -SVM swappable systemd -Syverson -tagless -Tal -Talpas -Tanenbaum -Tanja tApp tApps -TASM -Tblkch -Tencent -TEP -TEPs -TES +tagless testnet -Testnet -Tezos -TLB -TMA -TMAs tock -Tock tokenomics -Tokenomics tolk -Tolk toncenter -Toncenter toncoin -Toncoin -Toncoins -Toncx tondevwallet -Tonhub -Tonkeeper -Tonkey tonlib -Tonlib tonscan -Tonstarter tonviewer -Tonviewer tonweb toolchain toolset tracebacks -Tradoor -TransactionDescr trie -Trunov truthy ts tsUSDe -TVL -TVM -TVMs -TxTracer uint -Uint -UIs -Uiua unary -Unary unblockable undecodable underload -Underload underperforming undiscussed unencrypted unenveloped unforgeable uninit -Uninit unintuitive uniswap -Universa unixtime unpair unparsed @@ -767,57 +803,22 @@ untrusted untyped unvoted updatable -Upgradability uptimes -URIs -USDe -USDt utils utime -Vadim +vCPUs validator -Validator validators -Validators variadic varuint* -vCPUs verytactical -Viem virtualized -Vladas -Vladimir -VMs -Volkov -VPNs -VSCodium -VSX -Vultr -Wagmi walkthrough -Walkthrough -Walletconnect wargame -Watchlist -WDK webserver -Webserver webview -Weil whitepaper whitepapers workchain workchains -Xia -XMM -XMPL -XORing -Yolo -Yu -Yung -Zakrevskis -Zellic zerostate -mathbb -ZK-proof -mathbf diff --git a/resources/images/fund-wallet/account-uninit-dark.png b/resources/images/fund-wallet/account-uninit-dark.png new file mode 100644 index 000000000..ee4087b82 Binary files /dev/null and b/resources/images/fund-wallet/account-uninit-dark.png differ diff --git a/resources/images/fund-wallet/account-uninit-light.png b/resources/images/fund-wallet/account-uninit-light.png new file mode 100644 index 000000000..d02292dc9 Binary files /dev/null and b/resources/images/fund-wallet/account-uninit-light.png differ diff --git a/resources/images/fund-wallet/bot-welcome-dark.png b/resources/images/fund-wallet/bot-welcome-dark.png new file mode 100644 index 000000000..da04988b8 Binary files /dev/null and b/resources/images/fund-wallet/bot-welcome-dark.png differ diff --git a/resources/images/fund-wallet/bot-welcome-light.png b/resources/images/fund-wallet/bot-welcome-light.png new file mode 100644 index 000000000..b053b2d6d Binary files /dev/null and b/resources/images/fund-wallet/bot-welcome-light.png differ diff --git a/resources/images/fund-wallet/captcha-dark.png b/resources/images/fund-wallet/captcha-dark.png new file mode 100644 index 000000000..48f4993bb Binary files /dev/null and b/resources/images/fund-wallet/captcha-dark.png differ diff --git a/resources/images/fund-wallet/captcha-light.png b/resources/images/fund-wallet/captcha-light.png new file mode 100644 index 000000000..d31a73c9f Binary files /dev/null and b/resources/images/fund-wallet/captcha-light.png differ diff --git a/resources/images/fund-wallet/enter-address-dark.png b/resources/images/fund-wallet/enter-address-dark.png new file mode 100644 index 000000000..e37bab0b0 Binary files /dev/null and b/resources/images/fund-wallet/enter-address-dark.png differ diff --git a/resources/images/fund-wallet/enter-address-light.png b/resources/images/fund-wallet/enter-address-light.png new file mode 100644 index 000000000..d4467e6fc Binary files /dev/null and b/resources/images/fund-wallet/enter-address-light.png differ diff --git a/resources/images/fund-wallet/menu-dark.png b/resources/images/fund-wallet/menu-dark.png new file mode 100644 index 000000000..1d237ea79 Binary files /dev/null and b/resources/images/fund-wallet/menu-dark.png differ diff --git a/resources/images/fund-wallet/menu-light.png b/resources/images/fund-wallet/menu-light.png new file mode 100644 index 000000000..951cce357 Binary files /dev/null and b/resources/images/fund-wallet/menu-light.png differ diff --git a/resources/images/fund-wallet/open-telegram-dark.png b/resources/images/fund-wallet/open-telegram-dark.png new file mode 100644 index 000000000..68aa19c4d Binary files /dev/null and b/resources/images/fund-wallet/open-telegram-dark.png differ diff --git a/resources/images/fund-wallet/open-telegram-light.png b/resources/images/fund-wallet/open-telegram-light.png new file mode 100644 index 000000000..ce94ed289 Binary files /dev/null and b/resources/images/fund-wallet/open-telegram-light.png differ diff --git a/resources/images/fund-wallet/request-confirmed-dark.png b/resources/images/fund-wallet/request-confirmed-dark.png new file mode 100644 index 000000000..242fc8ca5 Binary files /dev/null and b/resources/images/fund-wallet/request-confirmed-dark.png differ diff --git a/resources/images/fund-wallet/request-confirmed-light.png b/resources/images/fund-wallet/request-confirmed-light.png new file mode 100644 index 000000000..0596f5035 Binary files /dev/null and b/resources/images/fund-wallet/request-confirmed-light.png differ diff --git a/resources/images/fund-wallet/start-bot-dark.png b/resources/images/fund-wallet/start-bot-dark.png new file mode 100644 index 000000000..99c1682e9 Binary files /dev/null and b/resources/images/fund-wallet/start-bot-dark.png differ diff --git a/resources/images/fund-wallet/start-bot-light.png b/resources/images/fund-wallet/start-bot-light.png new file mode 100644 index 000000000..d56176ed9 Binary files /dev/null and b/resources/images/fund-wallet/start-bot-light.png differ diff --git a/resources/images/fund-wallet/testgiver.png b/resources/images/fund-wallet/testgiver.png new file mode 100644 index 000000000..f6d2cd299 Binary files /dev/null and b/resources/images/fund-wallet/testgiver.png differ diff --git a/resources/images/fund-wallet/tonviewer-dark.png b/resources/images/fund-wallet/tonviewer-dark.png new file mode 100644 index 000000000..0145244d4 Binary files /dev/null and b/resources/images/fund-wallet/tonviewer-dark.png differ diff --git a/resources/images/fund-wallet/tonviewer-light.png b/resources/images/fund-wallet/tonviewer-light.png new file mode 100644 index 000000000..90336507f Binary files /dev/null and b/resources/images/fund-wallet/tonviewer-light.png differ