├── LICENSE ├── README.md └── tools ├── bash_installer ├── README.md ├── assets │ └── 6232a479.png └── osmosis_setup.sh ├── spin_osmosis_with_snapshot.md └── spin_osmosis_with_snapshot.sh /LICENSE: -------------------------------------------------------------------------------- 1 | Creative Commons Legal Code 2 | 3 | CC0 1.0 Universal 4 | 5 | CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE 6 | LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN 7 | ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS 8 | INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES 9 | REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS 10 | PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM 11 | THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED 12 | HEREUNDER. 13 | 14 | Statement of Purpose 15 | 16 | The laws of most jurisdictions throughout the world automatically confer 17 | exclusive Copyright and Related Rights (defined below) upon the creator 18 | and subsequent owner(s) (each and all, an "owner") of an original work of 19 | authorship and/or a database (each, a "Work"). 20 | 21 | Certain owners wish to permanently relinquish those rights to a Work for 22 | the purpose of contributing to a commons of creative, cultural and 23 | scientific works ("Commons") that the public can reliably and without fear 24 | of later claims of infringement build upon, modify, incorporate in other 25 | works, reuse and redistribute as freely as possible in any form whatsoever 26 | and for any purposes, including without limitation commercial purposes. 27 | These owners may contribute to the Commons to promote the ideal of a free 28 | culture and the further production of creative, cultural and scientific 29 | works, or to gain reputation or greater distribution for their Work in 30 | part through the use and efforts of others. 31 | 32 | For these and/or other purposes and motivations, and without any 33 | expectation of additional consideration or compensation, the person 34 | associating CC0 with a Work (the "Affirmer"), to the extent that he or she 35 | is an owner of Copyright and Related Rights in the Work, voluntarily 36 | elects to apply CC0 to the Work and publicly distribute the Work under its 37 | terms, with knowledge of his or her Copyright and Related Rights in the 38 | Work and the meaning and intended legal effect of CC0 on those rights. 39 | 40 | 1. Copyright and Related Rights. A Work made available under CC0 may be 41 | protected by copyright and related or neighboring rights ("Copyright and 42 | Related Rights"). Copyright and Related Rights include, but are not 43 | limited to, the following: 44 | 45 | i. the right to reproduce, adapt, distribute, perform, display, 46 | communicate, and translate a Work; 47 | ii. moral rights retained by the original author(s) and/or performer(s); 48 | iii. publicity and privacy rights pertaining to a person's image or 49 | likeness depicted in a Work; 50 | iv. rights protecting against unfair competition in regards to a Work, 51 | subject to the limitations in paragraph 4(a), below; 52 | v. rights protecting the extraction, dissemination, use and reuse of data 53 | in a Work; 54 | vi. database rights (such as those arising under Directive 96/9/EC of the 55 | European Parliament and of the Council of 11 March 1996 on the legal 56 | protection of databases, and under any national implementation 57 | thereof, including any amended or successor version of such 58 | directive); and 59 | vii. other similar, equivalent or corresponding rights throughout the 60 | world based on applicable law or treaty, and any national 61 | implementations thereof. 62 | 63 | 2. Waiver. To the greatest extent permitted by, but not in contravention 64 | of, applicable law, Affirmer hereby overtly, fully, permanently, 65 | irrevocably and unconditionally waives, abandons, and surrenders all of 66 | Affirmer's Copyright and Related Rights and associated claims and causes 67 | of action, whether now known or unknown (including existing as well as 68 | future claims and causes of action), in the Work (i) in all territories 69 | worldwide, (ii) for the maximum duration provided by applicable law or 70 | treaty (including future time extensions), (iii) in any current or future 71 | medium and for any number of copies, and (iv) for any purpose whatsoever, 72 | including without limitation commercial, advertising or promotional 73 | purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each 74 | member of the public at large and to the detriment of Affirmer's heirs and 75 | successors, fully intending that such Waiver shall not be subject to 76 | revocation, rescission, cancellation, termination, or any other legal or 77 | equitable action to disrupt the quiet enjoyment of the Work by the public 78 | as contemplated by Affirmer's express Statement of Purpose. 79 | 80 | 3. Public License Fallback. Should any part of the Waiver for any reason 81 | be judged legally invalid or ineffective under applicable law, then the 82 | Waiver shall be preserved to the maximum extent permitted taking into 83 | account Affirmer's express Statement of Purpose. In addition, to the 84 | extent the Waiver is so judged Affirmer hereby grants to each affected 85 | person a royalty-free, non transferable, non sublicensable, non exclusive, 86 | irrevocable and unconditional license to exercise Affirmer's Copyright and 87 | Related Rights in the Work (i) in all territories worldwide, (ii) for the 88 | maximum duration provided by applicable law or treaty (including future 89 | time extensions), (iii) in any current or future medium and for any number 90 | of copies, and (iv) for any purpose whatsoever, including without 91 | limitation commercial, advertising or promotional purposes (the 92 | "License"). The License shall be deemed effective as of the date CC0 was 93 | applied by Affirmer to the Work. Should any part of the License for any 94 | reason be judged legally invalid or ineffective under applicable law, such 95 | partial invalidity or ineffectiveness shall not invalidate the remainder 96 | of the License, and in such case Affirmer hereby affirms that he or she 97 | will not (i) exercise any of his or her remaining Copyright and Related 98 | Rights in the Work or (ii) assert any associated claims and causes of 99 | action with respect to the Work, in either case contrary to Affirmer's 100 | express Statement of Purpose. 101 | 102 | 4. Limitations and Disclaimers. 103 | 104 | a. No trademark or patent rights held by Affirmer are waived, abandoned, 105 | surrendered, licensed or otherwise affected by this document. 106 | b. Affirmer offers the Work as-is and makes no representations or 107 | warranties of any kind concerning the Work, express, implied, 108 | statutory or otherwise, including without limitation warranties of 109 | title, merchantability, fitness for a particular purpose, non 110 | infringement, or the absence of latent or other defects, accuracy, or 111 | the present or absence of errors, whether or not discoverable, all to 112 | the greatest extent permissible under applicable law. 113 | c. Affirmer disclaims responsibility for clearing rights of other persons 114 | that may apply to the Work or any use thereof, including without 115 | limitation any person's Copyright and Related Rights in the Work. 116 | Further, Affirmer disclaims responsibility for obtaining any necessary 117 | consents, permissions or other rights required for any use of the 118 | Work. 119 | d. Affirmer understands and acknowledges that Creative Commons is not a 120 | party to this document and has no duty or obligation with respect to 121 | this CC0 or use of the Work. 122 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Awesome Osmosis 2 | List of public resources, documents, and tools for Osmosis. This Awesome repo is also automatically published on the official [Osmosis Documentation site](https://docs.osmosis.zone/awesome/) 3 | 4 | ### Reading lists 5 | - [How to permissionlessly list tokens to Osmosis](https://docs.osmosis.zone/docs/developing/guides/create-ibc-pool) 6 | 7 | ### Block Explorers 8 | - [Mintscan](https://mintscan.io/osmosis) 9 | - [Big Dipper](https://osmosis.bigdipper.live) 10 | - [Ping.pub](https://ping.pub/osmosis) 11 | 12 | ### Analytics, Data, and Visualization 13 | - [Imperator Osmosis Dashboard](https://info.osmosis.zone/) 14 | - [Map of Zones](https://mapofzones.com) 15 | - [Smartstake staking dashboard](https://osmosis.smartstake.io/) 16 | - [Cosmissed by Blockpane](https://github.com/blockpane/cosmissed) 17 | - [Osmosis DEX Screener](https://dexscreener.com/osmosis) 18 | - [chain monitoring by Cros-Nest](https://chain-monitor.cros-nest.com/d/Cros-nest/block-chains?orgId=1&var-chain_id=osmosis-1) 19 | 20 | ### Relayer infrastructure providers 21 | - [Cephalopod Equipment](https://cephalopod.equipment/) 22 | - [CryptoCrew Validators](https://ccvalidators.com/) 23 | - [Vitwit](https://www.vitwit.com/) 24 | - [Notional](https://github.com/faddat/notional) 25 | - [Cros-Nest](https://cros-nest.com/) 26 | 27 | ### Validator snapshots & syncing 28 | - [Quicksync by Chainlayer](https://quicksync.io/networks/osmosis.html) 29 | - [All That Node by DSRV](https://www.allthatnode.com/osmosis.dsrv) 30 | - [3Tekos Validator](https://3tekos.fr/#Archives) 31 | - [Stake Systems](https://www.notion.so/Stake-Systems-LCD-RPC-gRPC-Instances-04a99a9a9aa14247a42944931eec7024) - Snapshots taken everyday at 06:00 UTC / 18:00 UTC 32 | 33 | ### Publicly available endpoints 34 | 35 | **Mainnet** 36 | - [Official Osmosis Developers](https://rpc.dev-osmosis.zone/) : `https://rpc.dev-osmosis.zone/` - Mainnet 37 | - [Chain Registry](https://github.com/cosmos/chain-registry) : `https://github.com/cosmos/chain-registry` - Mainnet 38 | - [All That Node by DSRV](https://www.allthatnode.com/osmosis.dsrv) : `https://www.allthatnode.com/osmosis.dsrv` - Mainnet / Mainnet Archive / Testnet with Faucet (LCD/REST, RPC, gRPC) 39 | - [DataHub](https://datahub.figment.io) : `https://datahub.figment.io` - Mainnet / Mainnet Archive (LCD/REST, RPC, gRPC) 40 | - [Stake Systems](https://www.notion.so/Stake-Systems-LCD-RPC-gRPC-Instances-04a99a9a9aa14247a42944931eec7024) - LCD(REST)/RPC/gRPC 41 | 42 | ### Archive Nodes 43 | 44 | Latest list of peers are published to [Osmosis Discord](https://discord.gg/osmosis) channel #peers-list 45 | 46 | - Notional's bus bar 47 | - 28f61c154c82f0122a841a12f8aa87703bd6ae1e@162.55.132.230:2000 48 | 49 | You'd want to add the bus bar as a persistent peer. It can accept a vast number of connections, and can be used in a manner analogous to a seed node since it will do PEX with you. It is not a seed node. 50 | 51 | - Seed nodes 52 | - `2308bed9e096a8b96d2aa343acc1147813c59ed2@3.225.38.25:26656` 53 | - `1b077d96ceeba7ef503fb048f343a538b2dcdf1b@136.243.218.244:26656` (Provided by Smartnodes) 54 | - `902bdfe51b6a97cc9369664a21c87ed61d471d2a@136.243.218.243:26656` (Provided by Smartnodes) 55 | - `f515a8599b40f0e84dfad935ba414674ab11a668@osmosis.blockpane.com:26656` (Provided by BlockPane) 56 | 57 | 58 | ### Documentation / Guides 59 | - [Osmosis Official Documentation](https://docs.osmosis.zone) 60 | - [Edge Validation](https://whimsical.com/validatron-PbUypC8tVMU8DxCFNLdDFu) 61 | - [Relaying](https://github.com/faddat/notional) 62 | - [Listing IBC tokens to Osmosis](https://docs.osmosis.zone/docs/developing/guides/create-ibc-pool) 63 | - [Setting up a full node for Osmosis-1](https://catboss.medium.com/cat-boss-setting-up-a-fullnode-for-osmosis-osmosis-1-5f9752460f8f) / [Turning a full node into a validator node](https://catboss.medium.com/turning-a-full-node-in-to-a-validator-node-osmosis-1-36f3358f2412) 64 | 65 | ### Decentralization and resilience tools 66 | - [Tradeberry](https://github.com/faddat/tradeberry) - Stateless rpi image that state syncs osmosis and allows access to the UI in a private, sovereign manner. 67 | 68 | ### Wallet & Payments 69 | - [Easy Kelpr Transaction](https://github.com/alighasemzadeh/easy-keplr-connect) - Osmosis Laravel Mix Transaction Example. 70 | -------------------------------------------------------------------------------- /tools/bash_installer/README.md: -------------------------------------------------------------------------------- 1 | #Osmosis Node Bash Installer 2 | This is a installer bash script to run a full node and test node eventually. Please use this issue to track []() 3 | 4 | ![](assets/6232a479.png) 5 | 6 | Based on the work by @hyehan [here](https://github.com/osmosis-labs/awesome/blob/main/tools/spin_osmosis_with_snapshot.md) 7 | -------------------------------------------------------------------------------- /tools/bash_installer/assets/6232a479.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/osmosis-labs/awesome/69c80b745af70a1d46239279a52ad00bb2be2054/tools/bash_installer/assets/6232a479.png -------------------------------------------------------------------------------- /tools/bash_installer/osmosis_setup.sh: -------------------------------------------------------------------------------- 1 | #! /bin/bash 2 | set -e 3 | PS1="\e[0;34m\u@\h Color Test \w> \e[m" 4 | echo " 5 | ██████╗ ███████╗███╗ ███╗ ██████╗ ███████╗██╗███████╗ 6 | ██╔═══██╗██╔════╝████╗ ████║██╔═══██╗██╔════╝██║██╔════╝ 7 | ██║ ██║███████╗██╔████╔██║██║ ██║███████╗██║███████╗ 8 | ██║ ██║╚════██║██║╚██╔╝██║██║ ██║╚════██║██║╚════██║ 9 | ╚██████╔╝███████║██║ ╚═╝ ██║╚██████╔╝███████║██║███████║ 10 | ╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝╚══════╝ 11 | Welcome to the Osmosis node installer. 12 | For more information visit docs.osmosis.zone 13 | " 14 | #TODO CHAIN TESTNET MAINNET 15 | 16 | #Select sync method. There are 3 options available. 17 | echo "Please choose a sync method:" 18 | PS3='Enter choice:' 19 | modes=("default" "pruned" "archive") 20 | select mode in "${modes[@]}"; do 21 | MODE=$mode 22 | printf "\033c" 23 | case $mode in 24 | "default") 25 | modeNote="This is a full network sync which will require about 350GB of disk space." 26 | break 27 | ;; 28 | "pruned") 29 | modeNote="This will require about 150GB of disk space." 30 | break 31 | ;; 32 | "archive") 33 | modeNote="This will require more than 700GB of disk space.." 34 | break 35 | ;; 36 | "Quit") 37 | echo "User requested exit" 38 | exit 39 | ;; 40 | *) echo "invalid option $REPLY.";; 41 | esac 42 | #set selected mode as a variable 43 | 44 | ## 45 | ##tput reset 46 | done 47 | 48 | #Select region 49 | echo "Please select a region closest to you:" 50 | PS3='Enter choice:' 51 | regions=("San Francisco" "Singapore" "Netherlands") 52 | select region in "${regions[@]}"; do 53 | REGION=$region 54 | printf "\033c" 55 | case $region in 56 | "San Francisco") 57 | break; 58 | ;; 59 | "Singapore") 60 | break; 61 | ;; 62 | "Netherlands") 63 | break; 64 | ;; 65 | "Quit") 66 | echo "User requested exit" 67 | exit 68 | ;; 69 | *) echo "invalid option $REPLY";; 70 | esac 71 | #set selected region as a variable 72 | #clear screen 73 | ## printf "\033c" 74 | done 75 | 76 | read -p "Installing using the $MODE sync method, $modeNote. Downloading from $REGION. Press enter to continue" 77 | 78 | 79 | 80 | #PEERS="" 81 | VERSION="" 82 | 83 | while getopts "v:m:h" option 84 | do 85 | case $option in 86 | v) VERSION="$OPTARG" ;; 87 | m) MODE="$OPTARG" ;; 88 | h) echo "Spin Osmosis Full Node (with ChainLayer QuickSync Snapshot) 89 | Usage: ./spin_osmosis_with_snapshot.sh -v vX.Y.Z -m ______ 90 | 91 | -v Input Osmosis version you want to install (default \"latest version\") 92 | -m Choose (pruned | default | archive) (default \"pruned\")" ;; 93 | esac 94 | done 95 | 96 | 97 | main() { 98 | basic_setup 99 | install_go 100 | osmosis 101 | get_snapshot 102 | get_peers 103 | spin_up 104 | } 105 | 106 | 107 | basic_setup() { 108 | sudo apt-get update -y && sudo apt-get upgrade -y 109 | sudo apt-get install build-essential jq wget -y 110 | } 111 | 112 | 113 | install_go() { 114 | sudo rm -rf /usr/local/go 115 | wget https://dl.google.com/go/go1.17.1.linux-amd64.tar.gz 116 | tar -xvf go1.17.1.linux-amd64.tar.gz 117 | sudo mv go /usr/local 118 | GOROOT=/usr/local/go 119 | PATH=$GOROOT/bin:$PATH 120 | } 121 | 122 | 123 | osmosis(){ 124 | git clone https://github.com/osmosis-labs/osmosis 125 | cd osmosis 126 | if [ -z "$VERSION" ]; then 127 | VERSION=$(git describe --tags `git rev-list --tags --max-count=1`) 128 | fi 129 | git fetch && git checkout $VERSION 130 | make build 131 | ./build/osmosisd init --chain-id osmosis-1 BestDEX 132 | } 133 | 134 | 135 | # get snapshot from ChainLayer QuickSync 136 | get_snapshot() { 137 | sudo apt-get install aria2 liblz4-tool -y 138 | if [ -z "$MODE" ]; then 139 | MODE="pruned" 140 | fi 141 | FILENAME=`curl https://quicksync.io/osmosis.json | jq -r --arg MODE "$MODE" '.[] | select(.network==$MODE)|select (.mirror=="$REGION")|.filename'` 142 | cd /$HOME/.osmosisd 143 | if [[ ! -f $FILENAME || -f $FILENAME.aria2 ]]; then 144 | aria2c -x5 https://get.quicksync.io/$FILENAME 145 | fi 146 | lz4 -d $FILENAME | tar xf - 147 | } 148 | 149 | 150 | get_peers() { 151 | sed -i "s/persistent_peers = \"\"persistent_peers = \"$PEERS\"/g" $HOME/.osmosisd/config/config.toml 152 | } 153 | 154 | 155 | spin_up() { 156 | ./$HOME/osmosis/build/osmosisd start 157 | } 158 | 159 | main; exit 160 | 161 | -------------------------------------------------------------------------------- /tools/spin_osmosis_with_snapshot.md: -------------------------------------------------------------------------------- 1 | ## Spin Osmosis Node 2 | 3 | snapshot by [ChainLayer QuickSync](https://quicksync.io/networks/osmosis.html) 4 | 5 | #### ※ Before spin it : 6 | You need to add Peers in 7 | `#PEERS = ""` (4L) 8 | 9 | #### Spin it : 10 | ```bash 11 | ./spin_osmosis_with_snapshot.sh -v vX.Y.Z -m _ _ _ 12 | ``` 13 | 14 | #### Options : 15 | ```bash 16 | -v : Input Osmosis version you want to install (default "latest version") 17 | -m : Choose (pruned | default | archive) (default "pruned") 18 | ``` 19 | -------------------------------------------------------------------------------- /tools/spin_osmosis_with_snapshot.sh: -------------------------------------------------------------------------------- 1 | #! /bin/bash -x 2 | set -e 3 | 4 | #PEERS="" 5 | VERSION="" 6 | MODE="" 7 | 8 | while getopts "v:m:h" option 9 | do 10 | case $option in 11 | v) VERSION="$OPTARG" ;; 12 | m) MODE="$OPTARG" ;; 13 | h) echo "Spin Osmosis Full Node (with ChainLayer QuickSync Snapshot) 14 | Usage: ./spin_osmosis_with_snapshot.sh -v vX.Y.Z -m ______ 15 | 16 | -v Input Osmosis version you want to install (default \"latest version\") 17 | -m Choose (pruned | default | archive) (default \"pruned\")" ;; 18 | esac 19 | done 20 | 21 | 22 | main() { 23 | basic_setup 24 | install_go 25 | osmosis 26 | get_snapshot 27 | get_peers 28 | spin_up 29 | } 30 | 31 | 32 | 33 | basic_setup() { 34 | sudo apt-get update -y && sudo apt-get upgrade -y 35 | sudo apt-get install build-essential jq wget -y 36 | } 37 | 38 | 39 | install_go() { 40 | sudo rm -rf /usr/local/go 41 | wget https://dl.google.com/go/go1.17.1.linux-amd64.tar.gz 42 | tar -xvf go1.17.1.linux-amd64.tar.gz 43 | sudo mv go /usr/local 44 | GOROOT=/usr/local/go 45 | PATH=$GOROOT/bin:$PATH 46 | } 47 | 48 | 49 | osmosis(){ 50 | git clone https://github.com/osmosis-labs/osmosis 51 | cd osmosis 52 | if [ -z "$VERSION" ]; then 53 | VERSION=$(git describe --tags `git rev-list --tags --max-count=1`) 54 | fi 55 | git fetch && git checkout $VERSION 56 | make build 57 | ./build/osmosisd init --chain-id osmosis-1 BestDEX 58 | } 59 | 60 | 61 | # get snapshot from ChainLayer QuickSync 62 | get_snapshot() { 63 | sudo apt-get install aria2 liblz4-tool -y 64 | if [ -z "$MODE" ]; then 65 | MODE="pruned" 66 | fi 67 | FILENAME=`curl https://quicksync.io/osmosis.json | jq -r --arg MODE "$MODE" '.[] | select(.network==$MODE)|select (.mirror=="Netherlands")|.filename'` 68 | cd /$HOME/.osmosisd 69 | if [[ ! -f $FILENAME || -f $FILENAME.aria2 ]]; then 70 | aria2c -x5 https://get.quicksync.io/$FILENAME 71 | fi 72 | lz4 -d $FILENAME | tar xf - 73 | } 74 | 75 | 76 | get_peers() { 77 | sed -i "s/persistent_peers = \"\"persistent_peers = \"$PEERS\"/g" $HOME/.osmosisd/config/config.toml 78 | } 79 | 80 | 81 | spin_up() { 82 | ./$HOME/osmosis/build/osmosisd start 83 | } 84 | 85 | main; exit 86 | 87 | --------------------------------------------------------------------------------