# ArcPass

## Docs

- [Authentication and Access in ArcPass API](https://docs.arcpass.vibepas.xyz/api-reference/authentication.md): ArcPass is a public API with no authentication tokens or API keys required. Rate limiting and wallet eligibility checks are the primary access controls.
- [GET /health — API Health Check](https://docs.arcpass.vibepas.xyz/api-reference/health.md): GET /health — Returns the API service status and process uptime in seconds. Use this endpoint to verify ArcPass API availability before integrating.
- [ArcPass REST API Overview](https://docs.arcpass.vibepas.xyz/api-reference/overview.md): Reference for the ArcPass HTTP API — base URL, JSON request/response format, error shape, correlation IDs, and a full list of available endpoints.
- [GET /sponsorship/:id — Get Sponsorship Status](https://docs.arcpass.vibepas.xyz/api-reference/sponsorship/get.md): GET /sponsorship/:id — Retrieve a sponsorship request by UUID. Includes current status, wallet address, and relay transaction reference if available.
- [GET /relay/:id — Relay Transaction Details](https://docs.arcpass.vibepas.xyz/api-reference/sponsorship/relay.md): GET /relay/:id — Retrieve relay transaction details by UUID, including on-chain tx hash, submission timestamp, and confirmation status.
- [POST /sponsorship/request — Request Sponsorship](https://docs.arcpass.vibepas.xyz/api-reference/sponsorship/request.md): POST /sponsorship/request — Submit a wallet for gas sponsorship. Returns a sponsorship request with a UUID you can use to track its status.
- [GET /wallets/:address/history — Sponsorship History](https://docs.arcpass.vibepas.xyz/api-reference/wallets/history.md): GET /wallets/:address/history — Paginated list of sponsorship requests for a wallet. Supports cursor-based pagination with up to 100 results per page.
- [GET /wallets/:address — Look Up a Wallet](https://docs.arcpass.vibepas.xyz/api-reference/wallets/lookup.md): GET /wallets/:address — Retrieve a wallet profile by Ethereum address. Returns registration status, sponsorship count, and blocked flag.
- [POST /wallets/register — Register a Wallet](https://docs.arcpass.vibepas.xyz/api-reference/wallets/register.md): POST /wallets/register — Register a wallet address with ArcPass. Returns a wallet profile including sponsorship count and blocked status.
- [Wallet Eligibility Criteria for ArcPass Sponsorship](https://docs.arcpass.vibepas.xyz/concepts/eligibility.md): Understand the criteria your wallet must meet to receive gas sponsorship from ArcPass, including registration, on-chain checks, and rate limits.
- [ArcPass Smart Contracts on the Arc Network Testnet](https://docs.arcpass.vibepas.xyz/concepts/smart-contracts.md): Explore the on-chain contracts that back ArcPass sponsorships, how to verify your sponsorship status directly on Arc testnet, and key events to watch.
- [Understanding the ArcPass Sponsorship Request Lifecycle](https://docs.arcpass.vibepas.xyz/concepts/sponsorship-lifecycle.md): Learn what each sponsorship request state means, how your request moves through the pipeline, and what to do when it reaches a terminal state.
- [ArcPass Environment Variable Reference](https://docs.arcpass.vibepas.xyz/configuration/environment-variables.md): Reference for all ArcPass environment variables, covering database, blockchain, API, worker, and rate limiting settings with defaults and descriptions.
- [Rate Limits and Abuse Prevention in ArcPass](https://docs.arcpass.vibepas.xyz/configuration/rate-limits.md): How ArcPass IP and wallet rate limiting works, what a 429 error means, how auto-blocking and replay protection prevent abuse, and how to configure thresholds.
- [ArcPass General FAQ](https://docs.arcpass.vibepas.xyz/faq/general.md): Answers to the most common questions about ArcPass gas sponsorship on Arc Network, including eligibility, how much gas you receive, and how the process works.
- [Troubleshoot ArcPass Sponsorship Issues](https://docs.arcpass.vibepas.xyz/faq/troubleshooting.md): Step-by-step guidance for diagnosing and fixing common ArcPass problems including wallet errors, stuck requests, rate limits, and failed relay transactions.
- [Track Your Sponsorship Request Status](https://docs.arcpass.vibepas.xyz/guides/check-status.md): Check sponsorship request status by ID, understand each lifecycle state, and look up on-chain relay transaction details using the ArcPass API.
- [Monitoring Sponsorships with the Dashboard](https://docs.arcpass.vibepas.xyz/guides/dashboard.md): Use the ArcPass web dashboard to view sponsorship metrics, check API and worker health, and browse recent sponsorship requests in real time.
- [Request Gas Sponsorship on Arc Network](https://docs.arcpass.vibepas.xyz/guides/request-sponsorship.md): Step-by-step guide to submitting a gas sponsorship request on Arc Network. Covers both the web interface and the ArcPass REST API with curl examples.
- [How ArcPass Gas Sponsorship Works, from Request to Relay](https://docs.arcpass.vibepas.xyz/how-it-works.md): Learn how ArcPass checks wallet eligibility, sponsors your first transaction, and delivers native tokens to your Arc Network wallet through on-chain relay.
- [ArcPass: Frictionless Onboarding for the Arc Network](https://docs.arcpass.vibepas.xyz/introduction.md): ArcPass sponsors the first transaction for new Arc Network wallets, removing the cold-start gas barrier so you can onboard without needing initial funds.
- [Get Started with ArcPass](https://docs.arcpass.vibepas.xyz/quickstart.md): Register your Arc Network wallet and request your first gas sponsorship using the ArcPass REST API. Get tokens delivered to your wallet in under 5 minutes.