From 1943762525c11338808df5970832e3d8532cf004 Mon Sep 17 00:00:00 2001 From: MC <149421156+ffe9f8@users.noreply.github.com> Date: Tue, 20 Feb 2024 13:53:38 -0500 Subject: [PATCH] feat: rewrite alexar for devs page (#784) --- src/pages/dev/intro.mdx | 59 ++++++++++++++++++++++------------------- 1 file changed, 31 insertions(+), 28 deletions(-) diff --git a/src/pages/dev/intro.mdx b/src/pages/dev/intro.mdx index 2beb212fa..af293cb60 100644 --- a/src/pages/dev/intro.mdx +++ b/src/pages/dev/intro.mdx @@ -1,47 +1,50 @@ --- -title: Axelar for developers +title: Axelar for Developers --- -Axelar enables secure interchain communication and token transfers, regardless of consensus mechanism or message payload. +Axelar enables secure token transfers and communication across different blockchains, regardless of consensus mechanisms or message payloads. It’s based on the same [proof-of-stake security model](/learn/security#proof-of-stake-consensus) as many of the chains it connects. Interchain apps built on Axlear are truly permissionless: their transactions cannot be censored by any oracle, relayer, or validator. -Interchain apps built on Axelar are truly permissionless, meaning that their transactions cannot be censored by any oracle, relayer or validator. Axelar is based on the same proof-of-stake security model as many of the chains it connects. +To make an interchain transaction with Axelar: -## Basic functionality +1. Call the contract method on the source chain: + * [`callContract()`](/dev/general-message-passing/gmp-messages) to send messages without tokens, or + * [`callContractWithToken()`](/dev/general-message-passing/gmp-tokens-with-messages) to send messages along with ERC-20 tokens. +1. Pay gas to the [`AxelarGasService`](https://github.com/axelarnetwork/axelar-cgp-solidity/blob/main/contracts/gas-service/AxelarGasService.sol) contract on the source chain. -Axelar supports two main types of interchain capabilities. +You can then use [Axelarscan](/dev/intro#check-interchain-transactions), Axelar’s dedicated blockchain explorer, to execute, recover, or check the status of your transaction. -1. **[Send Tokens](./send-tokens/overview)**: Send fungible tokens securely between many [Cosmos and EVM Chains](https://axelarscan.io/), as well as other complex transfers. -2. **[General Message Passing](./general-message-passing/overview)**: Call smart contract functions across blockchains. You can compose DeFi functions, move NFTs cross-chain, or perform cross-chain calls of any kind that sync state securely between dApps on various ecosystems. +## Get started -## Tools -There are several helpful tools that will make building interchain dApps simpler. +### Create new cross-chain tokens -### [Axelar Examples](https://github.com/axelarnetwork/axelar-examples) -A curated collection of interchain examples using Axelar that can be executed locally or deployed to testnets. +* [Create a new Interchain Token](/dev/send-tokens/interchain-tokens/create-token) +* [Upgrade existing ERC-20 tokens to Interchain Tokens](/dev/send-tokens/interchain-tokens/upgrade-tokens) -### [Foundry Axelar GMP Examples](https://github.com/axelarnetwork/foundry-axelar-gmp-example) -A showcase of an example of integrating with the Axelar GMP using the Foundry framework. +### Send tokens across chains -### [Axelar JavaScript SDK](./axelarjs-sdk/intro) -AxelarJS SDK is an npm library that includes a collection of APIs and query tools. +* [Send tokens between different blockchains](/dev/send-tokens/overview) +* [Rate limit for sending tokens across chains](/dev/reference/interchain-token-service-rate-limit) -### [axelar-local-dev](https://github.com/axelarnetwork/axelar-local-dev) +### Pass messages between chains -* Create locally simulated chains with RPC endpoints on your localhost. These chains come preloaded with the AxelarGateway, AxelarGasReceiver, and a routed ERC-20 token contract (axlUSDC). -* Deploy your custom `IAxelarExecutable` contracts to your simulated EVM chains. -* Test your dApp against the RPC endoints and contract addresses of your local development environment. +* [Call a smart contract on another chain](/dev/general-message-passing/gmp-messages) +* [Call a smart contract on another chain and attach some tokens](/dev/general-message-passing/gmp-tokens-with-messages) +### Manage cross-chain gas payments -For the actual development of your dApp, there are four simple steps (two mandatory and two optional): -1. Call the contract method on the source chain: - - `callContract`, or - - `callContractWithToken` -2. Pay gas to the Gas Services contract on the source chain. -3. Optional: Check the status of the call. -4. Optional: Execute and recover transactions. +* [Transaction pricing with the Axelar Gas Service](/dev/gas-service/pricing) +* [Pay gas](/dev/gas-service/pay-gas) +* [Increase gas](/dev/gas-service/increase-gas) +* [Refund gas](/dev/gas-service/refund) +### Check interchain transactions -## Helpful resources -If you have any issues with the two steps above, you can use the suite of tools and other ["kick-starter" examples](https://github.com/axelarnetwork/axelar-examples) in the Axelar developer ecosystem to get you going. +* [Axelarscan (Mainnet)](https://axelarscan.io/) +* [Axelarscan (Testnet)](https://testnet.axelarscan.io/) +## Tools and resources +* [`axelar-examples`](https://github.com/axelarnetwork/axelar-examples) – Cross-chain sample apps using Axelar that can be executed locally or deployed to testnets +* [`foundry-axelar-gmp-example`](https://github.com/axelarnetwork/foundry-axelar-gmp-example) – A sample app that integrates with [Axelar GMP](/dev/general-message-passing/overview) using the [Foundry](https://github.com/foundry-rs/foundry) framework +* [AxelarJS SDK](/dev/axelarjs-sdk/intro) – an [npm](https://www.npmjs.com/) library with a collection of APIs and query tools +* [`axelar-local-dev`](https://github.com/axelarnetwork/axelar-local-dev) – A local cross-chain development environment where you can deploy an app to simulated EVM chains. These chains are preloaded with the [`AxelarGateway`](https://github.com/axelarnetwork/axelar-cgp-solidity/blob/main/contracts/AxelarGateway.sol), `AxelarGasReceiver`, and routed ERC-20 (axlUSDC) token contracts. Deployed apps can be tested against the RPC endpoints and contract addresses of your local development environment. \ No newline at end of file