lnlink-server 1.0.0

package/dist/proto/price_oracle.proto

@@ -0,0 +1,243 @@
+syntax = "proto3";
+
+package priceoraclerpc;
+
+option go_package = "github.com/lightninglabs/taproot-assets/taprpc/priceoraclerpc";
+
+service PriceOracle {
+    /*
+    QueryAssetRates retrieves the exchange rate between a tap asset and BTC for
+    a specified transaction type, subject asset, and payment asset. The asset
+    rate represents the number of tap asset units per BTC.
+    */
+    rpc QueryAssetRates (QueryAssetRatesRequest)
+        returns (QueryAssetRatesResponse);
+}
+
+// TransactionType is an enum representing the type of transaction.
+enum TransactionType {
+    // PURCHASE indicates a purchase transaction.
+    PURCHASE = 0;
+
+    // SALE indicates a sale transaction.
+    SALE = 1;
+}
+
+// Intent is an enum informing the price oracle about the intent of the price
+// rate query. This is used to provide context for the asset rates being
+// requested, allowing the price oracle to tailor the response based on the
+// specific use case, such as paying an invoice or receiving a payment and the
+// different stages involved in those.
+enum Intent {
+    // INTENT_UNSPECIFIED is used to indicate that the intent of the price rate
+    // query is not specified. This is the fallback default value and should not
+    // be used in production code. It is primarily used for backward
+    // compatibility with older versions of the protocol that did not include
+    // intent information.
+    INTENT_UNSPECIFIED = 0;
+
+    // INTENT_PAY_INVOICE_HINT is used to indicate that the user is requesting
+    // a price rate hint for paying an invoice. This is typically used by the
+    // payer of an invoice to provide a suggestion of the expected asset rate to
+    // the RFQ peer (edge node) that will determine the actual rate for the
+    // payment.
+    INTENT_PAY_INVOICE_HINT = 1;
+
+    // INTENT_PAY_INVOICE is used to indicate that a peer wants to pay an
+    // invoice with assets. This is typically used by the edge node that
+    // facilitates the swap from assets to BTC for the payer of an invoice. This
+    // intent is used to provide the actual asset rate for the payment, which
+    // may differ from the hint provided by the payer.
+    INTENT_PAY_INVOICE = 2;
+
+    // INTENT_PAY_INVOICE_QUALIFY is used to indicate that the payer of an
+    // invoice has received an asset rate from their RFQ peer (edge node) and is
+    // qualifying the rate for the payment. This is typically used by the payer
+    // of an invoice to ensure that the asset rate provided by their peer (edge
+    // node) is acceptable before proceeding with the payment.
+    INTENT_PAY_INVOICE_QUALIFY = 3;
+
+    // INTENT_RECV_PAYMENT_HINT is used to indicate that the user is requesting
+    // a price rate hint for receiving a payment through an invoice. This is
+    // typically used by the creator of an invoice to provide a suggestion of
+    // the expected asset rate to the RFQ peer (edge node) that will determine
+    // the actual rate used for creating an invoice.
+    INTENT_RECV_PAYMENT_HINT = 4;
+
+    // INTENT_RECV_PAYMENT is used to indicate that a peer wants to create an
+    // invoice to receive a payment with assets. This is typically used by the
+    // edge node that facilitates the swap from BTC to assets for the receiver
+    // of a payment. This intent is used to provide the actual asset rate for
+    // the invoice creation, which may differ from the hint provided by the
+    // receiver.
+    INTENT_RECV_PAYMENT = 5;
+
+    // INTENT_RECV_PAYMENT_QUALIFY is used to indicate that the creator of an
+    // invoice received an asset rate from their RFQ peer (edge node) and is
+    // qualifying the rate for the creation of the invoice. This is typically
+    // used by the creator of an invoice to ensure that the asset rate provided
+    // by their peer (edge node) is acceptable before proceeding with creating
+    // the invoice.
+    INTENT_RECV_PAYMENT_QUALIFY = 6;
+}
+
+// FixedPoint is a scaled integer representation of a fractional number.
+//
+// This type consists of two integer fields: a coefficient and a scale.
+// Using this format enables precise and consistent representation of fractional
+// numbers while avoiding floating-point data types, which are prone to
+// precision errors.
+//
+// The relationship between the fractional representation and its fixed-point
+// representation is expressed as:
+// ```
+// V = F_c / (10^F_s)
+// ```
+// where:
+//
+// * `V` is the fractional value.
+//
+// * `F_c` is the coefficient component of the fixed-point representation. It is
+//    the scaled-up fractional value represented as an integer.
+//
+// * `F_s` is the scale component. It is an integer specifying how
+//   many decimal places `F_c` should be divided by to obtain the fractional
+//   representation.
+message FixedPoint {
+    // The coefficient is the fractional value scaled-up as an integer. This
+    // integer is represented as a string as it may be too large to fit in a
+    // uint64.
+    string coefficient = 1;
+
+    // The scale is the component that determines how many decimal places
+    // the coefficient should be divided by to obtain the fractional value.
+    uint32 scale = 2;
+}
+
+// AssetRates represents the exchange rates for subject and payment assets
+// relative to BTC, expressed as fixed-point numbers. It includes the rates
+// for both assets and an expiration timestamp indicating when the rates
+// are no longer valid.
+message AssetRates {
+    // subjectAssetRate is the number of subject asset units per BTC represented
+    // as a fixed-point number. This field is also commonly referred to as the
+    // subject asset to BTC (conversion) rate. When the subject asset is BTC,
+    // this field should be set to 100 billion, as one BTC is equivalent to 100
+    // billion msats.
+    FixedPoint subjectAssetRate = 1;
+
+    // paymentAssetRate is the number of payment asset units per BTC represented
+    // as a fixed-point number. This field is also commonly referred to as the
+    // payment asset to BTC (conversion) rate. When the payment asset is BTC,
+    // this field should be set to 100 billion, as one BTC is equivalent to 100
+    // billion msats.
+    FixedPoint paymentAssetRate = 2;
+
+    // expiry_timestamp is the Unix timestamp in seconds after which the asset
+    // rates are no longer valid.
+    uint64 expiry_timestamp = 3;
+}
+
+// AssetSpecifier is a union type for specifying an asset by either its asset ID
+// or group key.
+message AssetSpecifier {
+    oneof id {
+        // The 32-byte asset ID specified as raw bytes (gRPC only).
+        bytes asset_id = 1;
+
+        // The 32-byte asset ID encoded as a hex string (use this for REST).
+        string asset_id_str = 2;
+
+        // The 32-byte asset group key specified as raw bytes (gRPC only).
+        bytes group_key = 3;
+
+        // The 32-byte asset group key encoded as hex string (use this for
+        // REST).
+        string group_key_str = 4;
+    }
+}
+
+// QueryAssetRatesRequest specifies the parameters for querying asset exchange
+// rates in a transaction. It includes the transaction type, details about the
+// subject and payment assets, and an optional hint for expected asset rates.
+message QueryAssetRatesRequest {
+    // transaction_type indicates whether the transaction is a purchase or a
+    // sale.
+    TransactionType transaction_type = 1;
+
+    // subject_asset is the asset to be priced for purchase or sale.
+    AssetSpecifier subject_asset = 2;
+
+    // subject_asset_max_amount is the maximum amount of the subject asset that
+    // could be involved in the transaction.
+    uint64 subject_asset_max_amount = 3;
+
+    // payment_asset is the asset used for purchasing or receiving from a sale.
+    //
+    // NOTE: An asset ID of all zeros indicates that the payment asset is BTC.
+    // In this case, the asset rate will be given as milli-satoshi per asset
+    // unit
+    AssetSpecifier payment_asset = 4;
+
+    // payment_asset_max_amount is the maximum amount of the payment asset that
+    // could be involved in the transaction. This field is optional. If set to
+    // zero, it is considered unset.
+    uint64 payment_asset_max_amount = 5;
+
+    // asset_rates_hint is an optional suggestion of asset rates for the
+    // transaction, intended to provide guidance on expected pricing.
+    AssetRates asset_rates_hint = 6;
+
+    // intent informs the price oracle about the stage of the payment flow that
+    // lead to the price rate query. This is used to provide context for the
+    // asset rates being requested, allowing the price oracle to tailor the
+    // response based on the specific use case, such as paying an invoice or
+    // receiving a payment and the different stages involved in those. This
+    // field will only be set by tapd v0.7.0 and later.
+    Intent intent = 7;
+
+    // counterparty_id is the 33-byte public key of the peer that is on the
+    // opposite side of the transaction. This field will only be set by tapd
+    // v0.7.0 and later and only if the user initiating the transaction (sending
+    // a payment or creating an invoice) opted in to sharing their peer ID with
+    // the price oracle.
+    bytes counterparty_id = 8;
+
+    // metadata is an optional text field that can be used to provide
+    // additional metadata about the transaction to the price oracle. This can
+    // include information about the wallet end user that initiated the
+    // transaction, or any authentication information that the price oracle
+    // can use to give out a more accurate (or discount) asset rate. Though not
+    // verified or enforced by tapd, the suggested format for this field is a
+    // JSON string. This field is optional and can be left empty if no metadata
+    // is available. The maximum length of this field is 32'768 bytes. This
+    // field will only be set by tapd v0.7.0 and later.
+    string metadata = 9;
+}
+
+// QueryAssetRatesOkResponse is the successful response to a
+// QueryAssetRates call.
+message QueryAssetRatesOkResponse {
+    // asset_rates is the asset exchange rates for the transaction.
+    AssetRates asset_rates = 1;
+}
+
+// QueryAssetRatesErrResponse is the error response to a QueryAssetRates call.
+message QueryAssetRatesErrResponse {
+    // error is the error message.
+    string message = 1;
+
+    // code is the error code.
+    uint32 code = 2;
+}
+
+// QueryAssetRatesResponse is the response from a QueryAssetRates RPC call.
+message QueryAssetRatesResponse {
+    oneof result {
+        // ok is the successful response to the query.
+        QueryAssetRatesOkResponse ok = 1;
+
+        // error is the error response to the query.
+        QueryAssetRatesErrResponse error = 2;
+    }
+}

package/dist/proto/rfqrpc/rfq.proto

@@ -0,0 +1,436 @@
+syntax = "proto3";
+
+package rfqrpc;
+
+option go_package = "github.com/lightninglabs/taproot-assets/taprpc/rfqrpc";
+
+service Rfq {
+    /* tapcli: `rfq buyorder`
+    AddAssetBuyOrder is used to add a buy order for a specific asset. If a buy
+    order already exists for the asset, it will be updated.
+
+    A buy order instructs the RFQ (Request For Quote) system to request a quote
+    from a peer for the acquisition of an asset.
+
+    The normal use of a buy order is as follows:
+    1. Alice, operating a wallet node, wants to receive a Tap asset as payment
+       by issuing a Lightning invoice.
+    2. Alice has an asset channel established with Bob's edge node.
+    3. Before issuing the invoice, Alice needs to agree on an exchange rate with
+       Bob, who will facilitate the asset transfer.
+    4. To obtain the best exchange rate, Alice creates a buy order specifying
+       the desired asset.
+    5. Alice's RFQ subsystem processes the buy order and sends buy requests to
+       relevant peers to find the best rate. In this example, Bob is the only
+       available peer.
+    6. Once Bob provides a satisfactory quote, Alice accepts it.
+    7. Alice issues the Lightning invoice, which Charlie will pay.
+    8. Instead of paying Alice directly, Charlie pays Bob.
+    9. Bob then forwards the agreed amount of the Tap asset to Alice over their
+       asset channel.
+    */
+    rpc AddAssetBuyOrder (AddAssetBuyOrderRequest)
+        returns (AddAssetBuyOrderResponse);
+
+    /* tapcli: `rfq sellorder`
+    AddAssetSellOrder is used to add a sell order for a specific asset. If a
+    sell order already exists for the asset, it will be updated.
+    */
+    rpc AddAssetSellOrder (AddAssetSellOrderRequest)
+        returns (AddAssetSellOrderResponse);
+
+    /* tapcli: `rfq selloffer`
+    AddAssetSellOffer is used to add a sell offer for a specific asset. If a
+    sell offer already exists for the asset, it will be updated.
+    */
+    rpc AddAssetSellOffer (AddAssetSellOfferRequest)
+        returns (AddAssetSellOfferResponse);
+
+    /* tapcli: `rfq buyoffer`
+    AddAssetBuyOffer is used to add a buy offer for a specific asset. If a
+    buy offer already exists for the asset, it will be updated.
+
+    A buy offer is used by the node to selectively accept or reject incoming
+    asset sell quote requests before price is considered.
+    */
+    rpc AddAssetBuyOffer (AddAssetBuyOfferRequest)
+        returns (AddAssetBuyOfferResponse);
+
+    /* tapcli: `rfq acceptedquotes`
+    QueryPeerAcceptedQuotes is used to query for quotes that were requested by
+    our node and have been accepted our peers.
+    */
+    rpc QueryPeerAcceptedQuotes (QueryPeerAcceptedQuotesRequest)
+        returns (QueryPeerAcceptedQuotesResponse);
+
+    /*
+    SubscribeRfqEventNtfns is used to subscribe to RFQ events.
+    */
+    rpc SubscribeRfqEventNtfns (SubscribeRfqEventNtfnsRequest)
+        returns (stream RfqEvent);
+}
+
+message AssetSpecifier {
+    oneof id {
+        // The 32-byte asset ID specified as raw bytes (gRPC only).
+        bytes asset_id = 1;
+
+        // The 32-byte asset ID encoded as a hex string (use this for REST).
+        string asset_id_str = 2;
+
+        // The 32-byte asset group key specified as raw bytes (gRPC only).
+        bytes group_key = 3;
+
+        // The 32-byte asset group key encoded as hex string (use this for
+        // REST).
+        string group_key_str = 4;
+    }
+}
+
+// FixedPoint is a scaled integer representation of a fractional number.
+//
+// This type consists of two integer fields: a coefficient and a scale.
+// Using this format enables precise and consistent representation of fractional
+// numbers while avoiding floating-point data types, which are prone to
+// precision errors.
+//
+// The relationship between the fractional representation and its fixed-point
+// representation is expressed as:
+// ```
+// V = F_c / (10^F_s)
+// ```
+// where:
+//
+// * `V` is the fractional value.
+//
+// * `F_c` is the coefficient component of the fixed-point representation. It is
+//    the scaled-up fractional value represented as an integer.
+//
+// * `F_s` is the scale component. It is an integer specifying how
+//   many decimal places `F_c` should be divided by to obtain the fractional
+//   representation.
+message FixedPoint {
+    // The coefficient is the fractional value scaled-up as an integer. This
+    // integer is represented as a string as it may be too large to fit in a
+    // uint64.
+    string coefficient = 1;
+
+    // The scale is the component that determines how many decimal places
+    // the coefficient should be divided by to obtain the fractional value.
+    uint32 scale = 2;
+}
+
+message AddAssetBuyOrderRequest {
+    // asset_specifier is the subject asset.
+    AssetSpecifier asset_specifier = 1;
+
+    // The maximum amount of the asset that the provider must be willing to
+    // offer.
+    uint64 asset_max_amt = 2;
+
+    // The unix timestamp in seconds after which the order is no longer valid.
+    uint64 expiry = 3;
+
+    // The public key of the intended recipient peer for the order.
+    bytes peer_pub_key = 4;
+
+    // timeout_seconds is the number of seconds to wait for the peer to respond
+    // with an accepted quote (or a rejection).
+    uint32 timeout_seconds = 5;
+
+    // If set, the check if a channel with the given asset exists with the peer
+    // will be skipped. An active channel with the peer is still required for
+    // the RFQ negotiation to work. This flag shouldn't be set outside of test
+    // scenarios.
+    bool skip_asset_channel_check = 6;
+
+    // An optional text field that can be used to provide additional metadata
+    // about the buy order to the price oracle. This can include information
+    // about the wallet end user that initiated the transaction, or any
+    // authentication information that the price oracle can use to give out a
+    // more accurate (or discount) asset rate. Though not verified or enforced
+    // by tapd, the suggested format for this field is a JSON string.
+    // This field is optional and can be left empty if no metadata is available.
+    // The maximum length of this field is 32'768 bytes.
+    string price_oracle_metadata = 7;
+}
+
+message AddAssetBuyOrderResponse {
+    oneof response {
+        // accepted_quote holds the quote received from the peer as a response
+        // to our quote request.
+        PeerAcceptedBuyQuote accepted_quote = 1;
+
+        // invalid_quote is returned if the quote response received from the
+        // peer was invalid or insufficient.
+        InvalidQuoteResponse invalid_quote = 2;
+
+        // rejected_quote is returned if the quote request was rejected by the
+        // peer.
+        RejectedQuoteResponse rejected_quote = 3;
+    }
+}
+
+message AddAssetSellOrderRequest {
+    // asset_specifier is the subject asset.
+    AssetSpecifier asset_specifier = 1;
+
+    // The maximum msat amount that the responding peer must agree to pay
+    // (units: millisats).
+    uint64 payment_max_amt = 2;
+
+    // The unix timestamp in seconds after which the order is no longer valid.
+    uint64 expiry = 3;
+
+    // The public key of the intended recipient peer for the order.
+    bytes peer_pub_key = 4;
+
+    // timeout_seconds is the number of seconds to wait for the peer to respond
+    // with an accepted quote (or a rejection).
+    uint32 timeout_seconds = 5;
+
+    // If set, the check if a channel with the given asset exists with the peer
+    // will be skipped. An active channel with the peer is still required for
+    // the RFQ negotiation to work. This flag shouldn't be set outside of test
+    // scenarios.
+    bool skip_asset_channel_check = 6;
+
+    // An optional text field that can be used to provide additional metadata
+    // about the sell order to the price oracle. This can include information
+    // about the wallet end user that initiated the transaction, or any
+    // authentication information that the price oracle can use to give out a
+    // more accurate (or discount) asset rate. Though not verified or enforced
+    // by tapd, the suggested format for this field is a JSON string.
+    // This field is optional and can be left empty if no metadata is available.
+    // The maximum length of this field is 32'768 bytes.
+    string price_oracle_metadata = 7;
+}
+
+message AddAssetSellOrderResponse {
+    oneof response {
+        // accepted_quote holds the quote received from the peer as a response
+        // to our quote request.
+        PeerAcceptedSellQuote accepted_quote = 1;
+
+        // invalid_quote is returned if the quote response received from the
+        // peer was invalid or insufficient.
+        InvalidQuoteResponse invalid_quote = 2;
+
+        // rejected_quote is returned if the quote request was rejected by the
+        // peer.
+        RejectedQuoteResponse rejected_quote = 3;
+    }
+}
+
+message AddAssetSellOfferRequest {
+    // asset_specifier is the subject asset.
+    AssetSpecifier asset_specifier = 1;
+
+    // max_units is the maximum amount of the asset to sell.
+    uint64 max_units = 2;
+}
+
+message AddAssetSellOfferResponse {
+}
+
+message AddAssetBuyOfferRequest {
+    // asset_specifier is the subject asset.
+    AssetSpecifier asset_specifier = 1;
+
+    // max_units is the maximum amount of the asset to buy.
+    uint64 max_units = 2;
+}
+
+message AddAssetBuyOfferResponse {
+}
+
+message QueryPeerAcceptedQuotesRequest {
+}
+
+message AssetSpec {
+    // The 32-byte asset ID specified as raw bytes.
+    bytes id = 1;
+
+    // The 32-byte asset group public key, serialized in BIP340 format.
+    // BIP340 defines a canonical encoding for Schnorr public keys.
+    // This field is serialized using schnorr.SerializePubKey.
+    bytes group_pub_key = 2;
+}
+
+message PeerAcceptedBuyQuote {
+    // Quote counterparty peer.
+    string peer = 1;
+
+    // The unique identifier of the quote request.
+    bytes id = 2;
+
+    // The short channel ID of the channel over which the payment for the quote
+    // should be made.
+    uint64 scid = 3;
+
+    // The maximum exchange amount denoted in the subject asset. This includes
+    // the user-configured maximum routing fees, so the actual payment amount
+    // will be less than this. This just defines the maximum volume that the
+    // edge node has accepted to divest with the given rate.
+    uint64 asset_max_amount = 4;
+
+    // ask_asset_rate is the asset to BTC conversion rate represented as a
+    // fixed-point number.
+    FixedPoint ask_asset_rate = 5;
+
+    // The unix timestamp in seconds after which the quote is no longer valid.
+    uint64 expiry = 6;
+
+    // The smallest amount of asset units that can be transported within a
+    // single HTLC over the Lightning Network with the given rate. This is the
+    // asset unit equivalent of 354 satoshis, which is the minimum amount for an
+    // HTLC to be above the dust limit.
+    uint64 min_transportable_units = 7;
+
+    // An optional user-provided text field used to provide additional metadata
+    // about the buy order to the price oracle. This can include information
+    // about the wallet end user that initiated the transaction, or any
+    // authentication information that the price oracle can use to give out a
+    // more accurate (or discount) asset rate.
+    string price_oracle_metadata = 8;
+
+    // The subject asset specifier.
+    AssetSpec asset_spec = 9;
+}
+
+message PeerAcceptedSellQuote {
+    // Quote counterparty peer.
+    string peer = 1;
+
+    // The unique identifier of the quote request.
+    bytes id = 2;
+
+    // scid is the short channel ID of the channel over which the payment for
+    // the quote should be made.
+    uint64 scid = 3;
+
+    // asset_amount is the amount of the subject asset.
+    uint64 asset_amount = 4;
+
+    // bid_asset_rate is the asset to BTC conversion rate represented as a
+    // fixed-point number.
+    FixedPoint bid_asset_rate = 5;
+
+    // The unix timestamp in seconds after which the quote is no longer valid.
+    uint64 expiry = 6;
+
+    // The minimum amount of milli-satoshis that need to be sent out in order to
+    // transport a single asset unit over the Lightning Network with the given
+    // rate. This is the base amount of 354,000 milli-satoshi (the minimum
+    // amount for a non-dust HTLC) plus the equivalent of one asset unit in
+    // milli-satoshis.
+    uint64 min_transportable_msat = 7;
+
+    // An optional user-provided text field used to provide additional metadata
+    // about the sell order to the price oracle. This can include information
+    // about the wallet end user that initiated the transaction, or any
+    // authentication information that the price oracle can use to give out a
+    // more accurate (or discount) asset rate.
+    string price_oracle_metadata = 8;
+
+    // The subject asset specifier.
+    AssetSpec asset_spec = 9;
+}
+
+// QuoteRespStatus is an enum that represents the status of a quote response.
+enum QuoteRespStatus {
+    // INVALID_ASSET_RATES indicates that at least one asset rate in the
+    // quote response is invalid.
+    INVALID_ASSET_RATES = 0;
+
+    // INVALID_EXPIRY indicates that the expiry in the quote response is
+    // invalid.
+    INVALID_EXPIRY = 1;
+
+    // PRICE_ORACLE_QUERY_ERR indicates that an error occurred when querying the
+    // price oracle whilst evaluating the quote response.
+    PRICE_ORACLE_QUERY_ERR = 2;
+}
+
+// InvalidQuoteResponse is a message that is returned when a quote response is
+// invalid or insufficient.
+message InvalidQuoteResponse {
+    // status is the status of the quote response.
+    QuoteRespStatus status = 1;
+
+    // peer is the quote counterparty peer.
+    string peer = 2;
+
+    // id is the unique identifier of the quote request.
+    bytes id = 3;
+}
+
+// RejectedQuoteResponse is a message that is returned when a quote request is
+// rejected by the peer.
+message RejectedQuoteResponse {
+    // peer is the quote counterparty peer.
+    string peer = 1;
+
+    // id is the unique identifier of the quote request.
+    bytes id = 2;
+
+    // error_message is a human-readable error message.
+    string error_message = 3;
+
+    // error_code is a machine-readable error code.
+    uint32 error_code = 4;
+}
+
+message QueryPeerAcceptedQuotesResponse {
+    // buy_quotes is a list of asset buy quotes which were requested by our
+    // node and have been accepted by our peers.
+    repeated PeerAcceptedBuyQuote buy_quotes = 1;
+
+    // sell_quotes is a list of asset sell quotes which were requested by our
+    // node and have been accepted by our peers.
+    repeated PeerAcceptedSellQuote sell_quotes = 2;
+}
+
+message SubscribeRfqEventNtfnsRequest {
+}
+
+message PeerAcceptedBuyQuoteEvent {
+    // Unix timestamp in microseconds.
+    uint64 timestamp = 1;
+
+    // The asset buy quote that was accepted by out peer.
+    PeerAcceptedBuyQuote peer_accepted_buy_quote = 2;
+}
+
+message PeerAcceptedSellQuoteEvent {
+    // Unix timestamp in microseconds.
+    uint64 timestamp = 1;
+
+    // The asset sell quote that was accepted by out peer.
+    PeerAcceptedSellQuote peer_accepted_sell_quote = 2;
+}
+
+message AcceptHtlcEvent {
+    // Unix timestamp in microseconds.
+    uint64 timestamp = 1;
+
+    // scid is the short channel ID of the channel over which the payment for
+    // the quote is made.
+    uint64 scid = 2;
+}
+
+message RfqEvent {
+    oneof event {
+        // peer_accepted_buy_quote is an event that is emitted when a peer
+        // accepted (incoming) asset buy quote message is received.
+        PeerAcceptedBuyQuoteEvent peer_accepted_buy_quote = 1;
+
+        // peer_accepted_sell_offer is an event that is emitted when a peer
+        // accepted (incoming) asset sell quote message is received.
+        PeerAcceptedSellQuoteEvent peer_accepted_sell_quote = 2;
+
+        // accept_htlc is an event that is sent when a HTLC is accepted by the
+        // RFQ service.
+        AcceptHtlcEvent accept_htlc = 3;
+    }
+}