Add Fiat on ramp section

abstract-global-wallet/fiat-on-ramp/config.mdx

@@ -0,0 +1,187 @@
+---
+title: "/config"
+api: "GET https://onramp.staging-portal.abs.xyz/config"
+description: "Return a list of countries, purchase limits, and service providers available for onramp."
+---
+
+## Response
+
+<ResponseField name="countries" type="array" required>
+  Array of supported countries with their regions and default currencies
+  <Expandable title="countries">
+    <ResponseField name="countryCode" type="string" required>
+      The ISO 3166 2-digit country code
+    </ResponseField>
+    <ResponseField name="name" type="string" required>
+      The display name for the Country
+    </ResponseField>
+    <ResponseField name="flagImageUrl" type="string" required>
+      The URL to the Country's flag image
+    </ResponseField>
+    <ResponseField name="regions" type="array | null">
+      The set of supported regions within the Country. If null, then all regions within the Country are supported
+      <Expandable title="regions">
+        <ResponseField name="regionCode" type="string" required>
+          The alphanumeric code (ISO 3166-2) for the Region
+        </ResponseField>
+        <ResponseField name="name" type="string" required>
+          The display name for the Region
+        </ResponseField>
+      </Expandable>
+    </ResponseField>
+    <ResponseField name="defaultFiatCurrency" type="string" required>
+      The currency code for the default currency of this country
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="limits" type="array" required>
+  Array of purchase limits by currency
+  <Expandable title="limits">
+    <ResponseField name="currencyCode" type="string" required>
+      The currency code
+    </ResponseField>
+    <ResponseField name="defaultAmount" type="number" required>
+      The default purchase amount
+    </ResponseField>
+    <ResponseField name="minimumAmount" type="number" required>
+      The minimum purchase amount
+    </ResponseField>
+    <ResponseField name="maximumAmount" type="number" required>
+      The maximum purchase amount
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="serviceProviders" type="array" required>
+  Array of available service providers
+  <Expandable title="serviceProviders">
+    <ResponseField name="serviceProvider" type="string" required>
+      Service provider identifier
+    </ResponseField>
+    <ResponseField name="name" type="string" required>
+      Display name of the service provider
+    </ResponseField>
+    <ResponseField name="status" type="string" required>
+      Current status of the provider
+    </ResponseField>
+    <ResponseField name="categories" type="array" required>
+      Array of service categories
+    </ResponseField>
+    <ResponseField name="categoryStatuses" type="object" required>
+      Status of each category
+    </ResponseField>
+    <ResponseField name="websiteUrl" type="string" required>
+      Provider's website URL
+    </ResponseField>
+    <ResponseField name="customerSupportUrl" type="string" required>
+      Provider's customer support URL
+    </ResponseField>
+    <ResponseField name="logos" type="object" required>
+      Provider logos for different themes
+      <Expandable title="logos">
+        <ResponseField name="dark" type="string" required>
+          Dark theme logo URL
+        </ResponseField>
+        <ResponseField name="light" type="string" required>
+          Light theme logo URL
+        </ResponseField>
+        <ResponseField name="darkShort" type="string" required>
+          Dark theme short logo URL
+        </ResponseField>
+        <ResponseField name="lightShort" type="string" required>
+          Light theme short logo URL
+        </ResponseField>
+      </Expandable>
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+
+```bash cURL
+curl -X GET "https://onramp.staging-portal.abs.xyz/config"
+```
+
+```javascript JavaScript
+const response = await fetch('https://onramp.staging-portal.abs.xyz/config');
+const config = await response.json();
+```
+
+</RequestExample>
+
+<ResponseExample>
+
+```json Response
+{
+  "countries": [
+    {
+      "countryCode": "CA",
+      "name": "Canada",
+      "flagImageUrl": "https://images-country.meld.io/CA/flag.svg",
+      "regions": [
+        {
+          "regionCode": "CA-AB",
+          "name": "Alberta"
+        },
+        {
+          "regionCode": "CA-BC",
+          "name": "British Columbia"
+        }
+      ],
+      "defaultFiatCurrency": "CAD"
+    },
+    {
+      "countryCode": "US",
+      "name": "United States",
+      "flagImageUrl": "https://images-country.meld.io/US/flag.svg",
+      "regions": [
+        {
+          "regionCode": "US-CA",
+          "name": "California"
+        },
+        {
+          "regionCode": "US-NY",
+          "name": "New York"
+        }
+      ],
+      "defaultFiatCurrency": "USD"
+    }
+  ],
+  "limits": [
+    {
+      "currencyCode": "CAD",
+      "defaultAmount": 400,
+      "minimumAmount": 15.64,
+      "maximumAmount": 23303.6
+    },
+    {
+      "currencyCode": "USD",
+      "defaultAmount": 300,
+      "minimumAmount": 9.18,
+      "maximumAmount": 17094.78
+    }
+  ],
+  "serviceProviders": [
+    {
+      "serviceProvider": "TRANSAK",
+      "name": "Transak",
+      "status": "LIVE",
+      "categories": ["CRYPTO_ONRAMP"],
+      "categoryStatuses": {
+        "CRYPTO_ONRAMP": "LIVE"
+      },
+      "websiteUrl": "https://transak.com",
+      "customerSupportUrl": "",
+      "logos": {
+        "dark": "https://images-serviceprovider.meld.io/TRANSAK/logo_dark.png",
+        "light": "https://images-serviceprovider.meld.io/TRANSAK/logo_light.png",
+        "darkShort": "https://images-serviceprovider.meld.io/TRANSAK/short_logo_dark.png",
+        "lightShort": "https://images-serviceprovider.meld.io/TRANSAK/short_logo_light.png"
+      }
+    }
+  ]
+}
+```
+
+</ResponseExample>

abstract-global-wallet/fiat-on-ramp/currencies.mdx

@@ -0,0 +1,114 @@
+---
+title: "/currencies"
+api: "GET https://onramp.staging-portal.abs.xyz/currencies"
+description: "Return a list of FIAT and crypto currencies for the provided country."
+---
+
+## Query Parameters
+
+<ParamField query="country" type="string" required>
+  The ISO 3166 2-digit country code
+</ParamField>
+
+## Response
+
+<ResponseField name="fiat" type="array" required>
+  Array of supported fiat currencies
+  <Expandable title="fiat">
+    <ResponseField name="currencyCode" type="string" required>
+      The code for this Fiat Currency
+    </ResponseField>
+    <ResponseField name="name" type="string" required>
+      The display name for this Fiat Currency
+    </ResponseField>
+    <ResponseField name="symbolImageUrl" type="string" required>
+      The URL to this Fiat Currency's symbol image
+    </ResponseField>
+    <ResponseField name="symbol" type="string" required>
+      The ASCII symbol for this Fiat Currency
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="crypto" type="array" required>
+  Array of supported crypto currencies
+  <Expandable title="crypto">
+    <ResponseField name="currencyCode" type="string" required>
+      The code for the Crypto Currency
+    </ResponseField>
+    <ResponseField name="name" type="string" required>
+      The display name for the Crypto Currency
+    </ResponseField>
+    <ResponseField name="chainCode" type="string" required>
+      The code for the chain the Crypto Currency is on
+    </ResponseField>
+    <ResponseField name="chainName" type="string" required>
+      The display name for the chain the Crypto Currency is on
+    </ResponseField>
+    <ResponseField name="chainId" type="string | null" required>
+      The id for the chain the Crypto Currency is on
+    </ResponseField>
+    <ResponseField name="contractAddress" type="string | null" required>
+      The contract address of the Crypto Currency
+    </ResponseField>
+    <ResponseField name="symbolImageUrl" type="string" required>
+      The URL to the Crypto Currency's symbol image
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<RequestExample>
+
+```bash cURL
+curl -X GET "https://onramp.staging-portal.abs.xyz/currencies?country=US"
+```
+
+```javascript JavaScript
+const response = await fetch('https://onramp.staging-portal.abs.xyz/currencies?country=US');
+const currencies = await response.json();
+```
+
+</RequestExample>
+
+<ResponseExample>
+
+```json Response
+{
+  "fiat": [
+    {
+      "currencyCode": "USD",
+      "name": "US Dollar",
+      "symbolImageUrl": "https://images-currency.meld.io/fiat/USD/symbol.png",
+      "symbol": "$"
+    },
+    {
+      "currencyCode": "EUR",
+      "name": "Euro",
+      "symbolImageUrl": "https://images-currency.meld.io/fiat/EUR/symbol.png",
+      "symbol": "€"
+    }
+  ],
+  "crypto": [
+    {
+      "currencyCode": "ETH_BASE",
+      "name": "Ethereum",
+      "chainCode": "BASE",
+      "chainName": "Base",
+      "chainId": null,
+      "contractAddress": null,
+      "symbolImageUrl": "https://images-currency.meld.io/crypto/ETH_BASE/symbol.png"
+    },
+    {
+      "currencyCode": "USDC_BASE",
+      "name": "USD Coin",
+      "chainCode": "BASE",
+      "chainName": "Base",
+      "chainId": null,
+      "contractAddress": null,
+      "symbolImageUrl": "https://images-currency.meld.io/crypto/USDC_BASE/symbol.png"
+    }
+  ]
+}
+```
+
+</ResponseExample>

abstract-global-wallet/fiat-on-ramp/overview.mdx

@@ -0,0 +1,88 @@
+---
+title: "FIAT On-ramp"
+sidebarTitle: "Overview"
+description: "Learn how to allow users to fund their Abstract Global Wallet with FIAT currencies."
+---
+
+To provide a consumer-friendly onboarding experience to non-crypto-native users,
+Abstract supports a FIAT on-ramp powered by [Meld](https://www.meld.io/). 
+
+This enables users in over 200 countries to fund their Abstract Global Wallet using their local currency via a credit card, Apple Pay, or Google Pay.
+
+<CardGroup cols={2}>
+  <Card
+        title="FIAT On-ramp Demo Application"
+        icon="play"
+        href="https://agw-onramp.vercel.app/"
+    >
+        View a demo application that uses AGW and FIAT on-ramp to test the flow.
+    </Card>
+    <Card
+        title="AGW + FIAT On-ramp Example Repo"
+        icon="github"
+        href="https://github.com/Abstract-Foundation/examples/pull/52"
+    >
+        Use our example repo to quickly get started with AGW and FIAT on-ramp.
+    </Card>
+</CardGroup>
+
+## How it works
+
+The FIAT on-ramp works by presenting users with a **widget** that prompts the user for their payment details to fulfill a **quote**. The quote determines the amount, address, currency, and other details of the transaction.
+
+This flow can be broken down into three steps:
+
+<Steps>
+    <Step title="Collecting User Information">
+    To generate a **quote**, information about the user and their desired on-ramp transaction is required, including the user&rsquo;s country, wallet address, desired amount, etc. (see [/quote](/abstract-global-wallet/fiat-on-ramp/quote) for more details).
+
+    Present users with a form to collect the required information, making use of the below endpoints to localize and validate the user&rsquo;s input:
+
+    - [/config](/abstract-global-wallet/fiat-on-ramp/config) to get the user&rsquo;s country and local currency information.
+    - [/currencies](/abstract-global-wallet/fiat-on-ramp/currencies) to get the available currencies for the user&rsquo;s country.
+    - [/payment-methods](/abstract-global-wallet/fiat-on-ramp/payment-methods) to get the available payment methods for the user&rsquo;s country.
+    </Step>
+
+    <Step title="Fetching Quotes">
+    After collecting the required information from the user, call the [/quote endpoint](/abstract-global-wallet/fiat-on-ramp/quote) to get an array of quotes from providers that can fulfill the given request.
+
+    Choose *(or allow the user to choose)* the best quote for your application&rsquo;s needs.
+    </Step>
+
+    <Step title="Fulfilling the Quote">
+    Provide your selected quote to the [/widget endpoint](/abstract-global-wallet/fiat-on-ramp/widget) to generate a widget URL that can be either opened directly or embedded in your application using an iframe.
+
+    The widget URL presents the user with a form to enter their payment details and complete the transaction. Use the [/transactions endpoint](/abstract-global-wallet/fiat-on-ramp/transactions) to track the status of their order using the session ID returned from the widget.
+    </Step> 
+
+</Steps>
+
+Under the hood, funds are first loaded to a temporary deposit address on the [Base network](https://www.base.org/) before being bridged to the desired destination address on Abstract.
+
+
+## API Overview
+
+Abstract provides a simplified API to help you integrate the FIAT on-ramp into your application.
+
+### Base URLs
+
+It is recommended to use the staging environment for testing and development.
+
+| Staging | Production |
+|---------|------------|
+| `https://onramp.staging-portal.abs.xyz/` | `https://onramp.portal.abs.xyz/` |
+
+### Endpoints
+
+Below is a summary of the available endpoints.
+
+| Endpoint | Description |
+|----------|-------------|
+| [/config](/abstract-global-wallet/fiat-on-ramp/config) | Return a list of countries, purchase limits, and service providers available for on-ramp. |
+| [/currencies](/abstract-global-wallet/fiat-on-ramp/currencies) | Return a list of FIAT and crypto currencies for the provided country. |
+| [/payment-methods](/abstract-global-wallet/fiat-on-ramp/payment-methods) | Return a list of payment methods for the provided country. |
+| [/quote](/abstract-global-wallet/fiat-on-ramp/quote) | Generate quotes for purchasing cryptocurrency with FIAT currency. |
+| [/transactions](/abstract-global-wallet/fiat-on-ramp/transactions) | Get on-ramp transaction status and history. |
+| [/widget](/abstract-global-wallet/fiat-on-ramp/widget) | Create a session for buying crypto with FIAT currency. |
+
+