Skip to content

Added "FAQ" page (CD-67) #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: dev
Choose a base branch
from
Open
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
7 changes: 7 additions & 0 deletions config/theme.navbar.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,13 @@ module.exports = {
label: "Casper 2.0",
position: "right",
},
{
type: "docSidebar",
sidebarId: "faqSidebar",
docsPluginId: 'faq',
label: "FAQ",
position: "right",
},
// {
// to: 'blog',
// label: 'Blog Articles',
Expand Down
32 changes: 32 additions & 0 deletions faq/condor.sidebar.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
/**
* Creating a sidebar enables you to:
- create an ordered group of docs
- render a sidebar for each doc of that group
- provide next/previous navigation

The sidebars can be generated from the filesystem, or explicitly defined here.

Create as many sidebars as you want.
*/

// @ts-check

/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
const sidebars = {
// By default, Docusaurus generates a sidebar from the docs folder structure
//condorSidebar: [{type: 'autogenerated', dirName: '.'}],
// But you can create a sidebar manually
faqSidebar: [
'faq',
],
//
// {
// type: 'category',
// label: 'Tutorial',
// items: ['tutorial-basics/create-a-document'],
// },
// ],

};

export default sidebars;
167 changes: 167 additions & 0 deletions faq/faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,167 @@
---
title: "Casper Network - Frequently Asked Questions"
description: "Comprehensive FAQ covering Casper Network for smart contract developers, validators, operators, and users."
tags: ["Casper", "FAQ", "Validators", "Smart Contracts", "dApps", "Casper Wallet", "Node Operators"]
---

# ❓ Casper Network FAQ

This FAQ addresses common questions from smart contract developers, dApp builders, node operators, validators, and retail users within the Casper Network ecosystem. The answers aim to provide both clarity and guidance for newcomers and experienced participants in the network.

---

## 🧑‍💻 Developer & dApp FAQs

### 1. How do I install `casper-sidecar` on Ubuntu/Debian?

`casper-sidecar` is a service that allows developers to interact with the Casper network more efficiently. To install it on a Debian-based system, follow these steps:

```bash
sudo mkdir -m 0755 -p /etc/apt/keyrings/

sudo curl https://repo.casper.network/casper-repo-pubkey.gpg --output /etc/apt/keyrings/casper-repo-pubkey.gpg

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/casper-repo-pubkey.gpg] https://repo.casper.network/releases focal main" | sudo tee -a /etc/apt/sources.list.d/casper.list

sudo apt update

sudo apt install casper-sidecar
```

This sets up the public key, adds the Casper repository to your system, updates the package list, and installs the software.

---

### 2. Where can I learn about serialization of transaction payloads?

Serialization is the process of converting complex data into a format that can be transmitted or stored and reconstructed later. Casper uses specific serialization methods for deploys and payloads.

You can explore serialization concepts in the official documentation:
🔗 [Serialization – Casper Docs](https://docs.casper.network/concepts/serialization)

You can also refer to the JavaScript SDK for practical examples:
🔗 [casper-js-sdk](https://www.npmjs.com/package/casper-js-sdk)

---

### 3. What causes an "invalid deploy" when using Casper Wallet?

An "invalid deploy" error typically occurs when your system time is not synchronized with the standard internet time.

Casper's deploys include timestamps, and if the timestamp on your deploy is too far from the network's time, it will be rejected.

✅ Make sure your system clock is set to automatically sync with an NTP (Network Time Protocol) server.

---

### 4. How do I check if a transaction was successful?

Once a deploy is submitted, you can check its status via the node RPC or via explorer tools.

Look for the following field in the JSON response:

```json
result.execution_info.execution_result.Version2.error_message
```

If `error_message` is `null` or empty, it means the transaction executed successfully. If it's populated, it will provide the reason for failure.

---

### 5. Where can I find Casper 2.0 RPC schema?

The Casper 2.0 RPC schema outlines the expected structure of requests and responses when interacting with the node through JSON-RPC.

You can find it here on GitHub:
🔗 [Casper RPC Schema](https://github.com/casper-network/casper-sidecar/blob/dev/resources/test/rpc_schema.json)

This is particularly useful for tool builders and integration developers.

---

### 6. How do I migrate from Signer to Casper Wallet?

The Casper Signer is deprecated and replaced by the Casper Wallet. To migrate:

1. Export your keys from Signer.
2. Import them into the Casper Wallet.
3. Follow the guide below to complete the process:
🔗 [Migration Guide – Casper Wallet](https://www.casperwallet.io/user-guide/signer-user-start-here)

---

### 7. What are the integration endpoints for `cspr.cloud`?

These endpoints are used for developers building integrations or apps that require RPC access to the network.

🔗 [https://node.integration.cspr.cloud/](https://node.integration.cspr.cloud/)

It is recommended to use these for staging and test environments rather than production deployments.

---

## 📊 Node Operator & Validator FAQs

### 9. When is a node considered fully synced?

A node transitions through states such as `CatchUp` and `KeepUp`. When a node's `reactor_state` becomes `KeepUp`, it means it has caught up with the latest state of the blockchain and is now participating in consensus.

You can check this in the node logs or via diagnostic endpoints.

---

### 10. Where can I check staking rewards?

Use [cspr.live](https://cspr.live) to check staking rewards:

1. Navigate to your account page.
2. Click the "Staking Rewards" tab.
3. You can view detailed reward history per Era.

Example:
🔗 [Staking Rewards Example](https://cspr.live/account/02038baa714f1f45aaacb4443df31bf27a8990369c2f9d585f904ec5c5b85aeb231f)

---

## 👤 General User FAQs

### 11. What is delegation?

Delegation lets you participate in network security by staking your tokens with a validator. You don’t need to run a node. Validators share a portion of the staking rewards with their delegators, keeping a small fee (commission).

This contributes to network decentralization and rewards you with passive income.

---

### 12. How frequently are staking rewards paid?

Staking rewards are distributed every **Era** (approximately every 2 hours). It may take up to 4 hours (2 Eras) for the first rewards to show after delegation.

---

### 13. I’ve delegated my tokens but don’t see rewards?

Staking rewards are added to your current stake and may not appear immediately as spendable balance. To view them:

- Go to [cspr.live](https://cspr.live)
- Look under your validator in the “Rewards” tab

---

### 14. Is there a lock period after delegation?

There is no lock period when delegating. However, **undelegation** incurs a 7 Era (~14 hour) unbonding period. After this, the tokens are available in your account for transfer or re-delegation.

---

### 15. Is there slashing? Can I lose tokens?

Currently, Casper does **not** have slashing enabled. If a validator is evicted from the active set, you won’t receive rewards while they’re inactive. In future, when slashing is enabled, delegators may lose a portion of their stake if their validator misbehaves.

---

### 16. What is the cost of delegation and undelegation?

Each delegation transaction costs approximately **3 CSPR**.
💡 Always keep extra tokens in your account to cover fees for transactions like delegation, undelegation, and transfers.