Provide an one-step DOB rendering service to squash a batch of complex steps that from DNA fetching to DOB traits rendering.
Online features:
- embeded
ckb-vmexecutor - executable standalone JsonRpc server
- decoder binaries temporary cache
- render result temporary cache
- library exported for 3rd-party integration
Embeded VM executor is integrating a standalone ckb-vm in project to execute decoder binary files, and the corresponding feature is embeded_vm which is marked in default. We recommend embeded mode for fresh users, because in contrast, the native mode is more like an advanced usage for providing flexibility for user-defined VM environments.
Considering there would be plenty of decoders under DOB protocol in upcoming days, caching on-chain decoders for once in cache directory, which is marked here, is more reasonable rather than downloading them in repeat.
Since decoder binary has two location types according to the requirement from DOB protocol, which are respectively the code_hash (name file in code_hash_<hash>.bin format) and type_id (name file in type_id_<hash>.bin format). For example, decoder binary file code_hash_edbb2d19515ebbf69be66b2178b0c4c0884fdb33878bd04a5ad68736a6af74f8.dob indicates the location type is code_hash, and with edbb2d19515ebbf69be66b2178b0c4c0884fdb33878bd04a5ad68736a6af74f8 for its blake2b hash of the entire content.
The code_hash location type requires user to compile out all of interested decoder RISC-V binaries in advance, and then, place them into project's decoder cache directory (in code_hash_<hash>.bin format). In contrast, the type_id location type has no extra demands, since these sort of decoder binaries have been already deployed into on-chain decoder cells which the project will automatically download from and persist into cache directory (in type_id_<hash>.bin format).
Considering the immutability of Spore and Cluster cell, the DNA string in Spore cell is immutable as well, so the rendering result of DNA is indeed immutable at the same time.
Rendering output can be stored in cache directory for shorting down server response time for the same decoding requests, which is marked here.
Running a JsonRpc server requires project to be built under feature standalone_server opened, which is marked in default.
Steps to run a server:
$ RUST_LOG=dob_decoder_server=debug cargo runAnt then, try it out:
$ echo '{
"id": 2,
"jsonrpc": "2.0",
"method": "dob_decode",
"params": [
"<spore_id in hex format without 0x prefix>"
]
}' \
| curl -H 'content-type: application/json' -d @- \
http://localhost:8090Spore DOB protocol has unique version identifier (like ERC721 or ERC1155), however, different versions may have totally different behaviors in decoding operation, so that we come out a regulation that one server instance only serves under one specific DOB protocol version, which is marked here.
refer to error definitions here.
| error code | short definition |
|---|---|
| 1001 | DnaLengthNotMatch |
| 1002 | SporeIdLengthInvalid |
| 1003 | NativeDecoderNotFound |
| 1004 | SporeIdNotFound |
| 1005 | SporeDataUncompatible |
| 1006 | SporeDataContentTypeUncompatible |
| 1007 | DOBVersionUnexpected |
| 1008 | ClusterIdNotSet |
| 1009 | ClusterIdNotFound |
| 1010 | ClusterDataUncompatible |
| 1011 | DecoderIdNotFound |
| 1012 | DecoderOutputInvalid |
| 1013 | HexedDNAParseError |
| 1014 | HexedSporeIdParseError |
| 1015 | DecoderBinaryPathInvalid |
| 1016 | DecoderExecutionError |
| 1017 | DecoderExecutionInternalError |
| 1018 | FetchLiveCellsError |
| 1019 | FetchTransactionError |
| 1020 | NoOutputCellInTransaction |
| 1021 | DOBContentUnexpected |
| 1022 | DOBMetadataUnexpected |
| 1023 | DOBRenderCacheNotFound |
| 1024 | DOBRenderCacheModified |
| 1025 | DecoderBinaryHashInvalid |
| 1026 | DecoderBinaryNotFoundInCell |
| 1027 | JsonRpcRequestError |