API Usage Mining Overview

The APIS
6 min readSep 20, 2021

--

We are extremely excited to announce greater details of our usage mining program.

The goal of our usage mining program is to provide our community with ownership of the APIS protocol. The API token is used to govern the APIS protocol, stake as insurance against improperly executed reads or writes, stake on different sides of disputes should an APIS node or gateway act maliciously, and validate the layer-two scaling solution used APIS protocol. Because the API token is so crucial for the APIS protocol’s functioning, we believe that a maximally decentralized distribution of API tokens into the hands of those who care about the APIS protocol would be best for the APIS protocol’s success.

While our community has and will continue to receive API token allocations from API Lab and the Community Treasury, those distributions rely on APIS governance algorithms, which can never be probably objective. While also a byproduct of APIS governance, our usage mining program is entirely objective in it. We believe significant, objective token distribution is crucial in creating a fair, decentralized protocol.

Below are the details of the usage mining program, which we hope as many of you as possible will participate in, should you be interested in joining the APIS community.43,000,000 API (43% of the total supply) are allocated to the usage mining program. Both sides of the API marketplace (supply and demand) are equally important, and thus the usage mining program is split evenly between both:

Supply: 21,500,000 API

(API Nodes and Gateways who provide reads/writes)

Demand: 21,500,000 API

(Applications and Websites who need reads/writes)

Both sides of the marketplace will follow the same emissions schedule concerning the 21.5mn API issued. The time over which the 21.5mn will be given will be 24 months, conducted via an S-curve. An S-curve was determined because our community put forth that new technology is often adopted via an S-curve. Therefore, we want our distribution to align with our adoption. This was the underlying principle behind the entire program.

T=0

Thus, the t = 0 starting point (the block number at which the program begins) will likely be different for each side of the marketplace.

For the demand side, t = 0 will be when 5 Dapps are made over 1000 reads or write (the two will be combined) in a day.

For the supply side, t = 0 will be when five distinct APIS Nodes (distinct meaning run by separate actors/entities) with over 10,000 API staked have provisioned at least 1000 reads or writes in a day.

We predict that the demand program will begin before the supply program.

The tools to obtain reads and writes from the APIS network are nearly ready for widespread use. However, the tools to build to launch a Node or Gateway (supply side) are not yet fully developed, as a highly performant, decentralized back-end is more challenging to achieve. Our test net’s launch will be extremely helpful in accelerating the development time of a decentralized Node and Gateway network.

Monthly Allocation

API tokens will be distributed monthly, with the specific dates to be determined by t = 0.

You can find our complete token distribution schedule here.

Onthe demand side, we develop an accounting standard that can be implemented across Gateways and Nodes (a universal protocol login) — as buyers will purchase reads/writes from multiple Gateways and Nodes. Each transaction will be logged on-chain via a hash and associate Merkle Trie (Merkle Trie hashes are the best solution for gas usage minimization). In contrast, API Nodes will log the complete Merkle Trie that makes up that hash, thus allowing them to share the detailed history of the APIS network.

API Nodes will open-source their tallies for the demand side, such that customers can frictionlessly see and/or project their API token earnings. The monthly allocation to each account will be directly proportional to that account’s usage of the APIS protocol (i.e., a Dapp that pays 1% of fees generated that month will earn 1% of that month’s emission). All tokens issued to the demand side will be subject to a one-year lock-up. To mitigate malicious actors, API Gateways and Nodes will monitor user account behavior such that malicious actors will be caught and have their tokens slashed and redistributed between the pool appropriately for the periods when the fraudulent actions occurred (90%) and to the actors who exposed the fraudulent actor (10%). We cannot ensure that every fraudulent activity will be caught. However, due to our community’s experience in the internet industry, we are confident to spot all egregious examples of fraud. All fraudulent cases will be voted on by all API holders, such that the community can be the judge and jury.

Onthe supply side, a registry of Nodes and Gateways will be maintained on-chain. Each transaction also logs the Node and Gateway associated with that transaction using Merkle Tries. Nodes will open-source their tallies for the supply side in the same way that they do it for the demand side, such that maximal, real-time transparency ensues.

The monthly allocation will be directly proportional to use (i.e., a Node that sells 1% of fees generated that month will earn 1% of that month’s emissions for Nodes). The ecosystem of API tokens between Nodes and Gateways will be favored towards Nodes, as the decentralization of Nodes is more important than the decentralization of Gateways (to ensure a maximally decentralized network). As Nodes will require significantly more compute and storage resources than Gateways. Nodes can be thought of as our network’s decentralized back-end, while Gateways can be thought of as our network’s decentralized front-end. Thus, Gateways are still immensely valuable due to their role as customer acquirers (acquiring the demand side of the market), and so to write them to 0 would also be irresponsible.

We currently propose a 75–25 monthly split between Nodes and Gateways. All tokens issued to the supply side will be subject to a one-year lock-up. To mitigate malicious actors, API Gateways and Nodes will monitor fellow Gateway and Node behavior such that malicious actors will be caught and have their tokens removed and redistributed to the pool appropriately for the periods fraudulent. Thus, malicious supply-side actors can have their stakes, in addition to their fraudulently earned tokens, slashed. On the demand side, slashing amounts for fraudulence will be subject to the judge and jury of APIS governance.

Conclusion

As time goes on and the tools to buy and supply reads and writes from the APIS network continue to improve, there will be an inflection point, and growth will shoot. An S distribution curve that aligns with an S adoption curve will incentivize maximal adoption and distribute the tokens to as many stakeholders as possible. We are now officially fielding inquiries about the program and will work with as many of you as possible to ensure a successful launch. Lastly, never hesitate to reach out with ideas regarding any aspect of the program, as we are already surprised with how much more our community knows more than us.

Our current t = 0 for both Demand and Supply are internal projections based on our current development schedule and are in no way finalized.

👋 About THE APIS:

The APIS is an indexing protocol for reading and writing to open networks. Making APIs open and accessible to power a decentralized world.

Website | Twitter |GitHub |Discord |Roadmap

--

--

The APIS
The APIS

Written by The APIS

The APIS is an indexing and querying protocol for reading and writing to open networks. Hook by The APIS

No responses yet