diff --git a/doc/api.html b/doc/api.html index 2aaf0ce..6bed05e 100644 --- a/doc/api.html +++ b/doc/api.html @@ -437,6 +437,14 @@

Table of Contents

MCycleInfos +
  • + MDeferredCallQuote +
  • + +
  • + MDeferredCallQuoteResponse +
  • +
  • MDeferredCreditsEntry
  • @@ -2424,8 +2432,10 @@

    AsyncPoolChangesFilter

    can_be_executed bool -

    Boolean that determine if the message can be executed. For messages without filter this boolean is always true. -For messages with filter, this boolean is true if the filter has been matched between `validity_start` and current slot.

    +

    Boolean that determine if the message can be executed. For messages +without filter this boolean is always true. For messages with filter, +this boolean is true if the filter has been matched between +`validity_start` and current slot.

    @@ -2456,7 +2466,84 @@

    CycleInfos

    restrict_to_addresses string repeated -

    Addresses to restrict the query (if None, info for all addresses will be returned)

    +

    Addresses to restrict the query (if None, info for all addresses will be +returned)

    + + + + + + + + + +

    DeferredCallQuote

    +

    Deferred call quote

    + + + + + + + + + + + + + + + + + + + + + + + +
    FieldTypeLabelDescription
    target_slotmassa.model.v1.Slot

    max_gas_requestuint64

    + + + + + +

    DeferredCallQuoteResponse

    +

    deferred call quote response

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2936,6 +3023,13 @@

    ExecutionQueryRequestItem

    + + + + + + +
    FieldTypeLabelDescription
    target_slotmassa.model.v1.Slot

    the slot requested

    max_gas_requestuint64

    The gas requested

    availablebool

    if the quote is available

    pricemassa.model.v1.NativeAmount

    The amount

    Gets filtered events

    deferred_call_quoteDeferredCallQuote

    Deferred call quote

    @@ -3047,6 +3141,13 @@

    ExecutionQueryResponseItem

    Events

    + + deferred_call_quote + DeferredCallQuoteResponse + +

    Deferred call quote

    + + @@ -3752,7 +3853,7 @@

    GetTransactionsThroughput

    GetTransactionsThroughputResponse

    -

    GetTransactionsThroughputResponse holds response from GetTransactionsThroughput

    +

    GetTransactionsThroughputResponse holds response from

    GetTransactionsThroughput

    @@ -5321,7 +5422,7 @@

    ExecutionQueryExecutionStatu

    - + @@ -5484,7 +5585,8 @@

    PublicService

    - + diff --git a/doc/api.md b/doc/api.md index e8a8074..bf9823a 100644 --- a/doc/api.md +++ b/doc/api.md @@ -69,6 +69,8 @@ - [AddressRollsFinal](#massa-api-v1-AddressRollsFinal) - [AsyncPoolChangesFilter](#massa-api-v1-AsyncPoolChangesFilter) - [CycleInfos](#massa-api-v1-CycleInfos) + - [DeferredCallQuote](#massa-api-v1-DeferredCallQuote) + - [DeferredCallQuoteResponse](#massa-api-v1-DeferredCallQuoteResponse) - [DeferredCreditsEntry](#massa-api-v1-DeferredCreditsEntry) - [DeferredCreditsEntryWrapper](#massa-api-v1-DeferredCreditsEntryWrapper) - [DenunciationExecutionStatusCandidate](#massa-api-v1-DenunciationExecutionStatusCandidate) @@ -1054,6 +1056,40 @@ Request to get all information for a given cycle + + +### DeferredCallQuote +Deferred call quote + + +| Field | Type | Label | Description | +| ----- | ---- | ----- | ----------- | +| target_slot | [massa.model.v1.Slot](#massa-model-v1-Slot) | | | +| max_gas_request | [uint64](#uint64) | | | + + + + + + + + +### DeferredCallQuoteResponse +deferred call quote response + + +| Field | Type | Label | Description | +| ----- | ---- | ----- | ----------- | +| target_slot | [massa.model.v1.Slot](#massa-model-v1-Slot) | | the slot requested | +| max_gas_request | [uint64](#uint64) | | The gas requested | +| available | [bool](#bool) | | if the quote is available | +| price | [massa.model.v1.NativeAmount](#massa-model-v1-NativeAmount) | | The amount | + + + + + + ### DeferredCreditsEntry @@ -1255,6 +1291,7 @@ Query state query item | address_deferred_credits_final | [AddressDeferredCreditsFinal](#massa-api-v1-AddressDeferredCreditsFinal) | | Gets the deferred credits (final) of an address | | cycle_infos | [CycleInfos](#massa-api-v1-CycleInfos) | | Gets all information for a given cycle | | events | [Events](#massa-api-v1-Events) | | Gets filtered events | +| deferred_call_quote | [DeferredCallQuote](#massa-api-v1-DeferredCallQuote) | | Deferred call quote | @@ -1294,6 +1331,7 @@ Execution state query response item | execution_status | [ExecutionQueryExecutionStatus](#massa-api-v1-ExecutionQueryExecutionStatus) | | Execution status value | | cycle_infos | [ExecutionQueryCycleInfos](#massa-api-v1-ExecutionQueryCycleInfos) | | Cycle infos value | | events | [ScOutputEventsWrapper](#massa-api-v1-ScOutputEventsWrapper) | | Events | +| deferred_call_quote | [DeferredCallQuoteResponse](#massa-api-v1-DeferredCallQuoteResponse) | | Deferred call quote | @@ -1742,7 +1780,8 @@ GetTransactionsThroughputRequest holds request for GetTransactionsThroughput ### GetTransactionsThroughputResponse -GetTransactionsThroughputResponse holds response from GetTransactionsThroughput +GetTransactionsThroughputResponse holds response from +GetTransactionsThroughput | Field | Type | Label | Description | @@ -2561,7 +2600,7 @@ Execution status of an operation or denunciation | EXECUTION_QUERY_EXECUTION_STATUS_UNSPECIFIED | 0 | Default enum value | | EXECUTION_QUERY_EXECUTION_STATUS_ALREADY_EXECUTED_WITH_SUCCESS | 1 | The operation or denunciation was executed recently with success | | EXECUTION_QUERY_EXECUTION_STATUS_ALREADY_EXECUTED_WITH_FAILURE | 2 | The operation or denunciation was executed recently with failure | -| EXECUTION_QUERY_EXECUTION_STATUS_EXECUTABLE_OR_EXPIRED | 3 | The operation or denunciation was not executed recently but can still be executed unless expired | +| EXECUTION_QUERY_EXECUTION_STATUS_EXECUTABLE_OR_EXPIRED | 3 | The operation or denunciation was not executed recently but can | diff --git a/proto/apis/massa/api/v1/public.proto b/proto/apis/massa/api/v1/public.proto index fea86b7..cba9d77 100644 --- a/proto/apis/massa/api/v1/public.proto +++ b/proto/apis/massa/api/v1/public.proto @@ -159,7 +159,8 @@ service PublicService { }; } - // Get ABI call stack of all asynchronous executions and all operations for a given slot + // Get ABI call stack of all asynchronous executions and all operations for a + // given slot rpc GetSlotABICallStacks(GetSlotABICallStacksRequest) returns (GetSlotABICallStacksResponse) { option (google.api.http) = { post: "/v1/get_slot_abi_call_stacks" @@ -384,7 +385,8 @@ message GetStakersResponse { // GetTransactionsThroughputRequest holds request for GetTransactionsThroughput message GetTransactionsThroughputRequest {} -// GetTransactionsThroughputResponse holds response from GetTransactionsThroughput +// GetTransactionsThroughputResponse holds response from +// GetTransactionsThroughput message GetTransactionsThroughputResponse { // Transactions throughput uint32 throughput = 1; @@ -439,6 +441,8 @@ message ExecutionQueryRequestItem { CycleInfos cycle_infos = 19; // Gets filtered events Events events = 20; + // Deferred call quote + DeferredCallQuote deferred_call_quote = 21; } } @@ -562,7 +566,8 @@ message AddressDeferredCreditsFinal { message CycleInfos { // Cycle to query uint64 cycle = 1; - // Addresses to restrict the query (if None, info for all addresses will be returned) + // Addresses to restrict the query (if None, info for all addresses will be + // returned) repeated string restrict_to_addresses = 2; } @@ -572,6 +577,25 @@ message Events { repeated ScExecutionEventsFilter filters = 1; } +// Deferred call quote +message DeferredCallQuote { + massa.model.v1.Slot target_slot = 1; + + uint64 max_gas_request = 2; +} + +// deferred call quote response +message DeferredCallQuoteResponse { + // the slot requested + massa.model.v1.Slot target_slot = 1; + // The gas requested + uint64 max_gas_request = 2; + // if the quote is available + bool available = 3; + // The amount + massa.model.v1.NativeAmount price = 4; +} + // Response to atomically execute a batch of execution state queries message QueryStateResponse { // Final cursor position @@ -616,6 +640,8 @@ message ExecutionQueryResponseItem { ExecutionQueryCycleInfos cycle_infos = 8; // Events ScOutputEventsWrapper events = 9; + // Deferred call quote + DeferredCallQuoteResponse deferred_call_quote = 10; } } @@ -638,7 +664,8 @@ enum ExecutionQueryExecutionStatus { EXECUTION_QUERY_EXECUTION_STATUS_UNSPECIFIED = 0; // Default enum value EXECUTION_QUERY_EXECUTION_STATUS_ALREADY_EXECUTED_WITH_SUCCESS = 1; // The operation or denunciation was executed recently with success EXECUTION_QUERY_EXECUTION_STATUS_ALREADY_EXECUTED_WITH_FAILURE = 2; // The operation or denunciation was executed recently with failure - EXECUTION_QUERY_EXECUTION_STATUS_EXECUTABLE_OR_EXPIRED = 3; // The operation or denunciation was not executed recently but can still be executed unless expired + EXECUTION_QUERY_EXECUTION_STATUS_EXECUTABLE_OR_EXPIRED = 3; // The operation or denunciation was not executed recently but can + // still be executed unless expired } // Cycle information for execution query @@ -830,8 +857,10 @@ message AsyncPoolChangesFilter { string destination_address = 4; // The address that sent the message string emitter_address = 5; - // Boolean that determine if the message can be executed. For messages without filter this boolean is always true. - // For messages with filter, this boolean is true if the filter has been matched between `validity_start` and current slot. + // Boolean that determine if the message can be executed. For messages + // without filter this boolean is always true. For messages with filter, + // this boolean is true if the filter has been matched between + // `validity_start` and current slot. bool can_be_executed = 6; } }
    EXECUTION_QUERY_EXECUTION_STATUS_EXECUTABLE_OR_EXPIRED 3

    The operation or denunciation was not executed recently but can still be executed unless expired

    The operation or denunciation was not executed recently but can

    GetSlotABICallStacks GetSlotABICallStacksRequest GetSlotABICallStacksResponse

    Get ABI call stack of all asynchronous executions and all operations for a given slot

    Get ABI call stack of all asynchronous executions and all operations for a +given slot