Skip to content

Commit

Permalink
Merge pull request #43 from lmedury/main
Browse files Browse the repository at this point in the history
Adding Article and Video Content
  • Loading branch information
danburck authored Feb 23, 2024
2 parents 2b0ebf7 + 6a5c99c commit dd72da1
Show file tree
Hide file tree
Showing 44 changed files with 992 additions and 7 deletions.
20 changes: 16 additions & 4 deletions docs/articles/advanced/using-iprpc.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ In order to provide decentralized, reliable and public RPC to all developers in

Lava ipRPC aggregates RPC providers and provides a unified endpoint for Evmos's entire ecosystem. Regardless of whether you're using `gRPC`, `REST`, `JSON-RPC`, `TendermintRPC`, or `Web-gRPC`, you can query Evmos or post transactions. You can also use websockets to establish a continuous connection instead of conducting a discrete handshake for each relay.


## Endpoints 🔗

A complete list of endpoints available are available [here](https://docs.evmos.org/develop/api/networks). For ipRPC, please attend only to addresses on the list which have `Lava Network` as a maintainer. A list is provided below for your convenience, as well!
Expand Down Expand Up @@ -40,16 +39,19 @@ A complete list of endpoints available are available [here](https://docs.evmos.o
You can set your `evmosd` installation to use ipRPC for all calls and requests. To do so, you need to configure your default node to use the Tendermint-RPC URL for your respective network.

For `mainnet` use:

```bash
./evmosd config node https://tm.evmos.lava.build:443
```

For `testnet` use:

```bash
./evmosd config node https://tm.evmos-testnet.lava.build:443
```

To ensure that your `evmosd` is correctly setup run the following:

```bash
./evmosd status
```
Expand All @@ -62,53 +64,63 @@ If you get a readout like the following, you're properly configured!

Now, all `evmosd` commands which communicate with the blockchain will be carried out securely and efficiently over Lava ipRPC.


## Test Commands 🖥️

You can send requests to each endpoint directly from the command line without intervention from `evmosd`. This can be done with the use of different tools such as `curl` for HTTP-responsive protocols, `wscat` for web sockets, and `grpcurl` for gRPC. You can also use any of the endpoints programmatically. Some examples are below:


### 🟢 REST

Send get requests to the appropriate cosmos endpoints!

```bash
curl -X GET -H "Content-Type: application/json" https://rest.evmos.lava.build/cosmos/base/tendermint/v1beta1/blocks/latest
curl -X GET -H "Content-Type: application/json" https://rest.evmos-testnet.lava.build/cosmos/base/tendermint/v1beta1/blocks/latest
```

### 🟢 Tendermint

Send post requests to the Tendermint-RPC endpoint!

```bash
curl -X POST -H "Content-Type: application/json" https://tm.evmos.lava.build --data '{"jsonrpc": "2.0", "id": 1, "method": "status", "params": []}'
curl -X POST -H "Content-Type: application/json" https://tm.evmos-testnet.lava.build --data '{"jsonrpc": "2.0", "id": 1, "method": "status", "params": []}'
```

### 🟢 Tendermint/Websocket

Connect using websockets over Tendermint-RPC.

```bash
wscat -c wss://tm.evmos.lava.build/websocket -x '{"jsonrpc": "2.0", "id": 1, "method": "status", "params": []}'
wscat -c wss://tm.evmos-testnet.lava.build/websocket -x '{"jsonrpc": "2.0", "id": 1, "method": "status", "params": []}'
```

### 🟢 JSON-RPC

Send EVM-style request to JSON-RPC endpoints!

```bash
curl -X POST -H "Content-Type: application/json" https://evmos.lava.build --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
curl -X POST -H "Content-Type: application/json" https://evmos-testnet.lava.build --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```

### 🟢 JSON-RPC/Websocket

Connect using websockets over JSON-RPC.

```bash
wscat -c wss://evmos.lava.build/websocket -x '{"jsonrpc": "2.0", "id": 1, "method": "eth_blockNumber", "params": []}'
wscat -c wss://evmos-testnet.lava.build/websocket -x '{"jsonrpc": "2.0", "id": 1, "method": "eth_blockNumber", "params": []}'
```

### 🟢 gRPC

Use gRPC calls directly with the Cosmos API.

```bash
grpcurl grpc.evmos.lava.build:443 cosmos.base.tendermint.v1beta1.Service/GetLatestBlock
grpcurl grpc.evmos-testnet.lava.build:443 cosmos.base.tendermint.v1beta1.Service/GetLatestBlock

```

✅ The rest is up to you! The possibilities are literally endless!
✅ The rest is up to you! The possibilities are literally endless!
95 changes: 95 additions & 0 deletions docs/articles/beginner/Learn/forge.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
# Forge DEX

Forge DEX distinguishes itself as the most capital-efficient exchange within the Cosmos and Inter-Blockchain Communication (IBC) ecosystem, primarily attributed to the integration of the Uniswap v3 protocol.

Through the incorporation of the concentrated liquidity feature from Uniswap v3, Forge DEX empowers liquidity providers to strategically allocate their assets within personalized price ranges. This strategy substantially minimizes slippage and enhances capital efficiency for all users, delivering a more competitive and optimal trading experience on the platform.

Crafted with the community in consideration, Forge functions as a community-owned decentralized exchange that imposes no protocol fees. This distinctive model not only cultivates a shared sense of ownership but also stimulates increased engagement from users. Through the removal of protocol fees, Forge DEX strives to establish a more accessible and inclusive platform for traders, fostering transparency and trust within the ecosystem. The community-centric ethos of Forge DEX lays the foundation for a decentralized exchange that stays attuned to the needs and preferences of its users.

## What can we do on Forge

### DEX Protocol

Forge operates as a deployment of Uniswap v3 fork on the Evmos network. The Uniswap protocol represents a peer-to-peer system crafted for the exchange of cryptocurrency assets on Ethereum and EVMs. Enacted as a collection of persistent, non-upgradable smart contracts, the protocol is intentionally structured to prioritize attributes such as censorship resistance, security, self-custody, and the ability to operate without reliance on trusted intermediaries that might selectively restrict access.

The Forge protocol diverges from the traditional approach by adopting an Automated Market Maker (AMM), sometimes known as a Constant Function Market Maker, in lieu of an order book.

On a broad scale, an AMM replaces the conventional buy and sell orders found in an order book market with a liquidity pool containing two assets, each valued in relation to the other. As one asset is exchanged for the other, the relative prices of the two assets undergo changes, determining a new market rate for both. In this dynamic, a buyer or seller engages directly with the pool, as opposed to interacting with specific orders left by other parties.

### Forge Perpetuals:

Perpetuals, in the context of decentralized finance (DeFi), refer to a specific type of derivative financial instrument known as perpetual contracts. Perpetual contracts are a type of futures contract with no expiration date. They are designed to mimic the features of a traditional futures contract while eliminating the need for a fixed maturity date.

Boasting over 160 liquidity sources spanning multiple chains, the self-proclaimed "Aggregator of Everything" empowers traders to access an extensive pool of $40B, encompassing contributions from various perpetual protocols like GMX and GNS.

![Forge](/img/articles/Forge-1.gif)

The above screenshot illustrates stEVMOS on the Evmos mainnet serving as the exclusive collateral for a diverse array of positions, including:

<ul>
<li>A straightforward 100X ape-leveraged BTC long position.</li>
<li>Positions related to asset pairs on different Ethereum chains, such as OP on Optimism.
</li>
<li>Exposure to positions for non-EVM assets like ATOM, SOL, XMR, and more.
</li>
<li>Thematic weighted baskets/indexes like TOP10INDEX, LSDINDEX, and others.
</li>
<li>Inclusion of "real-world" markets like the S&P500 and forex pairs, catering to diverse preferences.</li>
</ul>

### Range Orders:

Introducing a novel approach to automated market makers, customizable liquidity positions and the provision of single-sided assets give rise to a unique form of swapping known as the "range order."

![Forge](/img/articles/Forge-2.png)

In conventional order book markets, setting a limit order—whether to buy or sell an asset at a predetermined price—permits the order to be filled at an unspecified time in the future.

Forge adopts the concept of a range order, where one can emulate a limit order by contributing a single asset as liquidity within a specified range. Similar to traditional limit orders, range orders can be established with the anticipation of execution at a later point, allowing withdrawal of the target asset after the spot price traverses the entire range.

In contrast to markets where limit orders may incur fees, the range order maker accrues fees during the order fulfillment process. This is attributed to the nature of the range order as a form of liquidity provisioning, differing from the conventional swap model.

Forge is adding significant value to the Evmos ecosystem by addressing key aspects of the DeFi space and contributing to the platform's growth and adoption. The notable contributions include:

### Self-Sustaining and Community Owned DEX

The Evmos community has successfully passed Proposal 142, endorsing the provision of liquidity for the main stEVMOS/EVMOS pair on Forge. The proposal specified a request for 2 million Evmos, with 1 million Evmos designated for liquid staking.

The management of the liquidity pool is presently overseen by the Evmos DAO, in collaboration with the OA (Operator Address) and two trusted and actively participating community members. This governance structure ensures 100% transparency and visibility on the block explorer.

Generated rewards from both liquid staking and the Forge liquidity pool (LP fees) will be directed to a multisig wallet. A segment of these rewards will be allocated to cover the operational expenses of the DEX, thereby ensuring its long-term sustainability and growth. The remaining rewards will be earmarked for Forge bounties. Importantly, the requested funds exclusively serve to provision liquidity to Forge, necessitating regular adjustments to the position.

Central to understanding Forge's philosophy and strategy is the recognition that Forge operates on distinctive principles, diverging from the conventional mechanisms observed in certain other decentralized exchanges (DEXs). Notably, Forge abstains from featuring an investment token and refrains from executing airdrops. Furthermore, the protocol fees implemented in Forge are deliberately set at 0%. These choices underscore the commitment to ensuring that Forge functions not as a tool for individual profit but as a community-owned public good.

Forge assumes a primary role as a catalyst for growth and innovation within the Evmos ecosystem. By aligning its operations with this mission, Forge aims to provide a platform that authentically serves its community. This shift away from individual profit orientation towards a focus on the public good signifies a renewed dedication to long-term growth and the overall health of the Evmos ecosystem.

### Governance:

At Forge, a commitment to transparency, decentralization, and active community engagement is evident. Currently, all governance processes for Forge transpire on-chain on the Evmos mainnet through the Cosmos SDK. This on-chain governance framework fosters transparency and equity, allowing all network participants to propose, deliberate, and vote on various initiatives that shape the network's trajectory.

As Forge experiences growth, there is an anticipation of an escalating need for increased flexibility and expeditious decision-making. The ongoing evolution of the network suggests the possibility of adaptations and refinements to the governance model, ensuring alignment with the ever-shifting landscape and responsiveness to the evolving needs of the dynamic community.

For more detailed insights into the Evmos Community Proposal framework, individuals can find comprehensive information on the Evmos DAO site: https://docs.evmos.community/

### Incentive Programs

The Evmos community has endorsed a significant governance proposal titled "Inferno - An Incentive Program to Bootstrap Liquidity in Forge." This proposal, collaboratively introduced by the Evmos DAO, Orbital Apes, and Forge, aims to establish sustainable liquidity and volume on Forge, a decentralized exchange (DEX) on Evmos.

To facilitate the program's execution, the community has earmarked 3,000,000 Evmos for incentivizing liquidity provision on the Forge DEX. Participants in liquidity provision have the potential to earn through three channels: staking rewards, liquidity emissions from the program, and LP fees. This multi-reward approach marks a pioneering initiative within the Cosmos ecosystem.

### Partnership with Revert Finance

It is noteworthy to highlight Forge's ongoing incentive program in collaboration with Revert Finance, incorporating a unique staking mechanism. This initiative rewards users for participating in liquidity provision, serving as a precursor to broader staking opportunities within the Forge ecosystem. Detailed information about this staking mechanism is readily accessible on Revert Finance's official website: https://revert.finance/

## Connect with Forge:

App: https://app.forge.trade/

Docs: https://docs.forge.trade

X: https://revert.finance/

Medium: https://medium.com/forge-dex

Github: https://github.com/Forge-Trade/forge-mastery

65 changes: 65 additions & 0 deletions docs/articles/beginner/Learn/orbit.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Orbit Marketplace

The Orbit NFT marketplace makes purchasing NFTs on the Evmos Network easy and straightforward. With a user-friendly interface, users can explore a range of features to list and buy various NFTs in seconds. Notably, NFTs listed on the Orbit Marketplace remain securely within user wallets, ensuring users maintain complete control and access to their listed assets.

Additionally, the Orbit NFT Marketplace provides users with comprehensive analytics for NFT collections. This feature allows users to make well-informed decisions by offering insights into various collections. The marketplace enables users to make collection offers (including limit orders) for an NFT collection.

What's more, users can leverage the EVMOS token to make offers and acquire NFTs.

Orbital Apes has set its sights on becoming the flagship NFT collection on Evmos and a key player in the NFT space with its suite of products. With an initial release of a 10,000 NFT collection, Orbital Apes plans to harness the support of its holders to establish the most robust NFT marketplace on the chain. The vision extends to a holder-backed validator and an engaging NFT game, solidifying Orbital Apes as a prominent force in the evolving landscape of NFTs in the Evmos ecosystem.

## What can we do on Orbit Marketplace

### Diverse Token Transactions

The marketplace facilitates the buying and selling of NFTs using EVMOS and Wrapped EVMOS, with plans to incorporate more tokens in the future.

![Token Transactions](/img/articles/Orbit-1.png)

### NFT and Collection Offers

Enables users to place offers on individual NFTs with specified expiration dates using WEVMOS. Additionally, users can extend the same offer to every item within a collection, allowing any holder of a collection item to accept the offer.

![NFT and Collections](/img/articles/Orbit-2.png)

### Rewarding Ownership

Orbital Ape owners earn rewards from trading fees. Collection owners benefit from a royalty fee, and royalties are paid instantly.

![Rewards](/img/articles/Orbit-3.png)

### Attribute-based Filtering

The marketplace allows to filter NFTs based on attributes, enhancing user experience and aiding in the discovery of specific tokens. Additionally, we can also select a specific collection and view NFTs available within that collection.

![Filterting](/img/articles/Orbit-4.png)

### Secure NFT Handling

NFTs remain securely in the user's wallet until they are successfully sold. Orbit Marketplace currently only supports Metamask wallet and all NFTs owned by the user are stored in accounts within the Metamask wallet.

![NFTs](/img/articles/Orbit-5.png)

### Comprehensive Activity Dashboard

Each NFT, user profile, and collection is equipped with an activity dashboard, offering a detailed history of sales, transfers, listings, and offers. This feature enhances transparency and allows users to track the lifecycle of their digital assets seamlessly.

![Dashboard](/img/articles/Orbit-6.png)

Orbit Marketplace is adding significant value to the Evmos ecosystem by addressing key aspects of the NFT space and contributing to the platform's growth and adoption. The notable contributions:

<ul>
<li>User-Friendly Interface: Orbit Marketplace prioritizes an intuitive and easy-to-use interface, aiming to attract artists and collectors to Evmos. This focus on user experience is crucial for fostering a vibrant and engaged community within the ecosystem</li>
<li>Decentralized and Secure Trading: Offering a secure and decentralized trading environment, Orbit ensures the reliable and safe exchange of NFTs, contributing to the overall trustworthiness of the Evmos network.</li>
<li>Advanced Features and Tools: The inclusion of features such as NFT and collection offers, attribute-based filtering, upcoming mints sections, and an activity dashboard provides users with advanced tools for trading, discovering, and managing their NFTs.</li>
<li>Awareness Building: By highlighting upcoming mints and newly minted sections, Orbit increases awareness during launches, contributing to the promotion of new collections and the broader Evmos ecosystem.</li>
<li>Transparent Activity Tracking: The detailed activity dashboard for each NFT, user profile, and collection fosters transparency by allowing users to track the history of sales, transfers, listings, and offers.</li>
</ul>

## Connect with Orbit NFT Marketplace

Docs: https://docs.orbitalapes.com/orbit-marketplace/about

Website: https://www.orbitalapes.com/

Twitter: https://twitter.com/orbitmarketos
Loading

0 comments on commit dd72da1

Please sign in to comment.