Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.arcpass.vibepas.xyz/llms.txt

Use this file to discover all available pages before exploring further.

ArcPass covers the first transaction for eligible wallets on Arc Network, removing the gas barrier that blocks new users from interacting with the chain. You can request sponsorship through the web interface or directly via the API. Both paths produce the same result: a sponsorship request record that the relay worker picks up and processes on-chain.

​
Prerequisites

  • An Arc Network wallet address in the format 0x followed by 40 hex characters (e.g. 0xAbCd...1234).
  • The wallet must not have been sponsored before.
  • The wallet must not be blocked by ArcPass.

​
Option 1: Web interface

Navigate to /request in the ArcPass web app, enter your wallet address, and submit the form. The form handles wallet registration and sponsorship submission automatically.

​
Option 2: API

Use the two-step API flow below to register your wallet and submit a sponsorship request programmatically.
1

Register your wallet

Call POST /wallets/register with your wallet address. If the wallet is already registered, the endpoint returns the existing record with HTTP 200. A new registration returns HTTP 201.
curl -X POST https://api.arcpass.example/wallets/register \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "0xA3f2B1c4D5e6F7a8B9C0d1E2f3A4B5C6D7E8F9a0"}'
2

Submit a sponsorship request

Call POST /sponsorship/request with the same wallet address. ArcPass validates eligibility and creates a sponsorship request in pending status.
curl -X POST https://api.arcpass.example/sponsorship/request \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "0xA3f2B1c4D5e6F7a8B9C0d1E2f3A4B5C6D7E8F9a0"}'
3

Save the sponsorship request ID

Copy the id field from the response. You will use it to track the status of your request. See Track Your Sponsorship Request Status for details.

​
Rate limits

ArcPass enforces rate limits on both the submitting IP address and the wallet address to prevent abuse. If you exceed the limit, you will receive an HTTP 429 response with a Retry-After header indicating how many seconds to wait before retrying.
The wallet address is normalized to lowercase before processing. You may submit it in any case.

​
Eligibility rules

A request is rejected immediately if either condition is true:
  • The wallet has already received sponsorship (the wallet’s sponsorshipCount is greater than zero on-chain).
  • The wallet is blocked by ArcPass.
If your wallet already has a pending request open, submitting a second request will fail with a validation error. Wait for the existing request to reach a terminal state (completed, rejected, or failed) before resubmitting.