npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@orbs-network/ton-gateway

v2.2.0

Published

Unthrottled anonymous RPC access to TON blockchain via a robust decentralized network

Downloads

5,961

Readme

TON Gateway

Unthrottled anonymous RPC access to TON blockchain via the dozens of decentralized nodes of the Orbs Network.

Access a network of public API endpoints that allow TON dapp clients to make HTTP queries from the browser to TON blockchain (call getters, balances, get block data, etc). Access is unrestricted without an API Key and without requiring dapps to run any backend.

Supports all popular RPC protocols on TON:

  1. TonCenter HTTP API v2 - replaces the https://toncenter.com/api/v2/jsonRPC endpoint
  2. TonHub HTTP API v4 - replaces the https://mainnet-v4.tonhubapi.com endpoint
  3. Raw ADNL Proxy - coming soon

 

Getting Started

Using NPM:

npm install @orbs-network/ton-gateway

Using HTML script:

<script src="https://cdn.jsdelivr.net/gh/orbs-network/[email protected]/dist/index.min.js"></script>

 

1. Using TonCenter HTTP API v2

with ton library:

import { TonClient, Address } from "ton";
import { getHttpEndpoint } from "@orbs-network/ton-gateway";

const endpoint = await getHttpEndpoint(); // get the decentralized RPC endpoint
const client = new TonClient({ endpoint }); // initialize ton library

// make some query to mainnet
const address = Address.parseFriendly("EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N").address;
const balance = await client.getBalance(address);

with TonWeb library:

import TonWeb from "tonweb";
import { getHttpEndpoint } from "@orbs-network/ton-gateway";

const endpoint = await getHttpEndpoint(); // get the decentralized RPC endpoint
const tonweb = new TonWeb(new TonWeb.HttpProvider(endpoint)); // initialize tonweb library

// make some query to mainnet
const balance = await tonweb.getBalance("EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N");

with TonWeb as HTML script:

<script src="https://cdn.jsdelivr.net/gh/orbs-network/[email protected]/dist/index.min.js"></script>
<script src="https://cdn.jsdelivr.net/gh/toncenter/tonweb/dist/tonweb.js"></script>
<script>
    document.addEventListener("DOMContentLoaded", function () {
        TonGateway.getHttpEndpoint().then((endpoint) => { // get the decentralized RPC endpoint
            const tonweb = new TonWeb(new TonWeb.HttpProvider(endpoint)); // initialize tonweb library
            // make some query to mainnet
            tonweb.getBalance("EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N").then((balance) => {
                console.log(balance);
            });
        });
    });
</script>

 

2. Using TonHub HTTP API v4

with ton library:

import { TonClient4 } from "ton";
import { getHttpV4Endpoint } from "@orbs-network/ton-gateway";

const endpoint = await getHttpV4Endpoint();
const client4 = new TonClient4({ endpoint });

// make some query to mainnet
const latestBlock = await client4.getLastBlock();
const latestBlockNumber = latestBlock.last.seqno;

 

3. Using Raw ADNL Proxy

with ton-lite-client library:

import { LiteClient, LiteSingleEngine } from "ton-lite-client";
import { getAdnlProxyEndpoint } from "@orbs-network/ton-gateway";

const { endpoint, publicKey } = await getAdnlProxyEndpoint();
const engine = new LiteSingleEngine({ host: endpoint, publicKey });
const client = new LiteClient({ engine });

// make some query to mainnet
const info = await liteClient.getMasterchainInfo();

 

API Reference

Get TonCenter HTTP API v2 endpoint:

const endpoint = await getHttpEndpoint(config: Config);

Get TonHub HTTP API v4 endpoint:

const endpoint = await getHttpV4Endpoint(config: Config);

Get Raw ADNL Proxy endpoint:

const { endpoint, publicKey } = await getAdnlProxyEndpoint(config: Config);

Use testnet instead of mainnet:

const endpoint = await getHttpEndpoint({
  network: "testnet" 
});

Config object:

interface Config {
  network?: "mainnet" | "testnet" // default: mainnet
  host?: string; // default: "ton.gateway.orbs.network"
  gatewayVersion?: number; // default: 1
  protocol?: "default" | "json-rpc" | "rest"; // default: "default"
};
  • network - override which TON network do you want to use:
    • mainnet - TON mainnet (default)
    • testnet - the first TON testnet
  • gatewayVersion - should always be 1, reserved for future upgrades of this library
  • protocol - sub-protocol to use, depends on the type of API:
    • TonCenter HTTP API v2:
      • default - json-rpc
      • json-rpc - supported
      • rest- supported
    • TonHub HTTP API v4:
      • default - rest
      • json-rpc - not supported
      • rest - supported
    • Raw ADNL Proxy:
      • default - adnl
      • json-rpc - not supported
      • rest - not supported

 

Benefits of using the Orbs TON Gateway

  1. No throttling for anonymous users

    RPC gateways like https://toncenter.com/api/v2/jsonRPC throttle anonymous users to 1 request per second. Most dapps cannot operate under these restrictions since their users are anonymous. The Orbs Network endpoints are designed to serve anonymous dapp users and will not restrict your users from using your dapp client, except in extreme cases of abuse.

  2. No need for registering an API Key

    RPC gateways like https://toncenter.com/api/v2/jsonRPC reduce user throttling by requiring you to register an API Key. This API Key cannot be stored client-side since it can be abused (it's supposed to be a secret) and dapps should not run a centralized backend to store this secret since they should be decentralized.

  3. No need to run your own RPC backend

    If you're building a dapp, your dapp should be decentralized so it can be trustless. If you're running your own centralized backend as part of your dapp, you've made your dapp centralized. If your backend suffers downtime for example, your users will lose access to their funds. If the infrastructure is decentralized, you don't need to worry about it.

  4. Decentralized access to the chain

    By relying on https://toncenter.com/api/v2/jsonRPC, you're relying on a centralized business (toncenter.com), not a protocol. The Orbs Network TON Gateway is a decentralized protocol operated by dozens of independent nodes that are all part of the Orbs Network. The network mainnet is running since 2019 and validators are staked with Proof-of-Stake consensus with over $100 million TVL locked. The network is extremely robust against downtime due to the number of independent nodes.