Compare commits

...

4 Commits

Author SHA1 Message Date
nfel c778fdafd5 build: add Buf Linux binary 2026-08-28 14:47:45 +03:30
nfel 286b8e549b feat(proto): add publisher ICO order flow 2026-08-14 19:49:25 +03:30
nfel d27d3ff550 feat(auth): expose stable IAM role keys 2026-08-14 19:44:04 +03:30
nfel b4bb506c20 feat(proto): add general ledger service contract 2026-08-14 18:46:39 +03:30
7 changed files with 193 additions and 0 deletions
+1
View File
@@ -81,6 +81,7 @@ message CheckIAMReq {
message InternalIAM {
User user = 1;
IdentityBasic identity = 2;
repeated string role_keys = 3;
}
message IdReqWithIAM {
Binary file not shown.
+168
View File
@@ -0,0 +1,168 @@
syntax = "proto3";
package ledger.v1;
import "google/protobuf/timestamp.proto";
enum AccountClass {
ACCOUNT_CLASS_UNSPECIFIED = 0;
ACCOUNT_CLASS_USER_AVAILABLE = 1;
ACCOUNT_CLASS_USER_FROZEN = 2;
ACCOUNT_CLASS_EXTERNAL_BLOCKCHAIN = 3;
ACCOUNT_CLASS_TREASURY = 4;
ACCOUNT_CLASS_MARKET_CLEARING = 5;
ACCOUNT_CLASS_IPG_CLEARING = 6;
ACCOUNT_CLASS_COMMISSION_REVENUE = 7;
}
enum TransactionState {
TRANSACTION_STATE_UNSPECIFIED = 0;
TRANSACTION_STATE_CREATED = 1;
TRANSACTION_STATE_PENDING_TRANSACTION = 2;
TRANSACTION_STATE_PENDING_ADMIN = 3;
TRANSACTION_STATE_SUCCESSFUL = 4;
TRANSACTION_STATE_FAILED = 5;
TRANSACTION_STATE_SUSPENDED = 6;
}
message AccountReference {
AccountClass account_class = 1;
string owner_type = 2;
string owner_id = 3;
int64 asset_id = 4;
}
message JournalEntry {
uint32 line_number = 1;
AccountReference account = 2;
// Canonical base-10 decimal. Positive is credit and negative is debit.
string amount = 3;
string description = 4;
}
message BlockchainReference {
string network = 1;
string transaction_hash = 2;
string ledger_sequence = 3;
}
message Journal {
string journal_id = 1;
string source_service = 2;
string idempotency_key = 3;
string source_transaction_id = 4;
string tracking_code = 5;
string effect_kind = 6;
uint32 event_version = 7;
repeated JournalEntry entries = 8;
optional string reversal_of_journal_id = 9;
google.protobuf.Timestamp occurred_at = 10;
google.protobuf.Timestamp recorded_at = 11;
string correlation_id = 12;
string actor_id = 13;
BlockchainReference blockchain = 14;
map<string, string> metadata = 15;
string payload_hash = 16;
}
message AppendJournalRequest {
string source_service = 1;
string idempotency_key = 2;
string source_transaction_id = 3;
string tracking_code = 4;
string effect_kind = 5;
uint32 event_version = 6;
repeated JournalEntry entries = 7;
optional string reversal_of_journal_id = 8;
google.protobuf.Timestamp occurred_at = 9;
string correlation_id = 10;
string actor_id = 11;
BlockchainReference blockchain = 12;
map<string, string> metadata = 13;
}
message AppendJournalResponse {
Journal journal = 1;
bool already_existed = 2;
}
message AppendTransactionEventRequest {
string source_service = 1;
string idempotency_key = 2;
string source_transaction_id = 3;
string tracking_code = 4;
uint32 event_version = 5;
TransactionState state = 6;
string error_code = 7;
string error_message = 8;
google.protobuf.Timestamp occurred_at = 9;
string correlation_id = 10;
string actor_id = 11;
BlockchainReference blockchain = 12;
map<string, string> metadata = 13;
}
message TransactionEvent {
string event_id = 1;
AppendTransactionEventRequest event = 2;
google.protobuf.Timestamp recorded_at = 3;
string payload_hash = 4;
}
message AppendTransactionEventResponse {
TransactionEvent event = 1;
bool already_existed = 2;
}
message GetJournalRequest {
oneof lookup {
string journal_id = 1;
string idempotency_key = 2;
}
}
message ListEntriesRequest {
optional AccountReference account = 1;
optional int64 asset_id = 2;
google.protobuf.Timestamp recorded_from = 3;
google.protobuf.Timestamp recorded_to = 4;
uint32 page_size = 5;
string page_token = 6;
}
message ListEntriesResponse {
repeated Journal journals = 1;
string next_page_token = 2;
}
message GetBalanceRequest {
AccountReference account = 1;
google.protobuf.Timestamp as_of = 2;
}
message GetBalanceResponse {
AccountReference account = 1;
// Canonical base-10 decimal reconstructed from immutable entries.
string balance = 2;
google.protobuf.Timestamp as_of = 3;
}
message ReplayJournalsRequest {
// Each item is independently atomic and uses normal append idempotency.
repeated AppendJournalRequest journals = 1;
}
message ReplayJournalResult {
string idempotency_key = 1;
Journal journal = 2;
bool already_existed = 3;
}
message ReplayJournalsResponse {
repeated ReplayJournalResult results = 1;
}
message HealthResponse {
bool serving = 1;
bool database_ready = 2;
}
+16
View File
@@ -0,0 +1,16 @@
syntax = "proto3";
package ledger.v1;
import "base/v1/msg.proto";
import "ledger/v1/msg.proto";
service GeneralLedgerService {
rpc Health(base.v1.Empty) returns (HealthResponse);
rpc AppendJournal(AppendJournalRequest) returns (AppendJournalResponse);
rpc AppendTransactionEvent(AppendTransactionEventRequest) returns (AppendTransactionEventResponse);
rpc GetJournal(GetJournalRequest) returns (Journal);
rpc ListEntries(ListEntriesRequest) returns (ListEntriesResponse);
rpc GetBalance(GetBalanceRequest) returns (GetBalanceResponse);
rpc ReplayJournals(ReplayJournalsRequest) returns (ReplayJournalsResponse);
}
+3
View File
@@ -71,6 +71,7 @@ message MarketOrder {
repeated string tags = 20;
repeated string comment = 21;
optional MarketOrder source = 22; // purchase is done via this field
bool is_ico = 23;
// repeated string attachments = 14; // possible files included by
// seller/buyer
}
@@ -130,6 +131,7 @@ message NewMarketReq {
MarketOrderSide side = 8;
// TODO: maker market order as optional
optional uint64 maker_order_id = 9;
bool is_ico = 10;
}
enum MarketOrdersSortBy {
@@ -164,6 +166,7 @@ message OrderListFilter {
optional MarketOrdersSortBy sort_by = 19;
optional uint32 page_no = 21;
optional uint32 page_size = 22;
optional bool is_ico = 23;
}
/* Contract */
+3
View File
@@ -5,6 +5,7 @@ package market.v1;
import "auth/v1/msg.proto";
import "base/v1/msg.proto";
import "market/v1/msg.proto";
import "wallet/v1/msg.proto";
service MarketplaceSrv {
rpc MarketplaceSrvHealth(base.v1.Empty) returns (base.v1.StatusRes);
@@ -16,10 +17,12 @@ service MarketplaceSrv {
rpc GetMarketAssetList(MarketAssetListReq) returns (MarketAssetList); // assets that can be listed in marketplace
rpc CalcMarketOrder(CalcMarketReq) returns (CalcMarketRes);
rpc CalcICOBuy(wallet.v1.BuyAssetReq) returns (wallet.v1.CalcBuyAssetRes);
rpc CancelOrder(auth.v1.IdReqWithIAMAndTFA) returns (base.v1.StatusRes); // cancel an order
rpc NewMarketOrder(NewMarketReq) returns (MarketOrder); // insert new buy order to market
rpc GenerateMarketContract(MarketContractReq) returns (ContractMarketRes);
rpc ConfirmMarketContract(ConfirmMarketContractReq) returns (base.v1.StatusRes);
rpc SettleICOBuy(wallet.v1.ConfirmBuyAssetReq) returns (wallet.v1.BuyAssetRes);
}
+2
View File
@@ -814,12 +814,14 @@ message CalcBuyAssetRes {
double calculated_asset_amount = 3;
EffectiveCommission commission = 4;
optional AssetDiscountRes discount_detail = 5;
uint64 maker_order_id = 6;
}
message BuyAssetRes {
bool success = 1;
string irt_hash = 2;
string asset_hash = 3;
uint64 order_id = 4;
}
/* Contract */