Onboarding Oraichain eco-system

Onboarding Oraichain eco-system

🎯
A document to onboard all types of users to onboard Oraichain
  • New to Oraichain
  • Introduction to Oraichain
  • Highlights features of Oraichain
  • User guide
  • Owallet (Browser Extension)
  • Universal Swap & Swap
  • Node operators / Validators
  • Running Oraichain node & Becoming validator
  • Becoming delegator
  • Nodes operation
  • Monitoring & Alerting
  • Awesome tools
  • Developers
  • Fundamentals
  • Core blockchain
  • Smart contract developers
  • IBC Developers:
  • Fullstack Cosmos Developers
  • Recommend resources:
  • Oraichain Tools
  • Sample Oraichain productions

New to Oraichain

Introduction to Oraichain

New blockchain leveraged by CosmosSDK - https://docs.cosmos.network/v0.47/learn/intro/overview

Compare to EVM - https://zebpay.medium.com/cosmos-vs-ethereum-which-one-is-better-a23414dc4bff

Criteria
Oraichain
Ethereum
Consensus Mechanism
Proof-of-stake (PoS) and Byzantine fault tolerance (BFT)
proof-of-stake (PoS) consensus mechanism
Smart Contract Functionality
Using Cosmwasm
Using EVM
Scalability
Using Cosmos which has a modular architecture that enables easy scalability for developers.
Layer-2 solutions such as rollups
Interoperability
Oraichain is designed to be interoperable with other blockchains, enabling seamless transfers of crypto assets across different blockchains.
Limited interoperability with other blockchain networks

Highlights features of Oraichain

  • AI Oracle system - https://docs.orai.io/readme/use-cases
  • Moving assets effortlessly by IBC in cosmos ecosystem https://legacy-v2.oraidex.io/bridge
  • Moving assets effortlessly by OraiBridge (Gravity Bridge) to EVM https://legacy-v2.oraidex.io/bridge
  • UniversalSwap - https://oraidex.io/

User guide

‣

Owallet (Browser Extension)

‣

Universal Swap & Swap

Node operators / Validators

Running Oraichain node & Becoming validator

Official documents

https://docs.orai.io/developers/networks/mainnet/become-a-validator

https://github.com/oraichain/docs

This guides building nodes follow statesync & commands for creating Oraichain validators

Becoming delegator

Prerequisites

  • Has compatible Oraichain wallet & $ORAI
  • Recommend to use OWallet - https://chromewebstore.google.com/detail/owallet/hhejbopdnpbjgomhpmegemnjogflenga?pli=1

Visit https://scan.orai.io/validators & select a validator to delegate

image
  • Delegate your desired $ORAI
  • After awhile, rewards can be claimed at https://scan.orai.io/delegated-validator
image

Nodes operation

Monitoring & Alerting

https://github.com/kj89/cosmos_node_monitoring

https://github.com/PFC-developer/cosmos-exporter

Awesome tools

https://github.com/cosmos/awesome-cosmos

Developers

💡
This docs specify the learning path and how to tackling the problems depend on the role of developers

Fundamentals

Core blockchain

Cosmos SDK:

  • Anatomy of cosmosSDK: https://docs.cosmos.network/v0.47/learn/intro
  • CometBFT: https://docs.cometbft.com/v0.38/introduction/
  • Core components & understand module concept of cosmosSDK: https://docs.cosmos.network/v0.47/learn/advanced

How to build a module: https://docs.cosmos.network/v0.47/build/building-modules/intro

More tutorials:

https://tutorials.cosmos.network

Smart contract developers

Prerequisites: Rust + Javascript

VM-Cosmwasm: https://book.cosmwasm.com/

Library for deployment, interaction with Smart contract:

Cosmjs - https://github.com/cosmos/cosmjs

Practice with Oraichain ecosystem - with tools cwsimulate and cwtools commandline:

https://cw-notebook.web.app/?nb=basic

https://oraichain.notion.site/Workshop-CosmWasm-Playground-with-Simulation-Environments-f80e18e899fd45d29f59158647fc0b6b

IBC Developers:

  • Overview: https://ibc.cosmos.network/main/ibc/overview
  • Interchain Standards(ICS): https://github.com/cosmos/ibc/
  • Tutorials: https://tutorials.cosmos.network/v2-content/hands-on-exercise/5-ibc-adv/1-go-relayer.html

Fullstack Cosmos Developers

  • All knowledge about these three concepts above.

Recommend resources:

  • Awesome Cosmos
  • Archway docs
  • Awesome Cosmoswasm

Oraichain Tools

  1. cwtools

    2. https://github.com/oraichain/cosmwasm-tools

    tools tổng hợp để tương tác với contract Oraichain và các mạng cosmos khác, có thể build, deploy contract thông qua CLI.

  2. cosmwasm-simulate

    3. https://github.com/oraichain/cw-simulate

    https://cw-notebook.web.app

    library cho phép simulate tương tác contract và IBC cho các mạng sử dụng cosmwasm, tối ưu nhất cho Oraichain. Có thể dùng để demo và viết test cases. Sử dụng bằng JS

  3. cosmos-sync

    4. https://github.com/oraichain/cosmos-sync:

    Library cho phép synchronize dữ liệu từ Cosmos blockchain (tối ưu cho Oraichain) sử dụng RPC. Sync sử dụng cơ chế Stream của NodeJs.

    Example - https://github.com/oraichain/oraidex-sdk/tree/main/packages/oraidex-sync

  4. cosmwasm

    5. https://docs.cosmwasm.com/docs/

  5. cw-template - Embed GitHubEmbed GitHub
  6. Oraichain LCD

    7. https://lcd.orai.io/ & https://lcd.orai.io/swagger/

  7. Oraichain RPC

    8. https://rpc.orai.io/

Sample Oraichain productions

  1. OraiDEX smartcontracts

    2. https://github.com/oraichain/oraiswap

    Contracts integrations diagram

https://drive.google.com/file/d/1bdRljVISvZ5w1UiDYBiEGgpGi4bNUp6j/view?usp=sharing
  1. OraiDEX Typescript types examples

    2. https://github.com/oraichain/common-sdk

    This help understanding dApps integration with Smart Contracts easier.

  2. OraiDEX frontend

    3. https://github.com/oraichain/oraiswap-frontend