# Quick Start

## Get Started with Goliath in Minutes

This guide will help you connect to Goliath, set up your wallet, and make your first transaction. Choose your network below:

* [**Goliath Mainnet**](#connect-to-goliath-mainnet) - Live network for real transactions
* [**Goliath Testnet**](#connect-to-goliath-testnet) - Test network for development and experimentation

***

## Connect to Goliath Mainnet

### Add Goliath Mainnet to MetaMask

1. Open MetaMask and click on the network dropdown (top center)
2. Select "Add Network" -> "Add Network Manually"
3. Enter the following details:

| Field                  | Value                                                          |
| ---------------------- | -------------------------------------------------------------- |
| **Network Name**       | Goliath Mainnet                                                |
| **RPC URL**            | [`https://rpc.goliath.net`](https://rpc.goliath.net)           |
| **Chain ID**           | `327`                                                          |
| **Currency Symbol**    | `XCN`                                                          |
| **Block Explorer URL** | [`https://explorer.goliath.net`](https://explorer.goliath.net) |

4. Click "Save"
5. Switch to "Goliath Mainnet" from the network dropdown

### Use Onyx App

[**Onyx App**](https://app.onyx.org) is the single entry point for DeFi on Goliath Mainnet:

* **Swap** - Trade tokens on the built-in DEX
* **Bridge** - Transfer ETH, USDC, or XCN between Ethereum and Goliath
* **Liquid Staking** - Stake XCN and earn rewards

For full details, see the [Onyx App documentation](https://docs.goliath.net/defi/onyx-app).

### Mainnet Resources

| Resource                | Link                                                     |
| ----------------------- | -------------------------------------------------------- |
| **Block Explorer**      | [explorer.goliath.net](https://explorer.goliath.net)     |
| **Validator Dashboard** | [validators.goliath.net](https://validators.goliath.net) |
| **DeFi App**            | [app.onyx.org](https://app.onyx.org)                     |
| **JSON-RPC Endpoint**   | `https://rpc.goliath.net`                                |

***

## Connect to Goliath Testnet

The testnet is ideal for developers and anyone who wants to experiment without using real assets. The entire setup takes less than 5 minutes!

## 📱 Step 1: Install MetaMask

MetaMask is the most popular Web3 wallet that allows you to interact with the Goliath network.

### Installation Options:

* **🌐 Browser Extension**:
  * [Chrome/Brave](https://chrome.google.com/webstore/detail/metamask/)
  * [Firefox](https://addons.mozilla.org/firefox/addon/ether-metamask/)
  * [Edge](https://microsoftedge.microsoft.com/addons/detail/metamask/)
* **📱 Mobile App**:
  * [iOS App Store](https://apps.apple.com/app/metamask/)
  * [Android Play Store](https://play.google.com/store/apps/details?id=io.metamask)

### First Time Setup:

1. Click "Create a new wallet"
2. Create a strong password
3. **IMPORTANT**: Securely save your 12-word recovery phrase
4. Confirm your recovery phrase
5. Your wallet is ready!

> ⚠️ **Security Tip**: Never share your recovery phrase with anyone. Store it offline in a secure location.

## 🌐 Step 2: Add Goliath Testnet to MetaMask

### Option A: Automatic Configuration (Recommended)

1. Visit the [**Goliath Testnet Explorer**](https://testnet.explorer.goliath.net)
2. Look for the "Add to MetaMask" button in the footer or navigation
3. Click it and approve the network addition in MetaMask

### Option B: Manual Configuration

1. Open MetaMask and click on the network dropdown (top center)
2. Select "Add Network" -> "Add Network Manually"
3. Enter the following details:

| Field                  | Value                                                                          |
| ---------------------- | ------------------------------------------------------------------------------ |
| **Network Name**       | Goliath Testnet                                                                |
| **RPC URL**            | [`https://rpc.testnet.goliath.net`](https://rpc.testnet.goliath.net)           |
| **Chain ID**           | `8901`                                                                         |
| **Currency Symbol**    | `XCN`                                                                          |
| **Block Explorer URL** | [`https://testnet.explorer.goliath.net`](https://testnet.explorer.goliath.net) |

4. Click "Save"
5. Switch to "Goliath Testnet" from the network dropdown

## 💰 Step 3: Get Test XCN Tokens

To interact with Goliath and Slingshot modules, you'll need test assets for gas and cross-chain testing.

### Getting Test Tokens:

**Testnet Faucet Bot:**

1. Copy your wallet address from MetaMask (click on your account name)
2. Open the [**Goliath Testnet Faucet Bot**](https://t.me/GoliathFaucetBot) on Telegram
3. Use one of the following commands:
   * `/request <ADDRESS>`
   * `/request <ADDRESS> sepoliaxcn`
   * `/request <ADDRESS> sepoliaxcn staked`
4. `/request <ADDRESS>` provides XCN on Goliath, XCN on Sepolia, and ETH/BTC on Goliath
5. Wait for confirmation from the bot, then check your balances on the target network

> 🎉 **Tip**: Request both Goliath and Sepolia assets when testing `Swap`, `Bridge`, and `Migrate` in Slingshot.

## ✨ Step 4: Make Your First Transaction

### Send a Test Transaction:

1. In MetaMask, click "Send"
2. Enter a recipient address (you can use your own address for testing)
3. Enter amount: `0.1 XCN`
4. Review the transaction:
   * **Amount**: 0.1 XCN
   * **Gas Fee**: \~0.0001 XCN (extremely low!)
5. Click "Confirm"
6. Transaction complete in \~3 seconds! ⚡

### View Your Transaction:

1. Click on the transaction in MetaMask
2. Select "View on block explorer"
3. See detailed information including:
   * Transaction hash
   * Block number
   * Timestamp
   * Gas used
   * Transaction status

## 🎯 What's Next?

### Explore the Network:

* [**Block Explorer**](https://testnet.explorer.goliath.net) - View all network activity
* [**Network Statistics**](https://testnet.explorer.goliath.net/stats) - Real-time network metrics
* [**Token Transfers**](https://testnet.explorer.goliath.net/tokens) - Track token movements

### For Developers:

* [**Deploy Smart Contracts**](https://docs.goliath.net/developer-guide/deploying-contracts) - Start building on Goliath
* [**Connect Your dApp**](https://docs.goliath.net/apis/evm-json-rpc) - Integrate with Web3 applications
* [**Development Tools**](https://docs.goliath.net/developer-guide/getting-started) - Set up your development environment

### Advanced Features:

* [**Staking XCN**](https://github.com/Onyx-Protocol/goliath-docs/blob/main/tokenomics/staking.md) - Earn rewards by staking
* [**Native Tokens**](https://github.com/Onyx-Protocol/goliath-docs/blob/main/services/native-tokens.md) - Create your own tokens
* [**File Storage**](https://github.com/Onyx-Protocol/goliath-docs/blob/main/services/file-storage.md) - Decentralized storage solutions

## 🆘 Troubleshooting

### Common Issues:

**Cannot connect to network:**

* Ensure RPC URL is correct: `https://rpc.testnet.goliath.net`
* Check your internet connection
* Try switching networks and switching back

**Transaction fails with INSUFFICIENT\_GAS:**

* This happens when sending to a brand-new address that has never received XCN on Goliath. The chain creates the account automatically ("lazy-create"), which requires \~587,000 gas instead of 21,000.
* Clear MetaMask activity data: Settings > Advanced > Clear activity & nonce data
* Retry the transaction -- MetaMask will re-estimate the gas correctly
* For developers: see the [Lazy Account Creation Guide](https://docs.goliath.net/developer-guide/lazy-create-gas)

**Transaction pending for too long:**

* Goliath transactions typically confirm in 3-5 seconds
* Check network status on explorer
* If transactions are stuck pending, clear MetaMask's nonce data:
  1. Remove the Goliath network from MetaMask
  2. Re-add the network using the "Add to MetaMask" button on the [Block Explorer](https://testnet.explorer.goliath.net) (ensures correct Chain ID 8901)
  3. Go to MetaMask Settings → Advanced → Clear activity & nonce data

**Need test tokens:**

* Use the [Goliath Testnet Faucet Bot](https://t.me/GoliathFaucetBot)
* Use `/request <ADDRESS>` for default multi-asset funding
* Use `/request <ADDRESS> sepoliaxcn` for Sepolia XCN
* Use `/request <ADDRESS> sepoliaxcn staked` for mint-and-stake Sepolia flow testing

**MetaMask shows zero balance:**

* Ensure you're on Goliath Testnet network
* Add XCN token manually if needed:
  * Token Contract: Native (no contract needed)
  * Symbol: XCN
  * Decimals: 18

## 📊 Network Performance

Goliath Testnet delivers exceptional performance:

| Metric                | Value         |
| --------------------- | ------------- |
| **Transaction Speed** | \~100,000 TPS |
| **Finality Time**     | 3-5 seconds   |
| **Average Gas Fee**   | <$0.001 USD   |
| **Network Uptime**    | 99.99%        |
| **Active Nodes**      | Growing daily |

## 🎉 Congratulations!

You're now connected to the Goliath testnet and ready to explore the future of distributed ledger technology. Whether you're a user looking for fast, affordable transactions or a developer building the next generation of dApps, Goliath provides the performance and reliability you need.

### Join Our Community:

* [**Telegram**](https://t.me/Onyx): Get help and connect with other users
* [**X (Twitter)**](https://x.com/Onyx): Latest updates and announcements
* [**Community Forum**](https://community.onyx.org/): Participate in governance discussions
* [**GitHub**](https://github.com/Onyx-Protocol): Contribute to development

***

*Need help? Reach out to us via the* [***Goliath Help Bot***](https://t.me/GoliathHelpBot) *on Telegram to get support, suggest improvements, or file a ticket. You can also visit our* [*FAQ*](https://github.com/Onyx-Protocol/goliath-docs/blob/main/resources/faq.md) *or join our* [*community chat*](https://t.me/Onyx)*!*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goliath.net/user-guide/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
