From 3e5c4271334c96d10b835a7dbaa001c7c7025c30 Mon Sep 17 00:00:00 2001 From: Lucas Tortora <85233773+lucas-tortora@users.noreply.github.com> Date: Tue, 12 Nov 2024 12:04:34 -0300 Subject: [PATCH] task(devx): Updated devnet and testnet endpoints. (#4012) Removed Alphanet from docs Added admonition about the Mainnet running stardust. TODO: CONFIRM genesis blob URL UDPATE snapshot URLS UPDATE iota-full-node.mdx#L-114-120 UPDATE https://github.com/iotaledger/iota/blob/ TEST networkSelect.js works with devnet and tesnet RPCs --- docs/content/_snippets/alphanet.mdx | 9 ------- .../_snippets/mainnet-runs-stardust.mdx | 5 ++++ docs/content/_snippets/warn-ml-rpcs.mdx | 4 ++- docs/content/about-iota/about-iota.mdx | 7 +++-- .../iota-wallet/how-to/get-test-tokens.mdx | 2 +- .../developer/advanced/custom-indexer.mdx | 8 +++--- .../exchange-integration.mdx | 8 ++---- .../getting-started/client-tssdk.mdx | 6 ++--- .../developer/getting-started/connect.mdx | 20 ++++---------- .../developer/getting-started/get-coins.mdx | 7 ++--- .../developer/getting-started/graphql-rpc.mdx | 7 +++-- docs/content/developer/graphql-rpc.mdx | 2 +- .../transactions/sign-and-send-txn.mdx | 3 --- .../developer/iota-101/using-events.mdx | 7 ++--- .../developer/iota-move-ctf/challenge_1.mdx | 4 +-- .../developer/iota-move-ctf/introduction.mdx | 6 ++--- docs/content/developer/network-overview.mdx | 13 ++++------ docs/content/developer/standards/display.mdx | 2 +- docs/content/operator/iota-full-node.mdx | 12 ++++----- docs/content/references/cli/client.mdx | 19 ++++++-------- docs/content/references/cli/console.mdx | 2 +- docs/content/references/cli/validator.mdx | 10 +++---- .../references/contribute/style-guide.mdx | 2 +- .../event-query-and-subscription.mdx | 2 +- .../references/exchange-integration-guide.mdx | 9 +++---- .../references/ts-sdk/dapp-kit/index.mdx | 5 +--- .../ts-sdk/dapp-kit/iota-client-provider.mdx | 10 +++---- .../dapp-kit/wallet-hooks/useAccounts.mdx | 2 +- .../wallet-hooks/useAutoConnectWallet.mdx | 2 +- .../wallet-hooks/useConnectWallet.mdx | 2 +- .../wallet-hooks/useCurrentAccount.mdx | 2 +- .../wallet-hooks/useCurrentWallet.mdx | 2 +- .../wallet-hooks/useDisconnectWallet.mdx | 2 +- .../useSignAndExecuteTransactionBlock.mdx | 2 +- .../wallet-hooks/useSignPersonalMessage.mdx | 2 +- .../wallet-hooks/useSignTransactionBlock.mdx | 2 +- .../wallet-hooks/useSwitchAccount.mdx | 2 +- .../dapp-kit/wallet-hooks/useWallets.mdx | 2 +- .../ts-sdk/kiosk/advanced-examples.mdx | 7 ++--- .../references/ts-sdk/kiosk/from-v1.mdx | 18 ++++++------- .../kiosk/kiosk-client/introduction.mdx | 3 --- .../typescript/cryptography/keypairs.mdx | 6 +---- .../ts-sdk/typescript/hello-iota.mdx | 3 --- .../references/ts-sdk/typescript/index.mdx | 26 ++++++++++++------- .../ts-sdk/typescript/iota-client.mdx | 2 +- .../typescript/owned-object-pool/examples.mdx | 5 +--- .../owned-object-pool/local-development.mdx | 2 +- docs/examples/move/ctf/README.md | 2 +- docs/site/docusaurus.config.js | 2 +- .../components/API/api-ref/networkselect.js | 12 ++++----- docs/site/src/components/CTF/ctf-verifier.tsx | 5 ++-- docs/site/src/components/constant.tsx | 24 ++++++++--------- docs/site/src/pages/index.js | 2 +- docs/site/src/utils/getopenrpcspecs.js | 2 +- 54 files changed, 143 insertions(+), 191 deletions(-) delete mode 100644 docs/content/_snippets/alphanet.mdx create mode 100644 docs/content/_snippets/mainnet-runs-stardust.mdx diff --git a/docs/content/_snippets/alphanet.mdx b/docs/content/_snippets/alphanet.mdx deleted file mode 100644 index 7ec499e0560..00000000000 --- a/docs/content/_snippets/alphanet.mdx +++ /dev/null @@ -1,9 +0,0 @@ -:::tip Alphanet - -At the moment, you can only use the Alphanet API, faucet and [explorer](https://explorer.iota.cafe/): - -* **JSON RPC URL**: `https://api.iota-rebased-alphanet.iota.cafe:443` -* **Faucet URL**: `https://faucet.iota-rebased-alphanet.iota.cafe/gas` -* **Explorer**: https://explorer.iota.cafe/?network=alphanet - -::: \ No newline at end of file diff --git a/docs/content/_snippets/mainnet-runs-stardust.mdx b/docs/content/_snippets/mainnet-runs-stardust.mdx new file mode 100644 index 00000000000..39032335d81 --- /dev/null +++ b/docs/content/_snippets/mainnet-runs-stardust.mdx @@ -0,0 +1,5 @@ +:::warning Stardust Protocol + +The IOTA Mainnet runs the [Stardust Protocol](https://wiki.iota.org/learn/protocols/stardust/introduction/). + +::: diff --git a/docs/content/_snippets/warn-ml-rpcs.mdx b/docs/content/_snippets/warn-ml-rpcs.mdx index 312b7266c38..d54a7bd25aa 100644 --- a/docs/content/_snippets/warn-ml-rpcs.mdx +++ b/docs/content/_snippets/warn-ml-rpcs.mdx @@ -1,6 +1,8 @@ :::caution -Use dedicated nodes/shared services rather than public endpoints for production apps. The public endpoints maintained by the IOTA Foundation (`https://api.iota-rebased-alphanet.iota.cafe:443`) are rate-limited, and support only 100 requests per 30 seconds. Do not use public endpoints in production applications with high traffic volume. +Use dedicated nodes/shared services rather than public endpoints for production apps. The public endpoints maintained +by the IOTA Foundation are rate-limited, and support only 100 requests +per 30 seconds. Do not use public endpoints in production applications with high traffic volume. You can either run your own Full nodes, or outsource this to a professional infrastructure provider (preferred for apps that have high traffic). diff --git a/docs/content/about-iota/about-iota.mdx b/docs/content/about-iota/about-iota.mdx index 1ffb6acb93e..17524244fbc 100644 --- a/docs/content/about-iota/about-iota.mdx +++ b/docs/content/about-iota/about-iota.mdx @@ -1,5 +1,6 @@ -# About IOTA +import MainnetRunsStardust from '../_snippets/mainnet-runs-stardust.mdx'; +# About IOTA The IOTA ecosystem enables programmability in both [Layer 1](#layer-1) and [Layer 2](#layer-2) using [Move](#move) and [EVM/Solidity](#evm) smart contracts respectively. @@ -31,7 +32,9 @@ While the Move compiler catches many development mistakes, smart contracts can s #### IOTA Mainnet -The IOTA Mainnet processes production transaction blocks. The IOTA Mainnet's tokens have a real-world value, so we recommend that you use the IOTA Testnet or Devnet to develop your application. + + +The [IOTA Mainnet](https://wiki.iota.org/build/networks-endpoints/#iota) processes production transaction blocks. The IOTA Mainnet's tokens have a real-world value, so we recommend that you use the IOTA Testnet or Devnet to develop your application. #### IOTA Testnet diff --git a/docs/content/about-iota/iota-wallet/how-to/get-test-tokens.mdx b/docs/content/about-iota/iota-wallet/how-to/get-test-tokens.mdx index b429ef3d240..36690907c32 100644 --- a/docs/content/about-iota/iota-wallet/how-to/get-test-tokens.mdx +++ b/docs/content/about-iota/iota-wallet/how-to/get-test-tokens.mdx @@ -3,7 +3,7 @@ description: A guide on how to use IOTA Wallet for testing on different IOTA net --- # Get Test Tokens -You can test apps on the IOTA network using IOTA Wallet. Besides the IOTA Mainnet, the wallet supports connections to IOTA Testnet, IOTA Devnet, a [Local network](../../../developer/getting-started/local-network.mdx), or a Custom RPC URL for a network you create. +You can test apps on the IOTA network using IOTA Wallet. The wallet supports connections to IOTA Testnet, IOTA Devnet, a [Local network](../../../developer/getting-started/local-network.mdx), or a Custom RPC URL for a network you create. ## Change the Active Network Connection diff --git a/docs/content/developer/advanced/custom-indexer.mdx b/docs/content/developer/advanced/custom-indexer.mdx index d833a92eb9c..3dcabc17a54 100644 --- a/docs/content/developer/advanced/custom-indexer.mdx +++ b/docs/content/developer/advanced/custom-indexer.mdx @@ -31,10 +31,10 @@ Data ingestion for your indexer supports several checkpoint stream sources. The most straightforward stream source is to subscribe to a remote store of checkpoint contents. IOTA provides the following buckets: -- Testnet: `https://checkpoints.testnet.iota.io` -- Mainnet: `https://checkpoints.mainnet.iota.io` +- Testnet: `https://indexer.testnet.iota.cafe` +- Devnet: `https://indexer.devnet.iota.cafe` -The checkpoint files are stored in the following format: `https://checkpoints.testnet.iota.io/.chk`. You can download the checkpoint file by sending an HTTP GET request to the relevant URL. Try it yourself for checkpoint 1 at [https://checkpoints.testnet.iota.io/1.chk](https://checkpoints.testnet.iota.io/1.chk). +The checkpoint files are stored in the following format: `https://indexer.testnet.iota.cafe/.chk`. You can download the checkpoint file by sending an HTTP GET request to the relevant URL. Try it yourself for checkpoint 1 at [https://indexer.testnet.iota.cafe/1.chk](https://indexer.testnet.iota.cafe/1.chk). ```mermaid flowchart LR @@ -110,7 +110,7 @@ Specify both a local and remote store as a fallback to ensure constant data flow ```rust executor.run( PathBuf::from("./chk".to_string()), // path to a local directory - Some("https://checkpoints.testnet.iota.io".to_string()), // Remote Checkpoint Store + Some("https://indexer.testnet.iota.cafe".to_string()), // Remote Checkpoint Store vec![], // optional remote store access options ReaderOptions::default(), exit_receiver, diff --git a/docs/content/developer/exchange-integration/exchange-integration.mdx b/docs/content/developer/exchange-integration/exchange-integration.mdx index 720136c343d..25c2a2363a2 100644 --- a/docs/content/developer/exchange-integration/exchange-integration.mdx +++ b/docs/content/developer/exchange-integration/exchange-integration.mdx @@ -3,7 +3,6 @@ title: IOTA Exchange Integration Guide description: Learn the primary tasks necessary to integrate IOTA, the token native to the IOTA network, into a cryptocurrency exchange. --- -import AlphaNet from "../../_snippets/alphanet.mdx"; import Quiz from '@site/src/components/Quiz'; import questions from '/json/developer/exchange-intergration/exchange-integration.json'; @@ -99,10 +98,9 @@ You can track balance changes by calling `iotax_getBalance` at predefined interv The following bash example demonstrates how to use `iotax_getBalance` for address `0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3`. If you use a network other than Devnet, replace the value for `rpc` with the URL to the appropriate Full node. - ```bash -rpc="https://fullnode.devnet.iota.org:443" +rpc="https://api.devnet.iota.cafe:443" address="0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3" data="{\"jsonrpc\": \"2.0\", \"method\": \"iotax_getBalance\", \"id\": 1, \"params\": [\"$address\"]}" curl -X POST -H 'Content-type: application/json' --data-raw "$data" $rpc @@ -123,8 +121,6 @@ The response is a JSON object that includes the `totalBalance` for the address: ### Using Rust - - The following example demonstrates using `iotax_getBalance` in Rust: ```rust use std::str::FromStr; @@ -134,7 +130,7 @@ use iota_sdk::IotaClientBuilder; #[tokio::main] async fn main() -> Result<(), anyhow::Error> { let iota = IotaClientBuilder::default().build( - "https://fullnode.devnet.iota.org:443", + "https://api.devnet.iota.cafe:443", ).await.unwrap(); let address = IotaAddress::from_str("0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3")?; let objects = iota.coin_read_api().get_balance(address, None).await?; diff --git a/docs/content/developer/getting-started/client-tssdk.mdx b/docs/content/developer/getting-started/client-tssdk.mdx index dd472b3e3b6..b9547823e86 100644 --- a/docs/content/developer/getting-started/client-tssdk.mdx +++ b/docs/content/developer/getting-started/client-tssdk.mdx @@ -4,7 +4,6 @@ tags: [ typescript, sdk, getting-started, install] --- import InfoPnpmRequired from "../../_snippets/info-pnpm-required.mdx"; -import AlphaNet from "../../_snippets/alphanet.mdx"; import Quiz from '@site/src/components/Quiz'; import questions from '/json/developer/getting-started/client-tssdk.json'; @@ -97,7 +96,6 @@ ReactDOM.createRoot(document.getElementById('root')!).render( , ); ``` - ### `IotaClientProvider` @@ -113,7 +111,7 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query'; const queryClient = new QueryClient(); const networks = { devnet: { url: getFullnodeUrl('devnet') }, - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; ReactDOM.createRoot(document.getElementById('root')!).render( @@ -142,7 +140,7 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query'; const queryClient = new QueryClient(); const networks = { devnet: { url: getFullnodeUrl('devnet') }, - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; ReactDOM.createRoot(document.getElementById('root')!).render( diff --git a/docs/content/developer/getting-started/connect.mdx b/docs/content/developer/getting-started/connect.mdx index 28c2f10c238..1034f0bb658 100644 --- a/docs/content/developer/getting-started/connect.mdx +++ b/docs/content/developer/getting-started/connect.mdx @@ -4,7 +4,7 @@ tags: [ explanation, mainnet, testnet, devnet, cli, setup, install, getting-star --- import DataWipe from "../../_snippets/data-wipe.mdx"; -import AlphaNet from "../../_snippets/alphanet.mdx"; +import MainnetRunsStardust from '../../_snippets/mainnet-runs-stardust.mdx'; import Quiz from '@site/src/components/Quiz'; import questions from '/json/developer/getting-started/connect.json'; @@ -26,9 +26,9 @@ IOTA provides the [IOTA command line interface (CLI)](/references/cli/client.mdx You can use the [CLI](iota-environment.mdx#iota-cli) or [SDKs](iota-environment.mdx#iota-sdks) to send transactions and read requests from using the [JSON-RPC](../../references/iota-api/json-rpc-format.mdx) and the following -endpoint: `https://fullnode..iota.io:443`. +endpoint: `https://api..iota.cafe:443`. - + ## Environment Set Up @@ -80,8 +80,6 @@ IOTA Full node server URL (Defaults to IOTA Testnet if not specified) : If you want to connect to the [Testnet](#testnet), you can simply press `Enter`. - - If not, specify your desired node URL. If you choose to add a custom URL, you should also add an alias for ease of access: @@ -125,11 +123,9 @@ iota client envs The command outputs the available environment aliases, with `(active)` denoting the currently active network. ```sh localnet => http://0.0.0.0:9000 (active) -alphanet => https://api.iota-rebased-alphanet.iota.cafe:443 +testnet => https://https://api.testnet.iota.cafe:443 ``` - - You can add a new environment using the `iota client new` command. You should specify and `alias` and `rpc` URL, for example: @@ -151,12 +147,6 @@ iota client switch --env ## IOTA Networks -### Alphanet - -A temporary network while still in early development, used before public launch of IOTA Rebased. Will be replaced by the Testnet afterwards. - - - ### Devnet The latest stable release. As such, it has the latest features that were tested in the `development` branch of the @@ -171,7 +161,7 @@ test your software in real-world conditions. :::info Testnet node validators -The IOTA Alphanet, Testnet and Devnet networks consist of four validator nodes operated by the IOTA Foundation. +The IOTA Testnet and Devnet networks consist of four validator nodes operated by the IOTA Foundation. ::: diff --git a/docs/content/developer/getting-started/get-coins.mdx b/docs/content/developer/getting-started/get-coins.mdx index 2e1f82334e5..0cc7704f423 100644 --- a/docs/content/developer/getting-started/get-coins.mdx +++ b/docs/content/developer/getting-started/get-coins.mdx @@ -2,7 +2,6 @@ description: Get test IOTA tokens using the IOTA CLI, SDK, or cURL. tags: [how-to, cli, typescript, sdk, faucet] --- -import AlphaNet from "../../_snippets/alphanet.mdx"; import Quiz from '@site/src/components/Quiz'; import questions from '/json/developer/getting-started/get-coins.json'; @@ -26,7 +25,7 @@ You can request test tokens within IOTA Wallet. You can use the following cURL command to request tokens directly from the faucet server: ``` -curl --location --request POST 'https://faucet.iota-rebased-alphanet.iota.cafe/gas' \ +curl --location --request POST 'https://faucet.testnet.iota.cafe/gas' \ --header 'Content-Type: application/json' \ --data-raw '{ "FixedAmountRequest": { @@ -35,11 +34,9 @@ curl --location --request POST 'https://faucet.iota-rebased-alphanet.iota.cafe/g }' ``` - - :::tip Test tokens on a local network -If you're working with a local network, replace `'https://faucet.iota-rebased-alphanet.iota.cafe/gas'` with the appropriate value based on which package runs your network: +If you're working with a local network, replace `'https://faucet.devnet.iota.cafe/gas'` with the appropriate value based on which package runs your network: - `iota-faucet`: `http://127.0.0.1:5003/gas` - `iota start`: `http://127.0.0.1:9123/gas` diff --git a/docs/content/developer/getting-started/graphql-rpc.mdx b/docs/content/developer/getting-started/graphql-rpc.mdx index 98b02f44ae1..08d3b45c726 100644 --- a/docs/content/developer/getting-started/graphql-rpc.mdx +++ b/docs/content/developer/getting-started/graphql-rpc.mdx @@ -5,16 +5,15 @@ description: Intoductory guide to making queries of the IOTA RPC using the Graph The quickest way to access the GraphQL service for IOTA RPC is through the online IDE that provides a complete toolbox for fetching data and executing transactions on the network. The online IDE provides features such as auto-completion (use Ctrl+Space or just start typing), built-in documentation (Book icon, top-left), multi-tabs, and more. -The online IDE is available for [Mainnet](https://iota-mainnet.iota.org/graphql) and [Testnet](https://iota-testnet.iota.org/graphql). This guide contains various queries that you can try directly in the IDE. +The online IDE is available for [Devnet](https://graphql.devnet.iota.cafe/l) and [Testnet](https://graphql.testnet.iota.cafel). This guide contains various queries that you can try directly in the IDE. :::info -- Any existing addresses/object IDs in these examples refer to `mainnet` data only. -- Both [mainnet](https://iota-mainnet.iota.org/graphql) and [testnet](https://iota-testnet.iota.org/graphql) services are rate-limited to keep network throughput optimized. +- Any existing addresses/object IDs in these examples refer to `testnet` data only. +- Both [devnet](https://graphql.devnet.iota.cafe/l) and [testnet](https://graphql.testnet.iota.cafel) services are rate-limited to keep network throughput optimized. ::: For more details about some concepts used in the examples below, please see the [GraphQL concepts](../graphql-rpc.mdx) page, and consult the [reference](../../references/iota-graphql.mdx) for full documentation on the supported schema. - ## Discovering the schema GraphQL introspection exposes the schema supported by the RPC service. The IDE's "Docs" pane (Book icon, top-left) and Search dialog (Cmd+K on macOS or Ctrl+K on Windows and Linux) offer a way to browse introspection output interactively. diff --git a/docs/content/developer/graphql-rpc.mdx b/docs/content/developer/graphql-rpc.mdx index 6232f00f2a3..e3a30aba770 100644 --- a/docs/content/developer/graphql-rpc.mdx +++ b/docs/content/developer/graphql-rpc.mdx @@ -24,7 +24,7 @@ The service accepts the following optional headers: By default, each request returns the service's version in the response header: `x-iota-rpc-version`. ```bash -curl -i -X POST https://explorer.iota.org/mainnet/graphql \ +curl -i -X POST https://explorer.iota.org/testnet/graphql \ --header 'x-iota-rpc-show-usage: true' \ --header 'Content-Type: application/json' \ --data '{ diff --git a/docs/content/developer/iota-101/transactions/sign-and-send-txn.mdx b/docs/content/developer/iota-101/transactions/sign-and-send-txn.mdx index d71187d39a0..e0ccd46b29a 100644 --- a/docs/content/developer/iota-101/transactions/sign-and-send-txn.mdx +++ b/docs/content/developer/iota-101/transactions/sign-and-send-txn.mdx @@ -1,7 +1,6 @@ --- title: Signing and Sending Transactions --- -import AlphaNet from "../../../_snippets/alphanet.mdx"; import Quiz from '@site/src/components/Quiz'; import questions from '/json/developer/iota-101/transactions/sign-and-send-txn.json'; @@ -34,8 +33,6 @@ If you want to use a specific gas coin, first find the gas coin object ID to be ## Examples - - The following examples demonstrate how to sign and execute transactions using Rust, TypeScript, or the IOTA CLI. diff --git a/docs/content/developer/iota-101/using-events.mdx b/docs/content/developer/iota-101/using-events.mdx index 3b00a9ac9ae..f808f9e1e07 100644 --- a/docs/content/developer/iota-101/using-events.mdx +++ b/docs/content/developer/iota-101/using-events.mdx @@ -1,7 +1,6 @@ --- description: Learn how to monitor IOTA on-chain activity by subscribing to events emitted by Move packages. --- -import AlphaNet from "../../_snippets/alphanet.mdx"; import Quiz from '@site/src/components/Quiz'; import questions from '/json/developer/iota-101/using-events.json'; @@ -109,8 +108,6 @@ This example leverages the IOTA TypeScript SDK to subscribe to events the packag ### Rust - - See [Rust SDK](../../references/rust-sdk.mdx). ```rust @@ -122,8 +119,8 @@ use anyhow::Result; #[tokio::main] async fn main() -> Result<()> { let iota = IOTAClientBuilder::default() - .ws_url("wss://fullnode.mainnet.iota.io:443") - .build("https://fullnode.mainnet.iota.io:443") + .ws_url("wss://api.testnet.iota.cafe:443") + .build("https://api.testnet.iota.cafe:443") .await.unwrap(); let mut subscribe_all = iota.event_api().subscribe_event(EventFilter::All(vec![])).await?; loop { diff --git a/docs/content/developer/iota-move-ctf/challenge_1.mdx b/docs/content/developer/iota-move-ctf/challenge_1.mdx index ab3b6f588b4..a8493b5bc13 100644 --- a/docs/content/developer/iota-move-ctf/challenge_1.mdx +++ b/docs/content/developer/iota-move-ctf/challenge_1.mdx @@ -29,8 +29,8 @@ Package: 0xce9b1471301ffaf1453297cca008a68ce851b6a9ba9ab241c357c346177903f3 In this challenge, you must use the IOTA CLI to interact with the blockchain. This set of articles will help you set up your environment and call a deployed contract: - [Installing IOTA CLI](../getting-started/install-iota.mdx) -- [Connecting to Alphanet](../getting-started/connect.mdx) -- [Get Iota coins](../getting-started/get-coins.mdx) +- [Connecting an IOTA Network](../getting-started/connect.mdx) +- [Get IOTA coins](../getting-started/get-coins.mdx) - [Accessing Your Package](../getting-started/publish.mdx#accessing-your-package) diff --git a/docs/content/developer/iota-move-ctf/introduction.mdx b/docs/content/developer/iota-move-ctf/introduction.mdx index ab5d39c2c13..1b33e9f4639 100644 --- a/docs/content/developer/iota-move-ctf/introduction.mdx +++ b/docs/content/developer/iota-move-ctf/introduction.mdx @@ -1,6 +1,6 @@ # Move on IOTA Capture The Flag (CTF) -The **Move on IOTA Capture The Flag (CTF)** is a unique learning experience designed to help developers master the Move programming language by solving a series of challenges. These challenges simulate real-world scenarios that require participants to find and exploit vulnerabilities, optimize contract logic, and interact with IOTA’s alphanet. Whether you're new to Move or experienced with smart contract development, this CTF is an excellent way to sharpen your skills. +The **Move on IOTA Capture The Flag (CTF)** is a unique learning experience designed to help developers master the Move programming language by solving a series of challenges. These challenges simulate real-world scenarios that require participants to find and exploit vulnerabilities, optimize contract logic, and interact with IOTA’s Testnet. Whether you're new to Move or experienced with smart contract development, this CTF is an excellent way to sharpen your skills. This CTF features **eight challenges**, each built on Move, a language optimized for safety and scalability in decentralized applications. Throughout the event, participants are encouraged to explore Move’s features, including its resource-based design and transaction scripting model, in a competitive environment. However, bear in mind that the provided demonstration contracts may intentionally include distractions, poor design, and obscure naming conventions to increase difficulty. @@ -17,10 +17,10 @@ Upon successfully completing a challenge, you will receive a "flag," which is a ## Setup -The CTF contract are already deployed on the IOTA alphanet. To get started, you need to install the IOTA CLI tool and connect to the alphanet. If you haven't done so already, follow these steps: +The CTF contract are already deployed on the IOTA Testnet. To get started, you need to install the IOTA CLI tool and connect to the Testnet. If you haven't done so already, follow these steps: 1. [Install the IOTA CLI Tool](../getting-started/install-iota.mdx) -2. [Connect to alphanet](../getting-started/connect.mdx) +2. [Connect to an IOTA Network](../getting-started/connect.mdx) 3. [Create and Address](../getting-started/get-address.mdx) 4. [Fund Your Address](../getting-started/get-coins.mdx) 5. Get the flags! diff --git a/docs/content/developer/network-overview.mdx b/docs/content/developer/network-overview.mdx index 8dfb43e3403..aff8a1c6402 100644 --- a/docs/content/developer/network-overview.mdx +++ b/docs/content/developer/network-overview.mdx @@ -1,15 +1,16 @@ --- description: This page gives an overview around the different networks available in the IOTA ecosystem. -tags: [getting-started, devnet, testnet, mainnet] +tags: [getting-started, devnet, testnet] --- +import MainnetRunsStardust from '../_snippets/mainnet-runs-stardust.mdx'; +import NetworkInfo from "@site/src/components/NetworkInfo/index.tsx"; +import { Networks } from '@site/src/components/constant.tsx'; # Network Overview This pages gives an overview around the different networks available in the IOTA ecosystem. -import NetworkInfo from "@site/src/components/NetworkInfo/index.tsx"; -import { Networks } from '@site/src/components/constant.tsx'; :::info In general, all endpoints are load-balanced but also subject to rate limiting. If you are developing a production-level application for IOTA, consider [setting up your own infrastructure](/developer/getting-started/local-network) to have more control and avoid any limits. @@ -17,11 +18,7 @@ In general, all endpoints are load-balanced but also subject to rate limiting. I ## IOTA Mainnet -:::note -The Mainnet and Devnet have not yet gone live. -::: - - + ## IOTA Testnet diff --git a/docs/content/developer/standards/display.mdx b/docs/content/developer/standards/display.mdx index 50d701df610..82db8ce3784 100644 --- a/docs/content/developer/standards/display.mdx +++ b/docs/content/developer/standards/display.mdx @@ -8,7 +8,7 @@ import questions from '/json/developer/standards/display.json'; The IOTA Object Display standard is a template engine that enables on-chain management of off-chain representation (display) for a type. With it, you can substitute data for an object into a template string. The standard doesn’t limit the fields you can set. You can use the `{property}` syntax to access all object properties, and then insert them as a part of the template string. -Use a `Publisher` object that you own to set `iota::display` for a type. For more information about `Publisher` objects, see [Publisher](https://examples.iota.io/basics/publisher.html) topic in *IOTA Move by Example*. +Use a `Publisher` object that you own to set `iota::display` for a type. In IOTA Move, `Display` represents an object that specifies a set of named templates for the type `T`. For example, for a type `0x2::hero::Hero` the display syntax is: `Display<0x2::hero::Hero>`. diff --git a/docs/content/operator/iota-full-node.mdx b/docs/content/operator/iota-full-node.mdx index 2c721da81f9..1fad455a326 100644 --- a/docs/content/operator/iota-full-node.mdx +++ b/docs/content/operator/iota-full-node.mdx @@ -112,22 +112,22 @@ Open a terminal or console to the `iota` directory you downloaded in the previou 1. Make a copy of the [Full node YAML template](https://github.com/iotaledger/iota/blob/develop/crates/iota-config/data/fullnode-template.yaml): `cp crates/iota-config/data/fullnode-template.yaml fullnode.yaml` 1. Download the genesis blob for the network to use: - - [Alphanet genesis blob](https://dbfiles.iota-rebased-alphanet.iota.cafe/genesis.blob): - `curl -fLJO https://dbfiles.iota-rebased-alphanet.iota.cafe/genesis.blob` + - [Testnet genesis blob](https://dbfiles.iota-rebased-testnet.iota.cafe/genesis.blob): + `curl -fLJO https://dbfiles.iota-rebased-testnet.iota.cafe/genesis.blob` - [Testnet genesis blob](https://github.com/iotaledger/iota/TODO): `curl -fLJO TODO` - [Mainnet genesis blob](https://github.com/iotaledger/iota/TODO): `curl -fLJO TODO` -1. For Alphanet or Testnet: Edit the `fullnode.yaml` file to include peer nodes for state synchronization. Append the following to the end of the current configuration: +1. For Devnet or Testnet: Edit the `fullnode.yaml` file to include peer nodes for state synchronization. Append the following to the end of the current configuration: - + ```yaml p2p-config: seed-peers: - - address: /dns/access-0.r.iota-rebased-alphanet.iota.cafe/udp/8084 + - address: /dns/access-0.r.iota-rebased-devnet.iota.cafe/udp/8084 peer-id: 10cbea76ea5ec3f7ee827f0c11f612f0059949127876dd964b09304bf8808d18 ``` @@ -137,7 +137,7 @@ Open a terminal or console to the `iota` directory you downloaded in the previou ```yaml p2p-config: seed-peers: - - address: TODO # Example: /dns/yto-tnt-ssfn-01.testnet.iota.io/udp/8084 + - address: TODO # Example: /dns/yto-tnt-ssfn-01.testnet.iota.cafe/udp/8084 peer-id: TODO # Example: 2ed53564d5581ded9b6773970ac2f1c84d39f9edf01308ff5a1ffe09b1add7b3 ``` diff --git a/docs/content/references/cli/client.mdx b/docs/content/references/cli/client.mdx index f5728905ff7..26625324eac 100644 --- a/docs/content/references/cli/client.mdx +++ b/docs/content/references/cli/client.mdx @@ -3,7 +3,6 @@ title: IOTA Client CLI description: The IOTA Client CLI provides command-level access to interact with the IOTA network. --- -import AlphaNet from "../../_snippets/alphanet.mdx"; import CliCheckInstall from "../../_snippets/cli-check-install.mdx"; The IOTA CLI `client` command provides command-level access to interact with the IOTA network. Typical uses for `iota client` include publishing Move smart contracts, getting the information of an object, executing transactions, or managing addresses. @@ -80,20 +79,18 @@ Use the `iota client envs` command to find the network environments set up in th ╭────────┬─────────────────────────────────────┬────────╮ │ alias │ url │ active │ ├────────┼─────────────────────────────────────┼────────┤ -│ devnet │ https://fullnode.devnet.iota.io:443 │ * │ +│ devnet │ https://api.devnet.iota.cafe:443 │ * │ ╰────────┴─────────────────────────────────────┴────────╯ ``` - - ### Create network environment Use `client new-env` to add details for a new network environment. This example creates an environment pointer to IOTA Mainnet. Setting the `alias` value makes referencing the environment less prone to typographical errors. After running this command, IOTA updates your client.yaml file in `~/.iota/iota_config` with the new information. ``` -$ iota client new-env --alias=mainnet --rpc https://fullnode.mainnet.iota.io:443 +$ iota client new-env --alias=testnet --rpc https://api.testnet.iota.cafe:443 -Added new IOTA env [mainnet] to config. +Added new IOTA env [testnet] to config. ``` ### Set current environment @@ -101,9 +98,9 @@ Added new IOTA env [mainnet] to config. Use the `iota client switch` command to change the current network. This example switches the current network to `mainnet`. ```shell -$ iota client switch --env mainnet +$ iota client switch --env testnet -Active environment switched to [mainnet] +Active environment switched to [testnet] ``` If you run `iota client envs` after this command, you see the asterisk in the `active` column on the `mainnet` row of the table. @@ -113,16 +110,16 @@ If you run `iota client envs` after this command, you see the asterisk in the `a Use the `iota client active-address` command to reveal the current address. The CLI uses the current active address to execute address-specific CLI commands (like `iota client objects`) when you don't provide them with a IOTA address value. ```shell -$ iota client active-address +iota client active-address 0x514692f08249c3e9951234ce29074695840422564bff85e424b56de462913e0d ``` ### Request a IOTA coin from faucet -If you use one of the standard public RPCs (for example, `fullnode.testnet.iota.io:443`), you can use the `faucet` command to request gas coins. If you use a custom faucet service, then pass in the URL to the faucet using the `--url` option. +If you use one of the standard public RPCs (for example, `api.testnet.iota.cafe:443`), you can use the `faucet` command to request gas coins. If you use a custom faucet service, then pass in the URL to the faucet using the `--url` option. ```shell -$ iota client faucet +iota client faucet Request successful. It can take up to 1 minute to get the coin. Run iota client gas to check your gas coins. ``` diff --git a/docs/content/references/cli/console.mdx b/docs/content/references/cli/console.mdx index 52b9ef9f7c6..af0f5272b7c 100644 --- a/docs/content/references/cli/console.mdx +++ b/docs/content/references/cli/console.mdx @@ -27,7 +27,7 @@ Active address: 0x3...235 Keystore Type: File Keystore Path: Some("/Users/user/.iota/iota_config/iota.keystore") Active environment: testnet -RPC URL: https://fullnode.testnet.iota.io:443 +RPC URL: https://api.testnet.iota.cafe:443 Connecting to IOTA full node. API version 1.13.0 Available RPC methods: ["iota_devInspectTransactionBlock", "iota_dryRunTransactionBlock", "iota_executeTransactionBlock", diff --git a/docs/content/references/cli/validator.mdx b/docs/content/references/cli/validator.mdx index 9c80b24227e..7668dd53c0c 100644 --- a/docs/content/references/cli/validator.mdx +++ b/docs/content/references/cli/validator.mdx @@ -169,13 +169,13 @@ $ iota validator display-metadata 0x8359fff1dc629bad933cf1781564a6d98a7277ac391e "networkPubkeyBytes": "1JiYHZHJFtuxim7woWhPGdBIe4QPoyvLVgpCRRZwUWg=", "protocolPubkeyBytes": "XhjH8q+isy4LP4GS1txLJYl+KQ9kV7b5dnu6C2x4XIk=", "proofOfPossessionBytes": "ovRMD5206HPBOoTfx+TgB5NXIKpbra4AuJRVGFSaaFbP2hAAZBDWpP1OD0Nyackf", - "name": "validator-2.r.iota-rebased-alphanet", - "description": "validator-2.r.iota-rebased-alphanet", + "name": "validator-2.r.iota-rebased-testnet", + "description": "validator-2.r.iota-rebased-testnet", "imageUrl": "", "projectUrl": "", - "netAddress": "/dns/validator-2.r.iota-rebased-alphanet.iota.cafe/tcp/8080/http", - "p2pAddress": "/dns/validator-2.r.iota-rebased-alphanet.iota.cafe/udp/8084", - "primaryAddress": "/dns/validator-2.r.iota-rebased-alphanet.iota.cafe/udp/8081", + "netAddress": "/dns/validator-2.r.iota-rebased-testnet.iota.cafe/tcp/8080/http", + "p2pAddress": "/dns/validator-2.r.iota-rebased-testnet.iota.cafe/udp/8084", + "primaryAddress": "/dns/validator-2.r.iota-rebased-testnet.iota.cafe/udp/8081", "nextEpochAuthorityPubkeyBytes": null, "nextEpochProofOfPossession": null, "nextEpochNetworkPubkeyBytes": null, diff --git a/docs/content/references/contribute/style-guide.mdx b/docs/content/references/contribute/style-guide.mdx index 29f27d49712..04b796051fe 100644 --- a/docs/content/references/contribute/style-guide.mdx +++ b/docs/content/references/contribute/style-guide.mdx @@ -556,7 +556,7 @@ Measurements should be written as numerals. ## Links -Always use relative links when linking to topics on docs.iota.io. +Always use relative links when linking to topics on docspnpm .iota.org. Include the `.mdx` extension when creating internal links so that they also work from the source file in GitHub. diff --git a/docs/content/references/event-query-and-subscription.mdx b/docs/content/references/event-query-and-subscription.mdx index 8bc190554b2..3390e6617d3 100644 --- a/docs/content/references/event-query-and-subscription.mdx +++ b/docs/content/references/event-query-and-subscription.mdx @@ -19,7 +19,7 @@ A IOTA node emits the following types of events: ## Move event -Move calls emit Move events. You can [define custom events](https://examples.iota.io/basics/events.html) in Move contracts. +Move calls emit Move events. You can define custom events in Move contracts. ### Attributes diff --git a/docs/content/references/exchange-integration-guide.mdx b/docs/content/references/exchange-integration-guide.mdx index 8e49be0a241..0cd4d7663f6 100644 --- a/docs/content/references/exchange-integration-guide.mdx +++ b/docs/content/references/exchange-integration-guide.mdx @@ -3,7 +3,6 @@ title: Exchange Integration Guide sidebar_label: Exchange Integration slug: /exchange-integration-guide --- -import AlphaNet from "../_snippets/alphanet.mdx"; This topic describes how to integrate IOTA, the token native to the IOTA network, into a cryptocurrency exchange. The specific requirements and processes to implement an integration vary between exchanges. Rather than provide a step-by-step guide, this topic provides information about the primary tasks necessary to complete an integration. After the guidance about how to configure an integration, you can also find information and code samples related to staking on the IOTA network. @@ -114,10 +113,8 @@ You can track balance changes by calling `iota_getBalance` at predefined interva The following bash example demonstrates how to use `iota_getBalance` for address 0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3. If you use a network other than Devnet, replace the value for `rpc` with the URL to the appropriate Full node. - - ```bash -rpc="https://fullnode.devnet.iota.io:443" +rpc="https://api.devnet.iota.cafe:443" address="0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3" data="{\"jsonrpc\": \"2.0\", \"method\": \"iota_getBalance\", \"id\": 1, \"params\": [\"$address\"]}" curl -X POST -H 'Content-type: application/json' --data-raw "$data" $rpc @@ -148,7 +145,7 @@ use iota_sdk::{IOTAClient, IOTAClientBuilder}; #[tokio::main] async fn main() -> Result<(), anyhow::Error> { let iota = IOTAClientBuilder::default().build( - "https://fullnode.devnet.iota.io:443", + "https://api.devnet.iota.cafe:443", ).await.unwrap(); let address = IOTAAddress::from_str("0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3")?; let objects = iota.read_api().get_balance(address).await?; @@ -163,7 +160,7 @@ You can also track the balance for an address by subscribing to all of the event The following example demonstrates how to filter events for an address using bash and cURL: ```bash -rpc="https://fullnode.devnet.iota.io:443" +rpc="https://api.devnet.iota.cafe:443" address="0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3" data="{\"jsonrpc\": \"2.0\", \"id\":1, \"method\": \"iota_getEvents\", \"params\": [{\"Recipient\": {\"AddressOwner\": \"0x849d63687330447431a2e76fecca4f3c10f6884ebaa9909674123c6c662612a3\"}}, null, null, true ]}" curl -X POST -H 'Content-type: application/json' --data-raw "$data" $rpc diff --git a/docs/content/references/ts-sdk/dapp-kit/index.mdx b/docs/content/references/ts-sdk/dapp-kit/index.mdx index eea63254587..bb1deb750f2 100644 --- a/docs/content/references/ts-sdk/dapp-kit/index.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/index.mdx @@ -1,5 +1,3 @@ -import AlphaNet from "../../../_snippets/alphanet.mdx"; - # Iota dApp Kit The Iota dApp Kit is a set of React components, hooks, and utilities to help you build a dApp for the @@ -30,7 +28,6 @@ To use the hooks and components in the dApp Kit, wrap your app with the provider following example. The props available on the providers are covered in more detail in their respective pages. - ```tsx import { createNetworkConfig, IotaClientProvider, WalletProvider } from '@iota/dapp-kit'; @@ -40,7 +37,7 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query'; // Config options for the networks you want to connect to const { networkConfig } = createNetworkConfig({ localnet: { url: getFullnodeUrl('localnet') }, - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }); const queryClient = new QueryClient(); diff --git a/docs/content/references/ts-sdk/dapp-kit/iota-client-provider.mdx b/docs/content/references/ts-sdk/dapp-kit/iota-client-provider.mdx index 397c7de7b2c..7bb5e400e03 100644 --- a/docs/content/references/ts-sdk/dapp-kit/iota-client-provider.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/iota-client-provider.mdx @@ -18,7 +18,7 @@ import { getFullnodeUrl } from '@iota/iota-sdk/client'; // Config options for the networks you want to connect to const { networkConfig } = createNetworkConfig({ localnet: { url: getFullnodeUrl('localnet') }, - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }); function App() { @@ -55,7 +55,7 @@ import { useState } from 'react'; // Config options for the networks you want to connect to const { networkConfig } = createNetworkConfig({ localnet: { url: getFullnodeUrl('localnet') }, - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }); function App() { @@ -86,7 +86,7 @@ import { getFullnodeUrl, IotaClient, IotaHTTPTransport } from '@iota/iota-sdk/cl // Config options for the networks you want to connect to const networks = { localnet: { url: getFullnodeUrl('localnet') }, - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, } satisfies Record; function App() { @@ -177,8 +177,8 @@ const { networkConfig, useNetworkVariable } = createNetworkConfig({ myMovePackageId: '0x123', }, }, - mainnet: { - url: getFullnodeUrl('mainnet'), + testnet: { + url: getFullnodeUrl('testnet'), variables: { myMovePackageId: '0x456', }, diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAccounts.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAccounts.mdx index 67d7627cb3b..b0a190c82e9 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAccounts.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAccounts.mdx @@ -10,7 +10,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet.mdx index 483a2f63747..6b5596dfffc 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet.mdx @@ -10,7 +10,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet.mdx index 5cf295496e1..1bd679a75e7 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet.mdx @@ -10,7 +10,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount.mdx index 3854a29d55a..db1cdf7a0de 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount.mdx @@ -10,7 +10,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet.mdx index 9f0128f9f1b..0c2c7996434 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet.mdx @@ -11,7 +11,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet.mdx index 8dc197a0787..dedf7ba93d9 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet.mdx @@ -11,7 +11,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock.mdx index e470ad466ad..d57407b8607 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock.mdx @@ -11,7 +11,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage.mdx index b0c8ed8a2ee..63fa0de140f 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage.mdx @@ -10,7 +10,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock.mdx index 5dcbf45a903..f0f9f82b441 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock.mdx @@ -11,7 +11,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount.mdx index dacd67ebddc..9abe519bad5 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount.mdx @@ -10,7 +10,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useWallets.mdx b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useWallets.mdx index 7a23f9fb686..67159b7c55a 100644 --- a/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useWallets.mdx +++ b/docs/content/references/ts-sdk/dapp-kit/wallet-hooks/useWallets.mdx @@ -11,7 +11,7 @@ function withProviders( // Work around server-side pre-rendering const queryClient = new QueryClient(); const networks = { - mainnet: { url: getFullnodeUrl('mainnet') }, + testnet: { url: getFullnodeUrl('testnet') }, }; return () => { diff --git a/docs/content/references/ts-sdk/kiosk/advanced-examples.mdx b/docs/content/references/ts-sdk/kiosk/advanced-examples.mdx index 4a5006f01fb..329e5816c13 100644 --- a/docs/content/references/ts-sdk/kiosk/advanced-examples.mdx +++ b/docs/content/references/ts-sdk/kiosk/advanced-examples.mdx @@ -1,10 +1,7 @@ -import AlphaNet from "../../../_snippets/alphanet.mdx"; - # Some extended examples For these examples, assume you have the following data and functions available: - ```typescript // a constant for my type. @@ -15,9 +12,9 @@ const otherType = `${packageId}::other_module::OtherStruct<${packageId}::other_c // initialize a kioskClient. const kioskClient = new KioskClient({ client: new IotaClient({ - url: getFullnodeUrl('mainnet'), + url: getFullnodeUrl('testnet'), }), - network: Network.MAINNET, + network: Network.TESTNET, }); ``` diff --git a/docs/content/references/ts-sdk/kiosk/from-v1.mdx b/docs/content/references/ts-sdk/kiosk/from-v1.mdx index 3e697ce97ee..1ca2a06d3cf 100644 --- a/docs/content/references/ts-sdk/kiosk/from-v1.mdx +++ b/docs/content/references/ts-sdk/kiosk/from-v1.mdx @@ -47,9 +47,9 @@ Using the new SDK, you can build the same transaction as follows: /// You need to do this only once and re-use it in the application. const kioskClient = new KioskClient({ client: new IotaClient({ - url: getFullnodeUrl('mainnet'), + url: getFullnodeUrl('testnet'), }), - network: Network.MAINNET, + network: Network.TESTNET, }); const placeAndListToKiosk = async () => { @@ -102,9 +102,9 @@ Using the new SDK, you can build the same transaction as follows: /// You need to do this only once and re-use it in the application. const kioskClient = new KioskClient({ client: new IotaClient({ - url: getFullnodeUrl('mainnet'), + url: getFullnodeUrl('testnet'), }), - network: Network.MAINNET, + network: Network.TESTNET, }); const placeAndListToKiosk = async () => { @@ -129,7 +129,7 @@ import { queryTransferPolicy, purchaseAndResolvePolicies, place, testnetEnvironm import { IotaClient } from '@iota/iota-sdk/client'; const client = new IotaClient( - url: 'https://fullnode.testnet.iota.io:443', + url: 'https://api.testnet.iota.cafe:443', ); // The kiosk we're purchasing from. @@ -192,9 +192,9 @@ Using the new SDK, you can build the same transaction as follows: /// You need to do this only once and re-use it in the application. const kioskClient = new KioskClient({ client: new IotaClient({ - url: getFullnodeUrl('mainnet'), + url: getFullnodeUrl('testnet'), }), - network: Network.MAINNET, + network: Network.TESTNET, }); // An Item as returned from `kioskClient.getKiosk()` call. @@ -288,9 +288,9 @@ On the new SDK, the same transaction can be built as follows: /// You need to do this only once and re-use it in the application. const kioskClient = new KioskClient({ client: new IotaClient({ - url: getFullnodeUrl('mainnet'), + url: getFullnodeUrl('testnet'), }), - network: Network.MAINNET, + network: Network.TESTNET, }); const adjustPolicy = async () => { diff --git a/docs/content/references/ts-sdk/kiosk/kiosk-client/introduction.mdx b/docs/content/references/ts-sdk/kiosk/kiosk-client/introduction.mdx index 4039ef2ceee..73bea1b8fce 100644 --- a/docs/content/references/ts-sdk/kiosk/kiosk-client/introduction.mdx +++ b/docs/content/references/ts-sdk/kiosk/kiosk-client/introduction.mdx @@ -1,5 +1,3 @@ -import AlphaNet from "../../../../_snippets/alphanet.mdx"; - # Kiosk Client Kiosk Client is the base for all Kiosk SDK functionality. @@ -15,7 +13,6 @@ You can follow the example to create a `KioskClient`. The client currently suppo _IOTA Kiosk rules and extensions are not supported in Devnet due to network wipes (that would require constantly changing the package IDs)._ - ```typescript import { KioskClient, Network } from '@iota/kiosk'; diff --git a/docs/content/references/ts-sdk/typescript/cryptography/keypairs.mdx b/docs/content/references/ts-sdk/typescript/cryptography/keypairs.mdx index f25254186ef..77b6cdcb42d 100644 --- a/docs/content/references/ts-sdk/typescript/cryptography/keypairs.mdx +++ b/docs/content/references/ts-sdk/typescript/cryptography/keypairs.mdx @@ -1,9 +1,5 @@ -import AlphaNet from "../../../../_snippets/alphanet.mdx"; - # Key pairs - - The IOTA TypeScript SDK provides `Keypair` classes that handle logic for signing and verification using the cryptographic key pairs associated with a IOTA address. @@ -136,7 +132,7 @@ import { verifyPersonalMessageSignature } from '@iota/iota-sdk/verify'; const publicKey = await verifyPersonalMessageSignature(message, zkSignature, { client: new IotaGraphQLClient({ - url: 'https://iota-testnet.iota.org/graphql', + url: 'https://graphql.testnet.iota.cafe', }), }); ``` diff --git a/docs/content/references/ts-sdk/typescript/hello-iota.mdx b/docs/content/references/ts-sdk/typescript/hello-iota.mdx index 87d90f88986..cb0e4b79acc 100644 --- a/docs/content/references/ts-sdk/typescript/hello-iota.mdx +++ b/docs/content/references/ts-sdk/typescript/hello-iota.mdx @@ -1,5 +1,4 @@ import Faucet from '@site/../content/_snippets/faucet.mdx'; -import AlphaNet from "../../../_snippets/alphanet.mdx"; # Hello IOTA @@ -52,8 +51,6 @@ address. You must be on Devnet, Testnet, or a local network to use a faucet for Create a new `index.js` file in the root of your project with the following code. - - ```js import { getFullnodeUrl, IotaClient } from '@iota/iota-sdk/client'; import { getFaucetHost, requestIotaFromFaucetv1 } from '@iota/iota-sdk/faucet'; diff --git a/docs/content/references/ts-sdk/typescript/index.mdx b/docs/content/references/ts-sdk/typescript/index.mdx index 888ce108894..5311b2a0349 100644 --- a/docs/content/references/ts-sdk/typescript/index.mdx +++ b/docs/content/references/ts-sdk/typescript/index.mdx @@ -1,4 +1,5 @@ -import AlphaNet from "../../../_snippets/alphanet.mdx"; +import NetworkInfo from "@site/src/components/NetworkInfo/index.tsx"; +import { Networks } from '@site/src/components/constant.tsx'; # IOTA TypeScript SDK Quick Start @@ -13,21 +14,26 @@ npm i @iota/iota-sdk ## Network locations - - The following table lists the locations for IOTA networks. -| Network | Full node | faucet | -| ------- | ------------------------------------- | ------------------------------------- | -| local | `http://127.0.0.1:9000` (default) | `http://127.0.0.1:9123/gas` (default) | -| Devnet | `https://fullnode.devnet.iota.io:443` | `https://faucet.iota-rebased-alphanet.iota.cafe/gas` | -| Testnet | - | - | -| Mainnet | - | - | +## IOTA Testnet + + + +## IOTA Devnet + + + +## IOTA Localnet + +To create a local IOTA network, you can refer to [Local Development](/developer/getting-started/local-network) page. + + :::warning Use dedicated nodes/shared services rather than public endpoints for production apps. The public -endpoints maintained by the IOTA Foundation (`fullnode..iota.io:443`) are rate-limited, and support +endpoints maintained by the IOTA Foundation (`api..iota.cafe:443`) are rate-limited, and support only 100 requests per 30 seconds or so. Do not use public endpoints in production applications with high traffic volume. diff --git a/docs/content/references/ts-sdk/typescript/iota-client.mdx b/docs/content/references/ts-sdk/typescript/iota-client.mdx index 3f5dc887c62..1a4210cdc33 100644 --- a/docs/content/references/ts-sdk/typescript/iota-client.mdx +++ b/docs/content/references/ts-sdk/typescript/iota-client.mdx @@ -95,7 +95,7 @@ import { WebSocket } from 'ws'; new IotaClient({ transport: new IotaHTTPTransport({ - url: getFullnodeUrl('mainnet'), + url: getFullnodeUrl('testnet'), // The typescript definitions may not match perfectly, casting to never avoids these minor incompatibilities WebSocketConstructor: WebSocket as never, }), diff --git a/docs/content/references/ts-sdk/typescript/owned-object-pool/examples.mdx b/docs/content/references/ts-sdk/typescript/owned-object-pool/examples.mdx index 3c574f20e89..1e96b495007 100644 --- a/docs/content/references/ts-sdk/typescript/owned-object-pool/examples.mdx +++ b/docs/content/references/ts-sdk/typescript/owned-object-pool/examples.mdx @@ -1,5 +1,4 @@ import Beta from '@site/../content/_snippets/iota-oop-beta.mdx' -import AlphaNet from "../../../../_snippets/alphanet.mdx"; # End-to-End Examples @@ -27,15 +26,13 @@ account's coins. Here is the code that creates the coins by splitting a single coin 20 times and transferring the new coins to your address: - - ```ts import { IotaClient } from '@iota/iota-sdk/client/'; import type { IotaObjectRef, IotaObjectResponse } from '@iota/iota-sdk/client/'; import { Transaction } from '@iota/iota-sdk/transactions'; const client = new IotaClient({ - url: 'https://fullnode.testnet.iota.io:443', + url: 'https://api.testnet.iota.cafe:443', }); const objectId: string = ''; // A diff --git a/docs/content/references/ts-sdk/typescript/owned-object-pool/local-development.mdx b/docs/content/references/ts-sdk/typescript/owned-object-pool/local-development.mdx index e6c9e9fd290..aec12c0308d 100644 --- a/docs/content/references/ts-sdk/typescript/owned-object-pool/local-development.mdx +++ b/docs/content/references/ts-sdk/typescript/owned-object-pool/local-development.mdx @@ -74,7 +74,7 @@ TEST_USER_SECRET= ... NFT_APP_PACKAGE_ID= ... NFT_APP_ADMIN_CAP= ... -# Example: "https://fullnode.testnet.iota.io:443" +# Example: "https://api.testnet.iota.cafe:443" IOTA_NODE= ... GET_WORKER_TIMEOUT_MS=1000 diff --git a/docs/examples/move/ctf/README.md b/docs/examples/move/ctf/README.md index 700e6412b6f..0912c0fe00b 100644 --- a/docs/examples/move/ctf/README.md +++ b/docs/examples/move/ctf/README.md @@ -2,7 +2,7 @@ ## Trying the Challenges -The challneges are already deployed on the IOTA alphanet. To get started, you need to start with reading the [CTF introduction](../../docs/content/developer/iota-move-ctf/introduction.mdx), follow its steps to interact with the challenges, and capture the flags. +The challenges are already deployed on the IOTA Testnet. To get started, you need to start with reading the [CTF introduction](../../docs/content/developer/iota-move-ctf/introduction.mdx), follow its steps to interact with the challenges, and capture the flags. ## Deploying the challneges yourself (Not Required) diff --git a/docs/site/docusaurus.config.js b/docs/site/docusaurus.config.js index ff0affda9ff..a789f2b0a80 100644 --- a/docs/site/docusaurus.config.js +++ b/docs/site/docusaurus.config.js @@ -18,7 +18,7 @@ const config = { favicon: "/icons/favicon.ico", // Set the production url of your site here - url: "https://docs.iota.io", + url: "https://docs.iota.org", // Set the // pathname under which your site is served // For GitHub pages deployment, it is often '//' baseUrl: "/", diff --git a/docs/site/src/components/API/api-ref/networkselect.js b/docs/site/src/components/API/api-ref/networkselect.js index f1918387e41..8132c3e125d 100644 --- a/docs/site/src/components/API/api-ref/networkselect.js +++ b/docs/site/src/components/API/api-ref/networkselect.js @@ -7,18 +7,18 @@ import ExecutionEnvironment from "@docusaurus/ExecutionEnvironment"; import { Select, MenuItem, FormControl, InputLabel } from "@mui/material"; import { StyledEngineProvider } from "@mui/material/styles"; -const NETWORKS = ["Devnet", "Testnet", "Mainnet"]; +const NETWORKS = ["Devnet", "Testnet"]; const NetworkSelect = () => { const [selection, setSelection] = useState(() => { if (ExecutionEnvironment.canUseDOM) { const network = localStorage.getItem("RPC"); if (network === null) { - return "mainnet"; + return "testnet"; } return localStorage.getItem("RPC"); } else { - return "mainnet"; + return "testnet"; } }); @@ -38,18 +38,18 @@ const NetworkSelect = () => { {`RPC: https://fullnode.${selection.toLowerCase()}.iota.io:443`} + >{`RPC: https://api.${selection.toLowerCase()}.iota.cafe:443`} diff --git a/docs/site/src/components/CTF/ctf-verifier.tsx b/docs/site/src/components/CTF/ctf-verifier.tsx index cc25c579746..530ddf2d44f 100644 --- a/docs/site/src/components/CTF/ctf-verifier.tsx +++ b/docs/site/src/components/CTF/ctf-verifier.tsx @@ -13,8 +13,7 @@ interface ChallengeVerifierProps { // Define network configurations const NETWORKS = { - devnet: { url: getFullnodeUrl('devnet') }, - alphanet: { url: 'https://api.iota-rebased-alphanet.iota.cafe:443' }, + testnet: { url: getFullnodeUrl('testnet') }, }; // Main ChallengeVerifier component @@ -30,7 +29,7 @@ const ChallengeVerifier: React.FC = ({ expectedObjectTyp setCoins(null); try { - const client = new IotaClient({ url: NETWORKS.alphanet.url }); + const client = new IotaClient({ url: NETWORKS.testnet.url }); const result = await client.getObject({ id: inputText, options: { showType: true } }); const message = result.data.type === expectedObjectType diff --git a/docs/site/src/components/constant.tsx b/docs/site/src/components/constant.tsx index 4c5a3e40d49..7639845f062 100644 --- a/docs/site/src/components/constant.tsx +++ b/docs/site/src/components/constant.tsx @@ -166,21 +166,21 @@ export const Networks = { }, iota_move_testnet: { baseToken: 'IOTA Token (no value)', - jsonRpcUrl: 'https://api.iota-rebased-alphanet.iota.cafe', - jsonRpcWebsocketUrl:'wss://api.iota-rebased-alphanet.iota.cafe', - indexerRpc: 'https://indexer.iota-rebased-alphanet.iota.cafe', - graphqlRpc: 'https://graphql.iota-rebased-alphanet.iota.cafe', - faucetUrl: 'https://api.iota-rebased-alphanet.iota.cafe/gas', - explorerUrl: 'https://explorer.iota.cafe/?network=alphanet' + jsonRpcUrl: 'https://api.testnet.iota.cafe', + jsonRpcWebsocketUrl:'wss://api.testnet.iota.cafe', + indexerRpc: 'https://indexer.testnet.iota.cafe', + graphqlRpc: 'https://graphql.testnet.iota.cafe', + faucetUrl: 'https://faucet.testnet.iota.cafe', + explorerUrl: 'https://explorer.iota.cafe/?network=testnet' }, iota_move_devnet: { baseToken: 'IOTA Token (no value)', - jsonRpcUrl: 'jsonRpcUrl placeholder', - jsonRpcWebsocketUrl:'jsonRpcWebsocketUrl placeholder', - indexerRpc: 'indexerRpc placeholder', - graphqlRpc: 'graphqlRpc placeholder', - faucetUrl: 'faucetUrl placeholder', - explorerUrl: 'explorerUrl placeholder' + jsonRpcUrl: 'https://api.devnet.iota.cafe', + jsonRpcWebsocketUrl:'wss://api.devnet.iota.cafe', + indexerRpc: 'https://indexer.devnet.iota.cafe', + graphqlRpc: 'https://graphql.devnet.iota.cafe', + faucetUrl: 'https://faucet.devnet.iota.cafe', + explorerUrl: 'https://explorer.iota.cafe/?network=devnet' }, iota_localnet: { baseToken:"IOTA Token", diff --git a/docs/site/src/pages/index.js b/docs/site/src/pages/index.js index 8a5c6126658..ba011c0c546 100644 --- a/docs/site/src/pages/index.js +++ b/docs/site/src/pages/index.js @@ -152,7 +152,7 @@ export default function Home() { > IOTA ecosystem directory - + IOTA blog { } // Download Mainnet OpenRPC spec -downloadFile("mainnet"); +// downloadFile("mainnet"); // Download Testnet OpenRPC spec downloadFile("testnet");