Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed docs/build/images/emerald/oasisscan2.png
Binary file not shown.
18 changes: 0 additions & 18 deletions docs/build/tools/other-paratimes/cipher/network.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,31 +28,13 @@ one of the public endpoints below (in alphabetic order):

## Block Explorers

| Name/Provider | Mainnet URL | Testnet URL | EIP-3091 compatible |
|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|
| Oasis Scan ([Bit Cat]) | [https://www.oasisscan.com/paratimes/000…7cb](https://www.oasisscan.com/paratimes/000000000000000000000000000000000000000000000000e199119c992377cb) | [https://testnet.oasisscan.com/paratimes/000…000](https://testnet.oasisscan.com/paratimes/0000000000000000000000000000000000000000000000000000000000000000) | No |

[Bit Cat]: https://www.bitcat365.com/

:::tip

Only rudimentary block explorer features exist for Cipher. Consider debugging
Cipher transactions with the [`oasis paratime show`] command using the
[Oasis CLI].

:::

[`oasis paratime show`]: ../../../../build/tools/cli/paratime.md#show
[Oasis CLI]: ../../../../build/tools/cli/README.md

## Indexers

| Name (Provider) | Mainnet URL | Testnet URL | Documentation |
|------------------------|----------------------------------------|----------------------------------------|-------------------------------|
| Oasis Scan ([Bit Cat]) | `https://api.oasisscan.com/v2/mainnet` | `https://api.oasisscan.com/v2/testnet` | [Runtime API][OasisScan-docs] |

[OasisScan-docs]: https://api.oasisscan.com/v2/swagger/#/runtime

:::note

If you are running your own Cipher endpoint, a block explorer, or an indexer
Expand Down
5 changes: 0 additions & 5 deletions docs/build/tools/other-paratimes/emerald/network.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -59,23 +59,18 @@ dedicated RPC endpoints, consider the following providers (in alphabetic order):
| Name/Provider | Mainnet URL | Testnet URL | EIP-3091 compatible |
|-----------------------------|-------------------------------------------|-------------------------------------------|---------------------|
| [Oasis Explorer][Oasis] | `https://explorer.oasis.io/mainnet/emerald` | `https://explorer.oasis.io/testnet/emerald` | Yes |
| Oasis Scan ([Bit Cat]) | [https://www.oasisscan.com/paratimes/000…87f](https://www.oasisscan.com/paratimes/000000000000000000000000000000000000000000000000e2eaa99fc008f87f) | [https://testnet.oasisscan.com/paratimes/000…ca7](https://testnet.oasisscan.com/paratimes/00000000000000000000000000000000000000000000000072c8215e60d5bca7) | No |

[Bit Cat]: https://www.bitcat365.com/

## Indexers

| Name (Provider) | Mainnet URL | Testnet URL | Documentation |
|-------------------------------------------|-------------------------------------------------------|--------------------------------------|-------------------|
| [Covalent] | `https://api.covalenthq.com/v1/oasis-emerald-mainnet` | *N/A* | [Unified API docs][Covalent-docs] |
| Oasis Nexus ([Oasis]) | `https://nexus.oasis.io/v1/` | `https://testnet.nexus.oasis.io/v1/` | [API][Nexus-docs] |
| Oasis Scan ([Bit Cat]) | `https://api.oasisscan.com/v2/mainnet` | `https://api.oasisscan.com/v2/testnet` | [Runtime API][OasisScan-docs] |
| [SubQuery Network][SubQuery] | *N/A* | *N/A* | [SubQuery Academy][SubQuery-docs], [QuickStart][SubQuery-quickstart], [Starter project][SubQuery-starter] |

[Covalent]: https://www.covalenthq.com/
[Covalent-docs]: https://www.covalenthq.com/docs/unified-api/
[Nexus-docs]: https://nexus.oasis.io/v1/spec/v1.html
[OasisScan-docs]: https://api.oasisscan.com/v2/swagger/#/runtime
[SubQuery]: https://subquery.network
[SubQuery-docs]: https://academy.subquery.network/
[SubQuery-quickstart]: https://academy.subquery.network/quickstart/quickstart.html
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -278,18 +278,7 @@ transaction being included in the block.
If you are using Testnet or Mainnet, try to debug your transaction by finding
it on the Emerald block explorer ([Mainnet][mainnet-explorer], [Testnet][testnet-explorer]):

![Emerald block explorer showing a failed transaction](../../../images/emerald/oasisscan1.png)

In some cases, the transaction result on Emerald block explorer might be stuck
at `Error: (Awaiting internal transactions for reason)`. In this case or in
case of other Consensus layer ↔ ParaTime issues, try to find your Emerald
transaction on the Oasis Scan ([Mainnet][mainnet-oasisscan],
[Testnet][testnet-oasisscan]) which is primarily a Consensus layer explorer, but
offers some introspection into ParaTime transactions as well. Once you find your
failed Emerald transaction, the `Status` field should contain a more verbose
error description, for example:

![Oasis Scan showing the Out of gas error for a transaction on Emerald](../../../images/emerald/oasisscan2.png)
![Emerald block explorer showing a failed transaction](../../../images/emerald/emerald-explorer-tx.png)

## See also

Expand All @@ -299,5 +288,3 @@ error description, for example:

[mainnet-explorer]: https://explorer.oasis.io/mainnet/emerald
[testnet-explorer]: https://explorer.oasis.io/testnet/emerald
[mainnet-oasisscan]: https://oasisscan.com
[testnet-oasisscan]: https://testnet.oasisscan.com
20 changes: 11 additions & 9 deletions docs/build/tools/other-paratimes/network.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,25 +41,27 @@ Public gRPC endpoints (in alphabetic order):
| Name (Provider) | Mainnet URL | Testnet URL |
|--------------------------|-----------------------------------------------|---------------------------------------------|
| Oasis Explorer ([Oasis]) | https://explorer.oasis.io/mainnet/consensus | https://explorer.oasis.io/testnet/consensus |
| Oasis Scan ([Bit Cat]) | https://www.oasisscan.com | https://testnet.oasisscan.com |

[Bit Cat]: https://www.bitcat365.com/

## Indexers

| Name (Provider) | Mainnet URL | Testnet URL | Documentation |
|------------------------|----------------------------------------|----------------------------------------|--------------------------------------------|
| Oasis Nexus ([Oasis]) | `https://nexus.oasis.io/v1` | `https://testnet.nexus.oasis.io/v1` | [API][Nexus-docs] |
| Oasis Scan ([Bit Cat]) | `https://api.oasisscan.com/v2/mainnet` | `https://api.oasisscan.com/v2/testnet` | [API][OasisScan-docs] |

[Nexus-docs]: https://nexus.oasis.io/v1/spec/v1.html
[OasisScan-docs]: https://api.oasisscan.com/v2/swagger/

## Rosetta Endpoints

| Provider | Mainnet URL | Testnet URL |
|----------|-------------------------------------------|-------------------------------------------|
| [Oasis] | `https://rosetta.oasis.io/api/mainnet/v1` | `https://rosetta.oasis.io/api/testnet/v1` |
| Provider | Mainnet URL | Testnet URL |
|----------|-------------------------------|---------------------------------------|
| [Oasis] | `https://rosetta.oasis.io/v1` | `https://testnet.rosetta.oasis.io/v1` |

:::info

The previous URLs, `https://rosetta.oasis.io/api/mainnet/v1` and
`https://rosetta.oasis.io/api/testnet/v1`, keep working and need no change.

:::

:::note

Expand All @@ -69,4 +71,4 @@ issue at [github.com/oasisprotocol/docs].

:::

[github.com/oasisprotocol/docs]: https://github.com/oasisprotocol/docs/issues
[github.com/oasisprotocol/docs]: https://github.com/oasisprotocol/docs/issues
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
35 changes: 12 additions & 23 deletions docs/general/manage-tokens/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -259,35 +259,24 @@ schemes and compatible wallets.
## Check your account

To check the balance of your consensus account, you can use the
[Oasis Scan](https://www.oasisscan.com) block explorer. Enter your `oasis1`
address at the top and hit enter. For example:
[Oasis Explorer](https://explorer.oasis.io/mainnet/consensus) block explorer.
Enter your `oasis1` address in the search field at the top and hit enter.

![Account details of entered oasis1 address in Oasis Scan](../images/manage-tokens/oasisscan_account_details.png)
The total balance is a sum of three values:

The "Amount" is a sum of three values:
- the available tokens that can immediately be transferred,
- the staked (escrowed) tokens that are delegated,
- the debonding tokens that are waiting for the debonding period to pass.

- the "Available" tokens that can immediately be transferred,
- the "Escrow" tokens that are delegated,
- the "Reclaim" tokens that are waiting for the debonding period to pass.

To check the account's deposits and withdrawals navigate to "Transactions" pane
and press "ParaTime" on the right side, next to the "Consensus" button.
You will see all ParaTime-related transactions including deposits, withdrawals,
transfers and even smart contract transactions.

![Search result of oasis1 address - Account details](../images/manage-tokens/oasisscan_paratime_txes.png)

Furthermore, you can view the transaction details, if you click on a
transaction's "Tx Hash". Among others, you will see the transaction type, the
"from", "to" and "amount" fields.

![Tx Hash - Transaction details](../images/manage-tokens/oasisscan_paratime_tx_details.png)
The account's transactions include deposits, withdrawals and transfers.
You can view the details of a specific transaction by clicking on its hash.
Among others, you will see the transaction type, the "from", "to" and "amount"
fields.

:::info

Be aware that the [Oasis Scan Blockchain Explorer](https://www.oasisscan.com)
is built for consensus layer. If you want to explore Sapphire (0x addresses,
Token Transfers, Contract Calls, etc.), you have to use the
If you want to explore Sapphire (`0x` addresses, token transfers, contract
calls, etc.), use the
[Sapphire Blockchain Explorer](https://explorer.oasis.io/mainnet/sapphire).

:::
Expand Down
3 changes: 2 additions & 1 deletion docs/general/manage-tokens/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -459,7 +459,8 @@ Withdrawals from Emerald are slightly different from regular `staking.Transfer`
transactions used to send ROSE on the consensus layer. If you withdrew your
ROSE directly to an exchange and you were not funded there, contact the
exchange support and provide them the link to your account on the
[Oasis Scan](https://www.oasisscan.com) where they can verify all transactions.
[Oasis Explorer](https://explorer.oasis.io/mainnet/consensus) where they can
verify all transactions.
To learn more about this issue, read the [Manage tokens](README.mdx) chapter.

### Error when accessing Ledger on Linux
Expand Down
6 changes: 2 additions & 4 deletions docs/general/manage-tokens/staking-and-delegating.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,7 @@ ParaTimes also allow you to implicitly delegate tokens from your ParaTime
account.

Check out the current validator set, their escrow of staked tokens, the
commission rate, and the availability in the [Oasis Scan explorer][explorer-validators].

![The validator set in the morning of March 29, 2024](../images/manage-tokens/oasisscan_validators.png)
commission rate, and the availability in the [Oasis Explorer][explorer-validators].

:::info

Expand Down Expand Up @@ -83,7 +81,7 @@ Some custody providers may also allow delegation of your tokens. Check out the
:::

[check-account]: ./README.mdx#check-your-account
[explorer-validators]: https://www.oasisscan.com/validators
[explorer-validators]: https://explorer.oasis.io/mainnet/consensus/validators

## Become a validator yourself?

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ For more details, see its [Delegation Policy](../../get-involved/delegation-poli

* **Mar 27, 2024:**
* Updated Staking Rewards Schedule after the
[governance proposal #4](https://www.oasisscan.com/proposals/4) passed (Mar
[governance proposal #4](https://explorer.oasis.io/mainnet/consensus/proposal/4) passed (Mar
27, 2024) which changed the staking rewards schedule.
* **Nov 2, 2023:**
* Improve epoch duration estimates inside Staking Rewards Schedule chart after Damask Upgrade.
Expand Down
4 changes: 2 additions & 2 deletions docs/node/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Consensus layer is a decentralised set of 120 validator nodes that are a
backbone of the Oasis Network. The current validator set size is determined by
governance - the network started with 80 nodes in the validator set in 2020 and
has expanded to 120 nodes over the past few network upgrades. Current node
operators can be seen on a block explorer such as [Oasis Scan].
operators can be seen on a block explorer such as the [Oasis Explorer].

:::

Expand All @@ -55,7 +55,7 @@ node operator you can participate in any number of ParaTimes.
:::

[Oasis Network]: ../general/oasis-network/README.mdx
[Oasis Scan]: https://www.oasisscan.com/validators
[Oasis Explorer]: https://explorer.oasis.io/mainnet/consensus/validators

## DApp Developers

Expand Down
2 changes: 1 addition & 1 deletion docs/node/reference/upgrades/mainnet-upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,4 +75,4 @@ The Oasis team will be offering live video support during the launch of Mainnet.

For any additional support, please reach out via the [**#node-operators** channel at the Oasis Network Community server on Discord](../../../get-involved/README.md) with your questions, comments, and feedback related to Mainnet.

To follow the network, please use one of the many community block explorers including [oasisscan.com](https://www.oasisscan.com/).
To follow the network, please use one of the many community block explorers including [explorer.oasis.io](https://explorer.oasis.io/).
14 changes: 8 additions & 6 deletions docs/node/run-your-node/advanced/sync-node-using-state-sync.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,15 +128,14 @@ fetch and compare data from multiple sources.

#### Block Explorers

Browse to one of our block explorers (e.g. [Oasis Explorer], [Oasis Scan]) and
obtain the trusted height and hash there:
Browse to one of our block explorers (e.g. [Oasis Explorer]) and obtain the
trusted height and hash there:

1. Obtain the block height (10 days old) from the main page, e.g. 4819139.
2. Click on block height's number to view the block's details and obtain its
hash, e.g. `377520acaf7b8011b95686b548504a973aa414abba2db070b6a85725dec7bd21`.

[Oasis Explorer]: https://explorer.oasis.io/
[Oasis Scan]: https://www.oasisscan.com

#### A Trusted Node

Expand Down Expand Up @@ -176,10 +175,13 @@ First obtain the network's Genesis document's hash (e.g. from the Networks Param
- [Testnet](https://docs.oasis.io/node/testnet/): `0b91b8e4e44b2003a7c5e23ddadb5e14ef5345c0ebcb3ddcae07fa2f244cab76`

Query our public Rosetta Gateway instance and obtain the latest height by
replacing the `<chain-context>` with the value obtained in the previous step:
replacing the `<chain-context>` with the value obtained in the previous step.
The examples below use the Mainnet gateway; for Testnet, replace
`https://rosetta.oasis.io/v1` with `https://testnet.rosetta.oasis.io/v1`, since
each gateway only serves its own network:

```bash
curl -X POST https://rosetta.oasis.io/api/block \
curl -X POST https://rosetta.oasis.io/v1/block \
-H "Content-Type: application/json" \
-d '{
"network_identifier": {
Expand Down Expand Up @@ -210,7 +212,7 @@ Assuming blocks happen every 6 seconds, subtract around `140_000` blocks to
get the height that is around 10 days old and query again:

```bash
curl -X POST https://rosetta.oasis.io/api/block \
curl -X POST https://rosetta.oasis.io/v1/block \
-H "Content-Type: application/json" \
-d '{
"network_identifier": {
Expand Down
7 changes: 2 additions & 5 deletions docs/node/run-your-node/prerequisites/stake-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
:::tip

To check the balance of your account, use one of the blockchain explorers like
the [Oasis Explorer], [Oasis Scan] or the [`oasis account show`] command part
the [Oasis Explorer] or the [`oasis account show`] command part
of the Oasis CLI.

:::
Expand Down Expand Up @@ -35,8 +35,7 @@ TEST tokens by using our [Oasis Network Testnet Faucet][faucet-testnet]. For
more tokens please contact us on our official [Discord in the #testnet channel][discord].

[^member]: You can check the current top validators on the blockchain explorers
like the [Oasis Explorer][oasis-explorer-validators],
[Oasis Scan][oasis-scan-validators] or by running
like the [Oasis Explorer][oasis-explorer-validators] or by running
[`oasis network show validators`].

[^compute-node]: You can fetch the latest ParaTime-specific stake requirements
Expand Down Expand Up @@ -66,11 +65,9 @@ want to set up a working node from scratch.
[ParaTime observer node]: ../paratime-observer-node.mdx

[Oasis Explorer]: https://explorer.oasis.io/mainnet/consensus
[Oasis Scan]: https://www.oasisscan.com
[`oasis account show`]: ../../../build/tools/cli/account.md#show
[`oasis network show native-token`]: ../../../build/tools/cli/network.md#show-native-token
[oasis-explorer-validators]: https://explorer.oasis.io/mainnet/consensus/validators
[oasis-scan-validators]: https://www.oasisscan.com/validators
[`oasis network show validators`]: ../../../build/tools/cli/network.md#show-validators
[`oasis network show parameters`]: ../../../build/tools/cli/network.md#show-parameters
[Delegation Policy]: ../../../get-involved/delegation-policy.md
Expand Down
6 changes: 3 additions & 3 deletions docs/node/run-your-node/validator-node.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -460,12 +460,12 @@ For the final touch, you can add some metadata about your entity to the
[Metadata Registry]. The Metadata Registry is the same for Mainnet and
the Testnet. The metadata consists of your entity name, email, Keybase handle,
Twitter handle, etc. This information is also used by various applications.
For example the [ROSE Wallet - Web] and the [Oasis Scan] will fetch and show
the node operator's name and the avatar.
For example the [ROSE Wallet - Web] and the [Oasis Explorer] will fetch and
show the node operator's name and the avatar.

[Metadata Registry]: https://github.com/oasisprotocol/metadata-registry
[ROSE Wallet - Web]: https://wallet.oasis.io
[Oasis Scan]: https://www.oasisscan.com/validators
[Oasis Explorer]: https://explorer.oasis.io/mainnet/consensus/validators

# See also

Expand Down
Loading