Messages

​

Messages

이 섹션에서는 ocr 메시지 처리와 해당 state 업데이트에 대해 설명합니다.

​

Msg/CreateFeed

MsgCreateFeed는 feed config를 생성하는 메시지이며, 모듈 관리자만 실행할 수 있는 제한된 메시지입니다.

message MsgCreateFeed {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;
  string sender = 1;
  FeedConfig config = 2;
}

단계

• Sender가 모듈 관리자인지 확인
• msg.Config.OnchainConfig.LinkDenom이 모듈 param의 LinkDenom인지 확인
• ctx.ChainID에서 OnchainConfig.ChainId 설정
• 동일한 FeedId를 가진 FeedConfig가 존재하지 않는지 확인
• 최신 EpochAndRound를 (0, 0)으로 설정
• feedId에 대한 feed config 설정
• Feed transmission count와 observation count를 1로 설정

​

Msg/UpdateFeed

MsgCreateFeed는 feed config를 업데이트하는 메시지이며, feed 관리자 또는 feed billing 관리자만 실행할 수 있는 제한된 메시지입니다.

message MsgUpdateFeed {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;
  string sender = 1;
  // feed_id is an unique ID for the target of this config
  string feed_id = 2;
  // signers ith element is address ith oracle uses to sign a report
  repeated string signers = 3;
  // transmitters ith element is address ith oracle uses to transmit a report via the transmit method
  repeated string transmitters = 4;
  // Fixed LINK reward for each observer
  string link_per_observation = 5[
    (gogoproto.customtype) = "cosmossdk.io/math.Int",
    (gogoproto.nullable) = true
  ];
  // Fixed LINK reward for transmitter
  string link_per_transmission = 6[
    (gogoproto.customtype) = "cosmossdk.io/math.Int",
    (gogoproto.nullable) = true
  ];
  // Native denom for LINK coin in the bank keeper
  string link_denom = 7;
  // feed administrator
  string feed_admin = 8;
  // feed billing administrator
  string billing_admin = 9;
}

단계

• feedId로 이전 feed config를 가져오고 존재하는지 확인
• Sender가 feed 관리자 또는 feed billing 관리자인지 확인
• Billing 관리자가 Signer, Transmitter 및 feed 관리자를 변경하지 않는지 확인
• 이전 feed config에 대한 보상 지급 처리
• 이전 feed transmission 및 observation count 삭제
• 최신 EpochAndRound를 (0, 0)으로 설정
• 설정된 경우 signer, transmitter, LinkPerObservation, LinkPerTransmission, LinkDenom, FeedAdmin, BillingAdmin 업데이트

​

Msg/Transmit

MsgTransmit은 특정 feed에 대한 report를 전송하는 메시지입니다. 메시지를 브로드캐스트할 때, 수락되려면 observer로부터 충분한 양의 서명이 있어야 합니다.

message MsgTransmit {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;
  // Address of the transmitter
  string transmitter = 1;
  bytes config_digest = 2;
  string feed_id = 3;
  uint64 epoch = 4;
  uint64 round = 5;
  bytes extra_hash = 6;
  Report report = 7;
  repeated bytes signatures = 8;
}

단계

• feedId에 대한 epoch 및 round 가져오기
• msg.Epoch 및 msg.Round를 확인하여 report가 오래된 것이 아닌지 확인
• feedId에서 feed config 및 config info 가져오기
• msg.ConfigDigest가 feed config info의 latest config digest와 같은지 확인
• Transmitter가 feedConfig에 구성된 유효한 transmitter인지 확인
• Transmitter report 저장
• Transmission에 대한 이벤트 발생
• 서명 및 서명 수 검증
• Feed observation 및 transmission count 증가

​

Msg/FundFeedRewardPool

MsgFundFeedRewardPool은 transmitter와 observer에게 지급할 feed reward pool에 자금을 추가하는 메시지입니다.

message MsgFundFeedRewardPool {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  string sender = 1;
  string feed_id = 2;
  cosmos.base.v1beta1.Coin amount = 3 [(gogoproto.nullable) = false];
}

단계

• feedId에서 이전 reward pool 금액 가져오기
• 이전 금액이 비어 있으면 pool 금액을 0으로 초기화
• 이전 금액 denom이 존재하는 경우 입금 denom과 다르지 않은지 확인
• 계정에서 모듈 계정(ocr 모듈)으로 코인 전송
• amount 필드 추가로 reward pool 금액 업데이트
• Hook이 설정된 경우 AfterFundFeedRewardPool hook 호출

​

Msg/WithdrawFeedRewardPool

MsgFundFeedRewardPool은 feed reward pool에서 자금을 인출하는 메시지이며, feed 관리자 또는 billing 관리자로 제한됩니다.

message MsgWithdrawFeedRewardPool {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  string sender = 1;
  string feed_id = 2;
  cosmos.base.v1beta1.Coin amount = 3 [(gogoproto.nullable) = false];
}

단계

• feedId에서 feed config 가져오기
• msg.Sender가 feedAdmin 또는 billingAdmin인지 확인
• Feed에 대한 보상 처리
• 모듈 계정에서 지정된 금액 msg.Amount 인출

​

Msg/SetPayees

MsgSetPayees는 transmitter에 대한 payee를 설정하는 메시지이며, feed 관리자로 제한됩니다. 한 번 설정되면 payee만 변경할 수 있습니다.

message MsgSetPayees {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  string sender = 1;
  string feed_id = 2;
  // addresses oracles use to transmit the reports
  repeated string transmitters = 3;
  // addresses of payees corresponding to list of transmitters
  repeated string payees = 4;
}

단계

• feedId에서 feed config를 가져오고 feed config가 존재하는지 확인
• msg.Sender가 feed 관리자인지 확인
• msg.Transmitters 반복,
• 1. Transmitter에 대해 payee가 이미 설정되어 있는지 확인
• 2. Transmitter에 대한 payee 설정

​

Msg/TransferPayeeship

MsgTransferPayeeship은 feed의 특정 transmitter에 대한 payeeship을 이전하는 메시지입니다. 실행 후 pending payeeship 객체가 생성됩니다.

message MsgTransferPayeeship {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;

  // transmitter address of oracle whose payee is changing
  string sender = 1;
  string transmitter = 2;
  string feed_id = 3;
  // new payee address
  string proposed = 4;
}

단계

• feedId에서 feed config를 가져오고 feed config가 존재하는지 확인
• msg.Sender가 현재 payee인지 확인
• 이전 pending payeeship transfer 레코드를 확인하고 이전 payeeship transfer가 충돌하지 않는지 확인
• Payeeship transfer 레코드 설정

​

Msg/AcceptPayeeship

MsgTransferPayeeship은 feed의 특정 transmitter에 대한 payeeship을 수락하는 메시지입니다.

message MsgAcceptPayeeship {
  option (gogoproto.equal) = false;
  option (gogoproto.goproto_getters) = false;
  // new payee address
  string payee = 1;
  // transmitter address of oracle whose payee is changing
  string transmitter = 2;
  string feed_id = 3;
}

단계

• feedId에서 feed config를 가져오고 feed config가 존재하는지 확인
• msg.Transmitter 및 feedId에 대한 pending payeeship transfer 레코드 가져오기
• feedId 및 transmitter에 대한 payee 재설정
• feedId의 transmitter에 대한 pending payeeship transfer 삭제