Chaingateway V2.1 Beta: Testnets, Webhooks

Chaingateway V2.1 is the 2024 rewrite of the Chaingateway API and dashboard. It added testnet support through the X-Network header, a rebuilt webhook system and a redesigned user interface. The API base URL moved from api.chaingateway.io/v2 to app.chaingateway.io/api/v2. This note lists the changes and the migration steps from the 16 September 2024 beta announcement.

Update, 5 November 2026: V2.1 is the current API. Since this release, Solana and Arbitrum have been added (Solana has no webhooks), the Tron Paymaster described below has been deprecated, and crypto payments for plans changed in April 2025 (see New payment flow). The endpoint list is in the OpenAPI file.

How do I access V2.1?

V2.1 is available to all customers and trial users at app.chaingateway.io. It was designed to be compatible with V2, so most integrations only need a new base URL. The migration steps are at the end of this note.

If your trial has expired, create an account, or contact us to extend your trial. The beta also had a Telegram community.

What is new in V2.1?

The release contained these changes:

1. Testnet support on every chain.
2. Tron Paymaster, a fee service for TRC-20 transfers. It is now deprecated.
3. API documentation with request and response examples.
4. A reworked developer portal.
5. A redesigned dashboard.
6. Instant plan changes for card payments.
7. A rebuilt webhook system and new fee handling.

Which testnets are supported?

Add the header X-Network: testnet to a request to use the test network of a chain. For mainnet, send X-Network: mainnet or omit the header. Everything you can do on mainnet works on the testnet as well. You can also switch networks in the dashboard header.

Chain	Testnet in V2.1	Reference
Ethereum	Sepolia	ethereum.org: networks
Tron	Nile	TRON developer hub: networks
BNB Smart Chain	BSC testnet	BNB Chain docs
Polygon	Amoy	Polygon docs
Bitcoin	Testnet3	Bitcoin developer examples: testing

The current list, which also contains Arbitrum Sepolia and Solana devnet, is in the supported networks documentation.

What was the Tron Paymaster?

Paymaster was a service that paid the Energy and Bandwidth fees for TRC-20 transfers, so that a wallet did not need to hold TRX. It was billed separately from the subscription, and it cost nothing on testnet. Paymaster is deprecated. Use TronFuel instead. The old Paymaster tutorial remains for reference.

What changed in the documentation and the dashboard?

The API documentation got more request and response examples, and the developer portal got a new getting-started guide and tutorials for the core functions. The dashboard was redesigned, and the webhook monitor lets you inspect sent payloads and filter by value.

What changed in billing?

Customers paying by card through Stripe can switch to a higher plan immediately instead of waiting for the next billing cycle. If you hit your API limits, you click “Change Plan” in the billing page, and the limits rise at once. The invoice shows only the price difference between the old and the new plan. The announcement said that the same would follow for crypto payments, which shipped with the April 2025 payment flow.

What changed technically?

The API runs on a new technology stack. The announcement noted that some responses could differ slightly from V2 and asked users to report differences to support.

Fee handling was reworked. If your requests set gasPrice, maxFeePerGas or maxPriorityFeePerGas, you no longer need to send them in V2.1. The gas fields remain optional in the current OpenAPI definition.

The webhook system was rebuilt after outages in the webhook service in the weeks before the release, during which some blocks were not processed. The webhook monitor in the dashboard shows the payloads that were sent. Webhooks are not retried automatically. Failed notifications are listed per chain, for example under GET /api/v2/tron/webhooks/notifications/failed, and you re-send them with the retry endpoint.

What was planned after V2.1?

The announcement named three follow-ups: Solana support, Paymaster for more chains, and fixes to API responses. Solana support has shipped. Paymaster was deprecated instead of being extended.

How do I migrate from V2 to V2.1?

1. Change the base URL from api.chaingateway.io/v2 to app.chaingateway.io/api/v2.
2. Optional, but recommended: add the Bearer prefix to your API key, so that the header reads Authorization: Bearer <token>.
3. Test your integration against the new URL.
4. Until you have fully migrated, manage your subscription in the old dashboard.

User data, addresses and API keys were copied from V2 to V2.1 every minute during the transition. Addresses created in V2.1 cannot be used in V2. Webhooks were copied every 10 minutes and did not trigger notifications during the copy. If you need help migrating webhooks, contact support.