⚠️ Disclaimer: This API is no longer operational, check out our API registry for available APIs, faucets, and more.
Eureka! There’s gold in them thar hills! Secret gold 🤫 🌄 ⛏️
Chain of Secrets has launched the Secret API for Secret Network as part of our developer on-boarding efforts.
On September 15th, 2020, Enigma and the Secret Community brought Secret Contracts live to mainnet in a groundbreaking event we called the Vulcan upgrade:
“This mainnet upgrade makes Secret Network the only blockchain running live smart contracts with encrypted inputs, outputs, and state.”
Secret Network
It’s time to start panning for secret gold!
Now that Secret Contracts are LIVE, we can build some great Secret Apps together. Secret API supports querying the state of the network, submitting governance proposals and voting, withdrawing staking rewards, querying and broadcasting transactions, and much more.
We’re working on adding the latest secret contract queries and transactions for the compute module and the experimental secret20 commands to the Secret API. Stay tuned!
Secret API provides an interface with both REST and RPC endpoints, which all kinds of Secret Agents may use to interact with the network. It’s a great way to get familiar with the different things you can do, and we provide helpful examples with parameter settings and typical responses.
- Swagger UI — web interface
- REST endpoint — supports queries and transactions against the network
- RPC endpoint — where you can get information on network peers, dump the consensus state of the chain, and get the genesis state
Secret API ~ Web Interface
Located at secretapi.io 🙂
Using the interface, you can click one of the items and try it out. For example, if you wanted to see all the validators that a delegator has staked with, you would click on the GET /staking/delegators/{delegatorAddr}/validators item.
If you click Try it out, enter a delegator address, and then hit Execute, you will see the JSON response, and you can download the data. Pretty cool!
Secret API ~ REST Service
A service using representational state transfer (REST) can be accessed directly at https://api.secretapi.io and/or by adding paths and parameters to the URL.
Example: https://api.secretapi.io/blocks/latest
Secret API ~ RPC Service
The RPC service can be accessed at https://rpc.secretapi.io and/or by adding the parameters and JSON where necessary. If you go to the URL, it will show a list of endpoints and the applicable parameters:
Well, that’s our Secret API in a nutshell! Or should we say nugget?
Have fun trying it out and let us know what you’re building! ⚒️
Here’s another secret “gold nugget” that nicely ties into our Secret API! SecretJS is a Typescript client for building Secret Apps, and it has methods for interacting with secret contracts. You can read more about building Secret Apps with SecretJS, and try using a functional “Secret Voting” app here:
Secret Network
We also have a freshly-generated Python SDK you can try!
Let us know if you have any feedback or questions. If you’d like to support our mission of driving adoption of Secret Network and bringing more Secret Apps to the world, consider delegating to us!
Delegate to CoS: https://chainofsecrets.org/delegate.html
Chain of Secrets is a Secret Network validator node and a key contributor to the Secret Network ecosystem.
Telegram: https://t.me/chainofsecrets
Twitter: https://twitter.com/cosorg
Web: https://chainofsecrets.org
To discuss Secret Network and Secret Apps, visit our community channels:
Website | Forum | Twitter | Discord | Telegram
