Indexers use Rarible Ethereum Protocol OpenAPI to describe APIs (and events). Clients (Kotlin, TypeScript, etc.) and server controller interfaces are generated automatically using YAML OpenAPI files.
Rarible Ethereum Protocol OpenAPI is a component of the Rarible Protocol.
See more information about Rarible Protocol at docs.rarible.org.
Use these base URLs to access API on different Ethereum networks:
| Documentation | Base URL | Environments | Chain ID |
|---|---|---|---|
| ethereum-api.rarible.org/v0.1/doc | https://ethereum-api.rarible.org/v0.1 | Mainnet | 1 |
| ethereum-api-staging.rarible.org/v0.1/doc | https://ethereum-api-staging.rarible.org/v0.1 | Rinkeby | 4 |
| dev-ethereum-api.rarible.org/v0.1/doc | https://dev-ethereum-api.rarible.org/v0.1 | Ropsten | 3 |
Be careful of backward compatibility:
- Do not change types of existing fields in an incompatible way. Unless properly coordinated with all possible clients.
- Do not add new required fields.
-
There may be Kafka queues, which are left from previous deploys, containing old objects not having this field.
When Kafka consumers from those queues try to read the new model, they may fail with the "No such field" exception.
This actually has happened to us when we made
NftItemDto.metato be a required field:com.fasterxml.jackson.module.kotlin.MissingKotlinParameterException: Instantiation of [simple type, class com.rarible.protocol.dto.NftItemDto] value failed for JSON property meta due to missing (therefore NULL) value for creator parameter meta which is a non-nullable type
-
How to overcome this:
- firstly, deploy the application with optional type (as before) but always have a value
- wait for some time to guarantee all Kafka queues are emptied
- secondly, make the field as required
-
- Adding new model objects is backward compatible.
- Adding new optional fields is backward compatible.
You are welcome to suggest features and report bugs found!
The codebase is maintained using the "contributor workflow" where everyone without exception contributes patch proposals using "pull requests" (PRs). This facilitates social contribution, easy testing, and peer review.
See more information on CONTRIBUTING.md.
Rarible Ethereum Protocol OpenAPI (with generated clients) is available under MIT License.