api-endpoints.md

Connecting to the Network

Secret Network Community API Endpoints

• Secret-4 Mainnet
  • Binaries
  • Explorers
  • API Endpoints
  • Seed Nodes
• Pulsar-2 Testnet
  • Binaries
  • Explorers
  • Faucets
  • API Endpoints
  • Peer Nodes
• Usage Examples
  • RPC
  • gRPC-Web
  • LCD
  • Seeds
  • Peers

{% hint style="info" %} Are we missing your endpoint or tool? Submit a Pull Request at https://github.com/scrtlabs/api-registry {% endhint %}

Secret-4 Mainnet

Binaries

• https://github.com/scrtlabs/SecretNetwork/releases/tag/v1.3.1

Explorers

• https://secretnodes.com/secret/chains/secret-4
• https://www.mintscan.io/secret

API Endpoints

The API endpoints are offered to the community for free, please be mindful and don't spam them.

{% hint style="info" %} Public APIs. Do not use in production apps! {% endhint %}

Type	API	Courtesy of
RPC	https://secret-4.api.trivium.network:26657	Trivium | Trivium.Network
RPC	https://rpc.roninventures.io	Ronin Ventures
RPC	https://scrt-rpc.blockpane.com (archive node)	[block pane]
gRPC-web	https://secret-4.api.trivium.network:9091	Trivium | Trivium.Network
gRPC-web	https://web-rpc.roninventures.io	Ronin Ventures
gRPC-web	http://scrt-rpc.blockpane.com:9091 (archive node)	[block pane]
LCD	https://secret-4.api.trivium.network:1317	Trivium | Trivium.Network
LCD	https://api.roninventures.io	Ronin Ventures
LCD	https://scrt-lcd.blockpane.com (archive node)	[block pane]

Seed Nodes

• 6fb7169f7630da9468bf7cc0bcbbed1eb9ed0d7b@scrt-seed-01.scrtlabs.com:26656
• ab6394e953e0b570bb1deeb5a8b387aa0dc6188a@scrt-seed-02.scrtlabs.com:26656
• 9cdaa5856e0245ecd73bd464308fb990fbc53b57@scrt-seed-03.scrtlabs.com:26656

Pulsar-2 Testnet

Binaries

• https://github.com/scrtlabs/SecretNetwork/releases/tag/v1.3.1 (use the testnet binaries)

Explorers

• https://secretnodes.com/secret/chains/pulsar-2
• https://testnet.ping.pub/secret

Faucets

• https://faucet.secrettestnet.io
• https://faucet.pulsar.scrttestnet.com

API Endpoints

Type	API	Courtesy of
RPC	https://rpc.pulsar.scrttestnet.com	Community
RPC	https://testnet-rpc.roninventures.io	Ronin Ventures
Websocket	wss://rpc.pulsar.scrttestnet.com/websocket	Community
gRPC-web	https://grpc.pulsar.scrttestnet.com	Community
gRPC-web	https://testnet-web-rpc.roninventures.io	Ronin Ventures
LCD	http://testnet.securesecrets.org:1317	Trivium | Trivium.Network
LCD	https://api.pulsar.scrttestnet.com	Community
LCD	https://testnet-api.roninventures.io	Ronin Ventures
gRPC	http://grpcbin.pulsar.scrttestnet.com:9099	Community

Peer Nodes

• 7a421a6f5f1618f7b6fdfbe4854985746f85d263@108.62.104.102:26656
• a72e376dca664bac55e8ce55a2e972a8ae2c995e@144.202.126.98:26656
• a941999e72f4726d276ef055a09cb8bedf8e7a9a@45.35.77.30:26656
• f95ba3da4a9eec559397f4b47b1539e24af6904c@52.190.249.47:26656

Usage Examples

RPC

With secretcli (replace "$URL"):

$ secretcli config node "$URL"
$ secretcli config chain-id secret-4 # or pulsar-2

Or:

$ secretcli status --node "$URL" --chain-id secret-4 # or --chain-id pulsar-2

GRPC-Web

With secretjs@beta (replace "$URL"):

import { SecretNetworkClient } from "secretjs";

const grpcWebUrl = "$URL";
const chainId = "secret-4"; // or "pulsar-2"

// Readonly Client
const secretjs = await SecretNetworkClient.create({
  grpcWebUrl,
  chainId,
});

// Or a signer client with Keplr integration
await window.keplr.enable(chainId);
const [{ address: myAddress }] = await keplrOfflineSigner.getAccounts();

const secretjs = await SecretNetworkClient.create({
  grpcWebUrl,
  chainId,
  wallet: window.getOfflineSignerOnlyAmino(chainId),
  walletAddress: myAddress,
  encryptionUtils: window.getEnigmaUtils(chainId),
});

LCD

Swagger/OpenAPI UI can be found under $URL/swagger/ and $URL/openapi/.

With (the deprecated) secretjs (replace "$URL"):

import { CosmWasmClient, SigningCosmWasmClient } from "secretjs";

const lcdUrl = "$URL";
const chainId = "secret-4"; // or "pulsar-2"

// Readonly Client
const queryJs = new CosmWasmClient(lcdUrl);

// Or a signer client with Keplr integration
await window.keplr.enable(chainId);
const offlineSigner = window.getOfflineSigner(chainId);
const enigmaUtils = window.getEnigmaUtils(chainId);
const accounts = await offlineSigner.getAccounts();

const secretJS = new SigningCosmWasmClient(
  lcdUrl,
  accounts[0].address,
  offlineSigner,
  enigmaUtils
);

Seeds

Usage example:

$ perl -i -pe 's/^seeds =.*/seeds = "${URL_1},${URL_2},${URL_3}"/' ~/.secretd/config/config.toml

{% hint style="info" %} When initializing a node with secretd init --chain-id secret-4 these seeds are automatically populated into ~/.secretd/config/config.toml. {% endhint %}

Peers

Usage example:

$ perl -i -pe 's/^persistent_peers =.*/persistent_peers = "${URL_1},${URL_2},${URL_3}"/' ~/.secretd/config/config.toml