README.md

OceanID

简体中文

+---------+-----------------------------------------------------+----------+----------+
|  retain | increas                                             | salt     | sequence |
+---------+-----------------------------------------------------+----------+----------+
|    0    | 0000000000 0000000000 0000000000 0000000000 0000000 | 00000000 | 00000000 |
+---------+-----------------------------------------------------+------------+--------+

As said in the description, he is a good id generation service

🔥New

The client from OasisMessenger is based on Golang: github.com/oasismessenger/OceanIDClient

How to call the gRPC interface in OceanID?

Don't worry, we provide an example 🤔

GRPC YOUR_HOST/schemes.OceanID/GenerateID

{
  "DC": 1,
  "worker_id": 2000,
  "request_id": 1
}

JSON is used here to make the payload look more intuitive

• As shown in the payload, you need three parameters to complete this request, they are: DC, worker_id, request_id
• Among them, request_id is the most important, it can help you confirm which request a response corresponds to

type of data

syntax = "proto3";

enum EnumDC {
  DcAS = 0;
  DcNA = 8;
  DcEu = 16;
}

message IDRequest {
  uint32 DC = 1;
  uint64 worker_id = 2;
  uint64 request_id = 3;
}

message IDBulkRequest {
  EnumDC DC = 1;
  uint32 worker_id = 2;
  uint64 request_id = 3;
  uint32 bulk_size = 4;
}

message IDReply {
  int64 id = 1;
  uint64 timestamp = 2;
  uint64 reply_id = 3;
}

message IDBulkReply {
  repeated int64 ids = 1;
  uint64 timestamp = 2;
  uint64 reply_id = 3;
  uint32 size = 4;
}

interface

service OceanID {
  rpc GenerateID(IDRequest) returns (IDReply) {}
  rpc BulkGenerateID(IDBulkRequest) returns (IDBulkReply) {}
}