Language updates (#18)

* updated required packages

* update fund nd payment flows

* updated use-cases

* updated sdk pages

* removed explicit gasless param

* updated sdk

Author: JamesLawton

architecture/pricing-fees.mdx

@@ -7,7 +7,9 @@ icon: 'diagram-project'
 
 ## Fee Model
 
-The protocol is free to integrate for any app. 
+The protocol is free to integrate for any app. The fee for Trails is paid by the end-user which includes:
 
-Trails has a fee model competitive with the market which consists of a percentage of the transaction volume exchanged when orchestrating a transaction paid by the user when a bridge or swap is part of the orchestration. Notably, these are not static and scale down significantly with the value transacted, therefore higher transaction volume amounts will result in less fees for the user.
+- Gas fees on the origin and destination chains
+- Included fees for liquidity providers or bridges
+- Trails protocol fee which scales significantly down with the amount of volume (in USD) transacted
 

docs.json

@@ -17,7 +17,7 @@
     "global": {
       "anchors": [
         {
-          "anchor": "Playground",
+          "anchor": "Demo Playground",
           "icon": "square-terminal",
           "href": "https://demo.trails.build/widget"
         }
@@ -52,7 +52,6 @@
             "group": "Examples",
             "pages": [
               "examples/receive",
-              "examples/gasless",
               "examples/alt-fee-tokens",
               "examples/wallet-compatibility",
               "examples/transaction-history",
@@ -81,13 +80,14 @@
             "pages": [
               "sdk/get-started",
               "sdk/configuration",
+              "sdk/hooks",
               {
                 "group": "Modes",
-                "pages": ["sdk/modes/pay", "sdk/modes/fund", "sdk/modes/swap", "sdk/modes/receive"]
+                "pages": ["sdk/modes/pay", "sdk/modes/fund", "sdk/modes/swap", "sdk/modes/earn"]
               },
               "sdk/theming",
-              "sdk/gasless",
-              "sdk/hooks"
+              "sdk/quote-providers",
+              "sdk/tokens-and-chains"
             ]
           }
         ]

get-started.mdx

@@ -10,27 +10,31 @@ sidebarTitle: "Getting Started"
   </Card>
 
   <Card title="React Starter Kit" icon="code" href="https://github.com/0xsequence-demos/trails-starter">
-    Minimal template for Trails with Earn, Swap, Pay, and Fund modes integrated.
+    Minimal React template for Trails with Earn, Swap, Pay, and Fund modes integrated.
+  </Card>
+
+  <Card title="NextJS Starter Kit" icon="code" href="https://github.com/0xsequence-demos/trails-nextjs-starter">
+    Minimal NextJS template for Trails with Earn, Swap, Pay, and Fund modes integrated.
   </Card>
 </div>
 
 
 
 To install on your own application:
 <Steps>
-  <Step title="Install the SDK">
+  <Step title="Install the SDK and dependencies">
     <CodeGroup>
     ```shell pnpm
-    pnpm i 0xtrails
+    pnpm i 0xtrails wagmi viem
     ```
     ```shell npm
-    npm install --save 0xtrails
+    npm install --save 0xtrails wagmi viem
     ```
     ```shell yarn
-    yarn add 0xtrails
+    yarn add 0xtrails wagmi viem
     ```
     ```shell bun
-    bun add 0xtrails
+    bun add 0xtrails wagmi viem
     ```
     </CodeGroup>
   </Step>
@@ -44,7 +48,8 @@ To install on your own application:
     export const App = () => {
       return (
         <TrailsWidget
-          toAddress="0x97c4A952b46bEcaD0663f76357d3776ba11566E1"
+          mode="fund"
+          toAddress="0x97c4A952b46bEcaD0663f76357d3776ba11566E1" // contract or wallet address of recipient
           toAmount="1" 
           toChainId={8453}
           toToken="USDC"
@@ -57,35 +62,13 @@ To install on your own application:
 
 
 ## Next steps
+Trails is optimized for a variety of common use cases or flows for your application:
 
-- [Pay](/use-cases/pay): Buy NFTs, RWAs, or any asset using any token from any chain; Trails aggregates balances and handles bridging, swapping, and execution.
-- [Swap](/use-cases/swap): Cross-chain token swaps in a single confirmation with unified liquidity and optimal routing—no manual bridging or DEX hopping.
-- [Fund](/use-cases/fund): Deposit into a chain, app, or protocol from any token on any chain in one flow; Trails optimizes routes and handles swaps/bridges.
-- [Earn](/use-cases/earn): Deposit into vaults/pools (e.g., Aave) with automatic swap/bridge to the required asset; confirm once and start earning.
-
-- [Configuration](/sdk/configuration): Full list of variables to customize Trails including different modes, theming, enabling gasless transactions, events, and quote providers.
-
-
-## Script Import
-
-While we recommend using the React component, you can also embed via a script tag in a non-React site.
-
-```html
-<div id="trails"></div>
-<script src="https://cdn.jsdelivr.net/npm/0xtrails@latest/dist/umd/trails.min.js"></script>
-<script>
-  TrailsWidget.render(document.getElementById('trails'), {
-    toAddress: '0x...',
-    toAmount: '0.1',
-    toChainId: 8453,
-    toToken: '0xUSDC...'
-  })
-</script>
-```
-
-### Available CDNs
+- **[Pay](/use-cases/pay)**: Enable cross-chain, 1-click payments with any token for ecommerce platforms, NFT marketplaces, real-world asset purchases, and minimal-slippage stablecoin transactions.
+- **[Swap](/use-cases/swap)**: Embed low-latency, highly liquid cross-chain token swaps for your applications.
+- **[Fund](/use-cases/fund)**: Maximize TVL and transaction velocity through fully brandable funding widgets for protocol deposits such as perpetual exchanges, chain deposits, and liquidity provisioning. 
+- **[Earn](/use-cases/earn)**: Streamline DeFi yield opportunities by enabling deposits from your app into already integrated tokenized vaults, lending pools, and yield strategies from any token on any chain.
+- [Configuration](/sdk/configuration): Full list of variables & hooks to customize Trails including different modes, theming, enabling gasless transactions, events, and quote providers.
 
-- **unpkg**: `https://unpkg.com/0xtrails@latest/dist/umd/trails.min.js`
-- **jsDelivr**: `https://cdn.jsdelivr.net/npm/0xtrails@latest/dist/umd/trails.min.js`
 
 For production use, pin to a specific version by replacing `@latest` with `@1.0.0` or your desired version. 

intro.mdx

@@ -1,50 +1,49 @@
 ---
 title: What is Trails
-description: Intent powered multichain transaction rails to pay, swap, fund, or earn in 1-click with any wallet, token or chain.
+description: Multichain transaction rails to pay, swap, fund, or earn in 1-click with any wallet, token or chain - powered by intents.
 ---
 
 
 ## Overview
 
-Trails is a multi-chain orchestration protocol that enables 1-click simplified and fast transactions from any wallet seamlessly with unified user liquidity across all chains.
-In contrast to typical cross-chain offerings, Trails sources liquidity and aggregates all user balances for every token across every chain in a user's wallet
-as options for any transaction (ie. payment) on a destination chain. Trails is architected as a trustless system that
+Trails is a chain abstraction orchestration protocol that enables 1-click transactions from any wallet seamlessly with unified user liquidity across all chains.
+In contrast to typical cross-chain solutions, Trails sources liquidity and aggregates all user balances for every token across every chain in a user's wallet
+as options for any transaction on a destination chain. Trails is architected as a trustless system that
 works on top of existing bridging, filler, or solver infrastructure. Trails is free to integrate and is optimized for a variety of use cases, for example:
 
 - **[Pay](/use-cases/pay)**: Enable cross-chain, 1-click payments with any token for ecommerce platforms, NFT marketplaces, real-world asset purchases, and minimal-slippage stablecoin transactions.
-- **[Swap](/use-cases/swap)**: Embed low-latency, highly liquid cross-chain token swaps for DeFi applications, portfolio management tools, and trading platforms
-- **[Fund](/use-cases/fund)**: Maximize TVL and transaction velocity through fully brandable funding widgets for protocol deposits, chain onboarding, and liquidity provisioning
+- **[Swap](/use-cases/swap)**: Embed low-latency, highly liquid cross-chain token swaps for your applications.
+- **[Fund](/use-cases/fund)**: Maximize TVL and transaction velocity through fully brandable funding widgets for protocol deposits such as perpetual exchanges, chain deposits, and liquidity provisioning. 
 - **[Earn](/use-cases/earn)**: Streamline DeFi yield opportunities by enabling deposits into tokenized vaults, lending pools, and yield strategies from any token on any chain
 
 ## Key Features
 
 ### 1-click transactions
-- Payments occur in a single confirmation with any wallet, regardless if it's an EOA, account abstraction wallet, or EIP-7702 enabled.
-- Developers simply specify payment intent (e.g., "purchase NFT #123 with 30 USDC") for a user to confirm.
-- Built-in multichain real-time indexing to automatically return user's wallet balances & prices. No additional vendor license required.
+- Transactions occur in a single confirmation with any wallet, regardless if it's an EOA, account abstraction wallet, or EIP-7702 enabled.
+- Developers simply specify payment intent (e.g., "purchase NFT #123 with 30 USDC") and a user can select any token across their wallet balance to pay.
 
 ### Universal User Liquidity
-- Aggregates all user balances across every token and chain as payment options.
+- Built-in multichain, real-time indexing to automatically return user's wallet balances & prices. No third-party dependencies necessary.
 - Leveraging existing liquidity infrastructure such as DEX's, bridges, or aggregators, we support a vast array of tokens and chains.
 
 ### Blazing Fast
 - Fast from anywhere, even with payments across chains using our intent-based architecture & relayer infrastructure.
-- Protocol intelligently detects optimal route for payment fulfillment.
+- Protocol intelligently detects optimal route for payment fulfillment and presents to the user in a streamlined UX.
 
 ### Scalable
 - Trails can leverage virtually any existing cross-chain or liquidity infrastructure, including bridges, aggregators, and more.
 - Relayer & Indexing infrastructure is lightweight and easily deployable to new chains.
 
 ## How Trails Works
 
-1. **Define Intent (App)**: Create a payment transaction (mint, deposit, swap, etc) for any chain in any token.
-2. **Trails Inspects (Trails SDK)**: Can this succeed with the assets held on current chain? Yes = Pass through. No = Continue Orchestration.
-3. **Select Route (User)**: Trails presents an aggregated balance of the user's assets across all chains for the user to select from.
-4. **Orchestrate Transaction (Trails SDK)**: Intelligently combines and optimizes swap + bridge + execute for the selected route to fulfill the transaction.
-5. **Execute Transaction (Trails Intents)**: User confirms transaction via their wallet which executes the end to end to flow for the selected payment.
+1. **App Defines Intent**: Create a payment transaction (mint, deposit, swap, etc) for any chain in any token.
+2. **Trails SDK Inspects**: Can this succeed with the assets held on current chain? Yes = Pass through. No = Continue Orchestration.
+3. **User Selects Route**: Trails presents an aggregated balance of the user's assets across all chains for the user to select from.
+4. **Trails Orchestrates Transaction**: Intelligently combines and optimizes swap + bridge + execute for the selected route to fulfill the transaction.
+5. **Execute Transaction**: User confirms transaction via their wallet which executes the end to end to flow for the selected payment.
 
 This architecture enables developers to build sophisticated transaction experiences while abstracting the underlying complexity of multichain operations. All you have to do is specify what transaction and any payment options to execute
-on a destination chain.
+on a destination chain. Developers can pass in calldata to execute any arbitrary smart contract functions.
 
 ### Working with Trails
 
@@ -55,7 +54,7 @@ and does not require EIP-7702 enabled wallets. For more information please read
 
 ## Quickstart
 
-Looking to integrate? [Get started](/get-started) and build natively cross-chain in minutes.
+Looking to integrate? [Get started](/get-started) and build your app natively cross-chain in minutes.
 
 ## Who Built Trails?
 

overview/1-click-payments.mdx

@@ -29,7 +29,7 @@ Trails enables 1-click payments through an intent-based architecture that is abl
    A unique intent contract address is computed based on the full transaction orchestration across multiple chains. The intent address encodes the details of both transactions on both the origin and destination
    chains.
 
-3. **Origin Deposit**  
+3. **Origin Transfer**  
    The user sends a single transaction to deposit their tokens (from any chain they hold funds on) into the intent address on the origin chain. Importantly, the user's wallet has full control over this intent address.
 
 4. **Origin Chain Execution**  
@@ -55,7 +55,7 @@ import { TrailsWidget } from '0xtrails/widget'
 export const CrossChainPayment = () => {
   return (
     <TrailsWidget
-      toAddress="0x..." // recipient wallt address
+      toAddress="0x..." // recipient address
       toAmount="0.1"
       toChainId={8453} // Base
       toToken="USDC"

overview/chain-abstraction.mdx

@@ -1,15 +1,15 @@
 ---
-title: 'Unified User Liquidity'
+title: 'Chain Abstraction'
 description: 'Trails abstracts away complexities of interacting with multiple blockchain networks as well as aggregating balances from these chains for universal buying power.'
 icon: 'layer-group'
 ---
 
 
-## Maximizing Buying Power
+## Universal User Liquidity
 
-User wallet balances are typically fragmented across multiple networks. Not only is this cumbersome from a user experience perspective to manage where funds are held, this also limits the buying power on applications for any given payment as I can only use the funds on a single source chain at any time.
+Current user wallet balances are fragmented across multiple chains, wallets, tokens. Not only is this cumbersome from a user experience perspective to manage where funds are held, this also limits the buying power on applications for any given payment as a user can only use the funds on a single source chain at any time.
 
-In contrast, Trails is a chain-abstracted solution that hides the complexity of multiple blockchains from both developers and end users, creating a unified experience that feels like interacting with a single blockchain with a single, aggregated balance.
+In contrast, Trails is a chain abstraction solution that simplifies the complexity of interacting with multiple blockchains from both developers and end users. This creates a unified experience for apps that enables users to pay with any token on any chain unlocking their full purchasing power.
 
 ## Cross-Chain vs Chain Abstraction
 
@@ -40,21 +40,20 @@ The standard cross-chain experience requires users to be aware of and manage mul
 Trails is a chain abstraction solution that eliminates these complexities by:
 
 - **Universal Buying Power**: Applications can enable users to pay in every token from every chain for any arbitrary payment, i.e., an NFT costs 60 USDC on Base, a user can purchase it using 30 USDC on Optimism and 30 Arbitrum seamlessly.
-- **Unified User Interface**: Single point of interaction across all chains
-- **Gasless Transactions**: Users don't need to hold specific gas tokens to interact across chains
+- **Unified User Interface**: Single point of interaction across all chains. All app interactions can funnel through Trails to simplify flows.
+- **Pay Gas in More Tokens**: Users don't need to hold specific gas tokens to interact across chains, any permit-compatible token can be used for end to end transactions.
 - **Failure Recovery**: Built-in mechanisms to handle and recover from failed transactions
 
-With chain abstraction, users interact with a unified layer that automatically handles all the underlying blockchain complexity with simple integration with Trails for developers - optimized for payments.
+With chain abstraction, users interact with a unified layer that automatically handles all the underlying blockchain complexity with simple integration with Trails in their application.
 
 
 ## Unifying the Modular Ecosystem
 
 Chain abstraction through Trails realizes the vision of modular blockchain networks, by unifying fragmented liquidity, enhancing buying power for users, and simplifying integration across networks.
 
-By simplifying the payment process and removing the need for users to manually manage assets across different chains, Trails significantly reduces friction, which can lead to lower churn and cart abandonment rates.
+By simplifying the transaction process and removing the need for users to manually manage assets across different chains, Trails significantly reduces friction, which can lead to lower churn and higher transaction volume.
 
 ## Coming Soon
 
 - **Multi-token payments**: Pay with multiple tokens in a single transaction.
-- **Gas abstraction**: Pay for gas in any token.