feat(getting-started): add new components for cross-chain messaging a… (#1370)

Author: Olanetsoft

src/components/getting-started/gmp.astro

@@ -0,0 +1,59 @@
+---
+const title = "Send Messages Across Chains";
+
+const cards = [
+  {
+    title: "Send a cross-chain message from an EVM chain",
+    description:
+      "Send data from any Ethereum-compatible blockchain using Solidity contracts and the AxelarGateway interface.",
+    url: "/dev/general-message-passing/gmp-messages/",
+  },
+  {
+    title: "Send a cross-chain message from a Cosmos chain",
+    description:
+      "Route messages from Cosmos SDK-based chains through IBC protocols with CosmWasm contract integration and gas relayers.",
+    url: "/dev/general-message-passing/cosmos-gmp/overview/",
+  },
+  {
+    title: "Send a cross-chain message from Sui",
+    description:
+      "Dispatch cross-chain communications from Sui's Move environment with object capabilities and immutable package references.",
+    url: "/dev/general-message-passing/sui/gmp-example/",
+  },
+  {
+    title: "Send a cross-chain message from Stellar",
+    description:
+      "Initiate interchain messaging from Stellar's high-throughput network using Soroban smart contracts and cross-chain bridges.",
+    url: "/dev/general-message-passing/stellar-gmp/gmp-example/",
+  },
+];
+---
+
+<div class="grid md:grid-cols-2 lg:grid-cols-1 xl:grid-cols-2 not-prose gap-6">
+  {
+    cards.map((card) => (
+      <a
+        class="border-[0.3px] font-clash px-6 flex flex-col gap-6 bg-white dark:bg-background-neutral py-5 rounded-[28px] border-border"
+        href={card.url}
+      >
+        <div class="flex justify-between items-center">
+          <h2 class="text-2xl font-medium flex-1 w-full">{card.title}</h2>
+
+          <svg
+            width="28"
+            height="28"
+            viewBox="0 0 28 28"
+            fill="none"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path
+              d="M16.0971 14.8244L13.4002 17.5217C13.2571 17.6646 13.1905 17.8349 13.2004 18.0328C13.2101 18.2306 13.2865 18.401 13.4296 18.5438C13.5724 18.687 13.7493 18.7585 13.9601 18.7585C14.171 18.7585 14.3446 18.687 14.4811 18.5438L18.1008 14.9245C18.3478 14.6775 18.4713 14.3895 18.4713 14.0605C18.4713 13.7315 18.3478 13.4435 18.1008 13.1965L14.4517 9.54777C14.3088 9.40467 14.1385 9.33311 13.9406 9.33311C13.7428 9.33311 13.5724 9.40467 13.4296 9.54777C13.2865 9.69062 13.2149 9.86746 13.2149 10.0783C13.2149 10.2894 13.2865 10.4631 13.4296 10.5993L16.0971 13.2966H9.35724C9.1408 13.2966 8.95937 13.3699 8.81296 13.5166C8.66654 13.6633 8.59334 13.845 8.59334 14.0617C8.59334 14.2784 8.66654 14.4597 8.81296 14.6056C8.95937 14.7515 9.1408 14.8244 9.35724 14.8244H16.0971ZM13.9456 27.8107C12.0443 27.8107 10.2566 27.4499 8.58264 26.7283C6.90894 26.0067 5.45294 25.0273 4.21466 23.7903C2.97638 22.5533 1.99616 21.0986 1.27402 19.4262C0.551627 17.754 0.19043 15.9671 0.19043 14.0655C0.19043 12.1641 0.551245 10.3765 1.27288 8.70251C1.99451 7.02881 2.97383 5.57281 4.21084 4.33453C5.44785 3.09625 6.90257 2.11604 8.575 1.3939C10.2472 0.6715 12.0341 0.310303 13.9357 0.310303C15.837 0.310303 17.6247 0.67112 19.2986 1.39275C20.9723 2.11438 22.4283 3.0937 23.6666 4.33071C24.9049 5.56772 25.8851 7.02244 26.6073 8.69488C27.3297 10.3671 27.6909 12.1539 27.6909 14.0555C27.6909 15.9569 27.33 17.7446 26.6084 19.4185C25.8868 21.0922 24.9075 22.5482 23.6704 23.7865C22.4334 25.0248 20.9787 26.005 19.3063 26.7271C17.6341 27.4495 15.8472 27.8107 13.9456 27.8107ZM13.9406 26.2829C17.3527 26.2829 20.2428 25.0989 22.6109 22.7308C24.979 20.3627 26.1631 17.4726 26.1631 14.0605C26.1631 10.6484 24.979 7.75833 22.6109 5.39024C20.2428 3.02215 17.3527 1.8381 13.9406 1.8381C10.5286 1.8381 7.63846 3.02215 5.27037 5.39024C2.90228 7.75833 1.71823 10.6484 1.71823 14.0605C1.71823 17.4726 2.90228 20.3627 5.27037 22.7308C7.63846 25.0989 10.5286 26.2829 13.9406 26.2829Z"
+              fill="currentColor"
+            />
+          </svg>
+        </div>
+        <p class="text-sm font-medium">{card.description}</p>
+      </a>
+    ))
+  }
+</div>

src/components/getting-started/interchain-tokens-evm.astro

@@ -0,0 +1,59 @@
+---
+const title = "Create a New Interchain Token for EVM and Non-EVM Chains";
+
+const cards = [
+  {
+    title: "Create a new Interchain Token",
+    description:
+      "Launch new Interchain Tokens through our user-friendly portal with no coding required. Perfect for quick deployment.",
+    url: "/dev/send-tokens/interchain-tokens/no-code/",
+  },
+  {
+    title: "Programmatically create a new Interchain Token",
+    description:
+      "Deploy Interchain Tokens using SDK and smart contract integration for customized functionality and control.",
+    url: "/dev/send-tokens/interchain-tokens/create-new-interchain-token/",
+  },
+  {
+    title: "Make an existing ERC-20 token an Interchain Token",
+    description:
+      "Transform standard ERC-20 tokens into cross-chain compatible assets while preserving their original functionality.",
+    url: "/dev/send-tokens/interchain-tokens/register-existing-token/",
+  },
+  {
+    title: "Link Custom Tokens Deployed Across Multiple Chains",
+    description:
+      "Connect independently deployed token contracts across different blockchains into a unified interchain ecosystem.",
+    url: "/dev/send-tokens/interchain-tokens/integrate-custom-token/",
+  },
+];
+---
+
+<div class="grid md:grid-cols-2 lg:grid-cols-1 xl:grid-cols-2 not-prose gap-6">
+  {
+    cards.map((card) => (
+      <a
+        class="border-[0.3px] font-clash px-6 flex flex-col gap-6 bg-white dark:bg-background-neutral py-5 rounded-[28px] border-border"
+        href={card.url}
+      >
+        <div class="flex justify-between items-center">
+          <h2 class="text-2xl font-medium flex-1 w-full">{card.title}</h2>
+
+          <svg
+            width="28"
+            height="28"
+            viewBox="0 0 28 28"
+            fill="none"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path
+              d="M16.0971 14.8244L13.4002 17.5217C13.2571 17.6646 13.1905 17.8349 13.2004 18.0328C13.2101 18.2306 13.2865 18.401 13.4296 18.5438C13.5724 18.687 13.7493 18.7585 13.9601 18.7585C14.171 18.7585 14.3446 18.687 14.4811 18.5438L18.1008 14.9245C18.3478 14.6775 18.4713 14.3895 18.4713 14.0605C18.4713 13.7315 18.3478 13.4435 18.1008 13.1965L14.4517 9.54777C14.3088 9.40467 14.1385 9.33311 13.9406 9.33311C13.7428 9.33311 13.5724 9.40467 13.4296 9.54777C13.2865 9.69062 13.2149 9.86746 13.2149 10.0783C13.2149 10.2894 13.2865 10.4631 13.4296 10.5993L16.0971 13.2966H9.35724C9.1408 13.2966 8.95937 13.3699 8.81296 13.5166C8.66654 13.6633 8.59334 13.845 8.59334 14.0617C8.59334 14.2784 8.66654 14.4597 8.81296 14.6056C8.95937 14.7515 9.1408 14.8244 9.35724 14.8244H16.0971ZM13.9456 27.8107C12.0443 27.8107 10.2566 27.4499 8.58264 26.7283C6.90894 26.0067 5.45294 25.0273 4.21466 23.7903C2.97638 22.5533 1.99616 21.0986 1.27402 19.4262C0.551627 17.754 0.19043 15.9671 0.19043 14.0655C0.19043 12.1641 0.551245 10.3765 1.27288 8.70251C1.99451 7.02881 2.97383 5.57281 4.21084 4.33453C5.44785 3.09625 6.90257 2.11604 8.575 1.3939C10.2472 0.6715 12.0341 0.310303 13.9357 0.310303C15.837 0.310303 17.6247 0.67112 19.2986 1.39275C20.9723 2.11438 22.4283 3.0937 23.6666 4.33071C24.9049 5.56772 25.8851 7.02244 26.6073 8.69488C27.3297 10.3671 27.6909 12.1539 27.6909 14.0555C27.6909 15.9569 27.33 17.7446 26.6084 19.4185C25.8868 21.0922 24.9075 22.5482 23.6704 23.7865C22.4334 25.0248 20.9787 26.005 19.3063 26.7271C17.6341 27.4495 15.8472 27.8107 13.9456 27.8107ZM13.9406 26.2829C17.3527 26.2829 20.2428 25.0989 22.6109 22.7308C24.979 20.3627 26.1631 17.4726 26.1631 14.0605C26.1631 10.6484 24.979 7.75833 22.6109 5.39024C20.2428 3.02215 17.3527 1.8381 13.9406 1.8381C10.5286 1.8381 7.63846 3.02215 5.27037 5.39024C2.90228 7.75833 1.71823 10.6484 1.71823 14.0605C1.71823 17.4726 2.90228 20.3627 5.27037 22.7308C7.63846 25.0989 10.5286 26.2829 13.9406 26.2829Z"
+              fill="currentColor"
+            />
+          </svg>
+        </div>
+        <p class="text-sm font-medium">{card.description}</p>
+      </a>
+    ))
+  }
+</div>

src/components/getting-started/interchain-tokens-non-evm.astro

@@ -0,0 +1,47 @@
+---
+const title = "Create a New Interchain Token for EVM and Non-EVM Chains";
+
+const cards = [
+  {
+    title: "Create a new Interchain Token on SUI",
+    description:
+      "Deploy cross-chain compatible tokens natively on SUI blockchain with full Move language benefits and object-based storage model.",
+    url: "/dev/send-tokens/sui/intro/",
+  },
+  {
+    title: "Create a new Interchain Token on Stellar",
+    description:
+      "Launch interoperable tokens on Stellar's high-speed, low-cost network with built-in DEX functionality and compliance features.",
+    url: "/dev/send-tokens/stellar/intro/",
+  },
+];
+---
+
+<div class="grid md:grid-cols-2 lg:grid-cols-1 xl:grid-cols-2 not-prose gap-6">
+  {
+    cards.map((card) => (
+      <a
+        class="border-[0.3px] font-clash px-6 flex flex-col gap-6 bg-white dark:bg-background-neutral py-5 rounded-[28px] border-border"
+        href={card.url}
+      >
+        <div class="flex justify-between items-center">
+          <h2 class="text-2xl font-medium flex-1 w-full">{card.title}</h2>
+
+          <svg
+            width="28"
+            height="28"
+            viewBox="0 0 28 28"
+            fill="none"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path
+              d="M16.0971 14.8244L13.4002 17.5217C13.2571 17.6646 13.1905 17.8349 13.2004 18.0328C13.2101 18.2306 13.2865 18.401 13.4296 18.5438C13.5724 18.687 13.7493 18.7585 13.9601 18.7585C14.171 18.7585 14.3446 18.687 14.4811 18.5438L18.1008 14.9245C18.3478 14.6775 18.4713 14.3895 18.4713 14.0605C18.4713 13.7315 18.3478 13.4435 18.1008 13.1965L14.4517 9.54777C14.3088 9.40467 14.1385 9.33311 13.9406 9.33311C13.7428 9.33311 13.5724 9.40467 13.4296 9.54777C13.2865 9.69062 13.2149 9.86746 13.2149 10.0783C13.2149 10.2894 13.2865 10.4631 13.4296 10.5993L16.0971 13.2966H9.35724C9.1408 13.2966 8.95937 13.3699 8.81296 13.5166C8.66654 13.6633 8.59334 13.845 8.59334 14.0617C8.59334 14.2784 8.66654 14.4597 8.81296 14.6056C8.95937 14.7515 9.1408 14.8244 9.35724 14.8244H16.0971ZM13.9456 27.8107C12.0443 27.8107 10.2566 27.4499 8.58264 26.7283C6.90894 26.0067 5.45294 25.0273 4.21466 23.7903C2.97638 22.5533 1.99616 21.0986 1.27402 19.4262C0.551627 17.754 0.19043 15.9671 0.19043 14.0655C0.19043 12.1641 0.551245 10.3765 1.27288 8.70251C1.99451 7.02881 2.97383 5.57281 4.21084 4.33453C5.44785 3.09625 6.90257 2.11604 8.575 1.3939C10.2472 0.6715 12.0341 0.310303 13.9357 0.310303C15.837 0.310303 17.6247 0.67112 19.2986 1.39275C20.9723 2.11438 22.4283 3.0937 23.6666 4.33071C24.9049 5.56772 25.8851 7.02244 26.6073 8.69488C27.3297 10.3671 27.6909 12.1539 27.6909 14.0555C27.6909 15.9569 27.33 17.7446 26.6084 19.4185C25.8868 21.0922 24.9075 22.5482 23.6704 23.7865C22.4334 25.0248 20.9787 26.005 19.3063 26.7271C17.6341 27.4495 15.8472 27.8107 13.9456 27.8107ZM13.9406 26.2829C17.3527 26.2829 20.2428 25.0989 22.6109 22.7308C24.979 20.3627 26.1631 17.4726 26.1631 14.0605C26.1631 10.6484 24.979 7.75833 22.6109 5.39024C20.2428 3.02215 17.3527 1.8381 13.9406 1.8381C10.5286 1.8381 7.63846 3.02215 5.27037 5.39024C2.90228 7.75833 1.71823 10.6484 1.71823 14.0605C1.71823 17.4726 2.90228 20.3627 5.27037 22.7308C7.63846 25.0989 10.5286 26.2829 13.9406 26.2829Z"
+              fill="currentColor"
+            />
+          </svg>
+        </div>
+        <p class="text-sm font-medium">{card.description}</p>
+      </a>
+    ))
+  }
+</div>

src/components/getting-started/send-tokens.astro

@@ -0,0 +1,47 @@
+---
+const title = "Send Tokens Across Chains";
+
+const cards = [
+  {
+    title: "Send Interchain Tokens",
+    description:
+      "Transfer any deployed Interchain Token across supported blockchains with unified API calls and consistent token representation.",
+    url: "/dev/send-tokens/interchain-tokens/integrate-custom-token/#send-tokens-using-the-interchain-transfer-function/",
+  },
+  {
+    title: "Send Gateway Tokens",
+    description:
+      "Move tokens alongside custom messages between chains using GMP for advanced cross-chain applications and composability.",
+    url: "/dev/general-message-passing/gmp-tokens-with-messages/",
+  },
+];
+---
+
+<div class="grid md:grid-cols-2 lg:grid-cols-1 xl:grid-cols-2 not-prose gap-6">
+  {
+    cards.map((card) => (
+      <a
+        class="border-[0.3px] font-clash px-6 flex flex-col gap-6 bg-white dark:bg-background-neutral py-5 rounded-[28px] border-border"
+        href={card.url}
+      >
+        <div class="flex justify-between items-center">
+          <h2 class="text-2xl font-medium flex-1 w-full">{card.title}</h2>
+
+          <svg
+            width="28"
+            height="28"
+            viewBox="0 0 28 28"
+            fill="none"
+            xmlns="http://www.w3.org/2000/svg"
+          >
+            <path
+              d="M16.0971 14.8244L13.4002 17.5217C13.2571 17.6646 13.1905 17.8349 13.2004 18.0328C13.2101 18.2306 13.2865 18.401 13.4296 18.5438C13.5724 18.687 13.7493 18.7585 13.9601 18.7585C14.171 18.7585 14.3446 18.687 14.4811 18.5438L18.1008 14.9245C18.3478 14.6775 18.4713 14.3895 18.4713 14.0605C18.4713 13.7315 18.3478 13.4435 18.1008 13.1965L14.4517 9.54777C14.3088 9.40467 14.1385 9.33311 13.9406 9.33311C13.7428 9.33311 13.5724 9.40467 13.4296 9.54777C13.2865 9.69062 13.2149 9.86746 13.2149 10.0783C13.2149 10.2894 13.2865 10.4631 13.4296 10.5993L16.0971 13.2966H9.35724C9.1408 13.2966 8.95937 13.3699 8.81296 13.5166C8.66654 13.6633 8.59334 13.845 8.59334 14.0617C8.59334 14.2784 8.66654 14.4597 8.81296 14.6056C8.95937 14.7515 9.1408 14.8244 9.35724 14.8244H16.0971ZM13.9456 27.8107C12.0443 27.8107 10.2566 27.4499 8.58264 26.7283C6.90894 26.0067 5.45294 25.0273 4.21466 23.7903C2.97638 22.5533 1.99616 21.0986 1.27402 19.4262C0.551627 17.754 0.19043 15.9671 0.19043 14.0655C0.19043 12.1641 0.551245 10.3765 1.27288 8.70251C1.99451 7.02881 2.97383 5.57281 4.21084 4.33453C5.44785 3.09625 6.90257 2.11604 8.575 1.3939C10.2472 0.6715 12.0341 0.310303 13.9357 0.310303C15.837 0.310303 17.6247 0.67112 19.2986 1.39275C20.9723 2.11438 22.4283 3.0937 23.6666 4.33071C24.9049 5.56772 25.8851 7.02244 26.6073 8.69488C27.3297 10.3671 27.6909 12.1539 27.6909 14.0555C27.6909 15.9569 27.33 17.7446 26.6084 19.4185C25.8868 21.0922 24.9075 22.5482 23.6704 23.7865C22.4334 25.0248 20.9787 26.005 19.3063 26.7271C17.6341 27.4495 15.8472 27.8107 13.9456 27.8107ZM13.9406 26.2829C17.3527 26.2829 20.2428 25.0989 22.6109 22.7308C24.979 20.3627 26.1631 17.4726 26.1631 14.0605C26.1631 10.6484 24.979 7.75833 22.6109 5.39024C20.2428 3.02215 17.3527 1.8381 13.9406 1.8381C10.5286 1.8381 7.63846 3.02215 5.27037 5.39024C2.90228 7.75833 1.71823 10.6484 1.71823 14.0605C1.71823 17.4726 2.90228 20.3627 5.27037 22.7308C7.63846 25.0989 10.5286 26.2829 13.9406 26.2829Z"
+              fill="currentColor"
+            />
+          </svg>
+        </div>
+        <p class="text-sm font-medium">{card.description}</p>
+      </a>
+    ))
+  }
+</div>

src/content/docs/dev/general-message-passing/debug/error-debugging.mdx

@@ -6,7 +6,7 @@ There are two reasons that executions fail:
 
 ### 1. Insufficient gas to execute the transaction
 
-If the prepaid gas is insufficient, you might see `NOT ENOUGH GAS` or other messages indicating the submitted gas is too low to execute, such as `Insufficient gas for executing the transaction`, `intrinsic gas too low`, etc.
+If the prepaid gas is insufficient, for example, this [transaction](https://axelarscan.io/gmp/0x1776026b406ab2aaaedeae83f4a19fc8809000cc8a3b2abd8716587a29460839-1), you might see `NOT ENOUGH GAS` or other messages indicating the submitted gas is too low to execute, such as `Insufficient gas for executing the transaction`, `intrinsic gas too low`, etc.
 
 There are two options to recover the transfer.
 
@@ -21,7 +21,7 @@ If the error is caused by the destination contract logic, you would see followin
 Transaction execution was reverted. Please check the implementation of the destination contract's _execute function.
 ```
 
-**What to do next:** We suggest debugging your contract and then making a new call. You can try to follow the [Debugging your smart contract](/dev/general-message-passing/debug/debugging-your-smart-contract/) guide.
+**What to do next:** We suggest debugging your contract and then making a new call. You can try to follow the [Debugging your smart contract](/dev/general-message-passing/debug/debugging-your-smart-contract/) guide as this is not error an error associated with the Axelar network itself.
 
 <Callout emoji="ℹ️">
   The error message in `reason:` is extracted from the data returned by the

src/content/docs/dev/general-message-passing/executable.mdx

@@ -2,7 +2,7 @@
 
 ## Overview
 
-The Axelar Executable is a component of the Axelar General Message Passing (GMP) flow, allowing the execution of custom logic in response to messages from different blockchains. By simply inheriting from the Axelar Executable your contract can process and respond to incoming cross-chain GMP data.
+The Axelar Executable is a component of the [Axelar General Message Passing (GMP)](/dev/general-message-passing/overview/) flow, allowing the execution of custom logic in response to messages from different blockchains. By simply inheriting from the Axelar Executable your contract can process and respond to incoming cross-chain GMP data.
 
 ## Integration For GMP Executable 
 
@@ -24,7 +24,7 @@ For a [plain GMP executable](/dev/general-message-passing/gmp-tokens-with-messag
 
 ## Integration For GMP With Token Executable
 
-If you are [sending a GMP message with a token](/dev/general-message-passing/gmp-tokens-with-messages/)  and need to handle the executable for a token + gmp msg then you will need to inherit from the [Axelar Executable With Token](https://github.com/axelarnetwork/axelar-gmp-sdk-solidity/blob/b5d0b7bdda0437fce983daffb776669437b809d0/contracts/executable/AxelarExecutableWithToken.sol) contract.
+If you are [sending a GMP message with a token](/dev/general-message-passing/gmp-tokens-with-messages/)  and need to handle the executable for a token + GMP message then you will need to inherit from the [Axelar Executable With Token](https://github.com/axelarnetwork/axelar-gmp-sdk-solidity/blob/b5d0b7bdda0437fce983daffb776669437b809d0/contracts/executable/AxelarExecutableWithToken.sol) contract.
 
 
 1. Import **`AxelarExecutableWithToken`** from the Axelar GMP SDK to enable cross-chain capabilities.
@@ -89,9 +89,9 @@ The AxelarExecutable contract allows developers to override the `_execute` and t
 
 To solve this problem, AxelarExecutable triggers the Axelar Gateway’s [validateContractCall()](https://github.com/axelarnetwork/axelar-cgp-solidity/blob/8b0ea6693178457b7c155b1efb3ecba6236857cc/contracts/AxelarGateway.sol#L233) function. This function will validate that the incoming message was approved by the Axelar validators and return true if it was. It will then mark the message as a valid to ensure that it is not called more than once. Only once the message is marked as valid will your `_execute()` function be triggered.
 
-By simply inheriting AxelarExecutable and overriding the `_execute()` function defined their you can be confident that the message you’re receiving is an authentic message from the Axelar network.
+By simply inheriting `AxelarExecutable` and overriding the `_execute()` function defined their you can be confident that the message you’re receiving is an authentic message from the Axelar network.
 
-## Upgradeable Contracts
+## Upgradable Contracts
 
 If your contract is upgradeable then you may be unable to inherit from AxelarExecutable as it implements a `constructor` . To get around this issue you can simply call the external `execute()` function (or `executeWithToken()`). By simply making the `execute()` function available the relayer will still trigger this function on your contract and it will run the same way the internal `_execute()` function would if you were overriding from AxelarExecutable. The catch is that the `validateContractCall()` function will not be automatically implemented the way it would be if you were inheriting from AxelarExecutable. To get around this problem simply make sure you implement the `validateContractCall()` functionality yourself in your `execute()` function to ensure the authenticity of the incoming message. Once implemented your `execute()` function should look like this