Class: TonClient::Net

Inherits:
Object show all
Includes:
CommonInstanceHelpers
Defined in:
lib/everscale-client-ruby/Client/Net.rb

Constant Summary collapse

MODULE = 
self.to_s.downcase.gsub(/^(.+::|)(\w+)$/, '\2').freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from CommonInstanceHelpers

#base64?, #encode_to_base64, #full_method_name

Constructor Details

#initialize(context: Context.new, core: TonClient::TonBinding) ⇒ Net

Returns a new instance of Net.



9
10
11
12
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 9

def initialize(context: Context.new, core: TonClient::TonBinding)
  @context = context
  @core = core
end

Instance Attribute Details

#context ⇒ Object (readonly)

Returns the value of attribute context.



6
7
8
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 6

def context
  @context
end

#core ⇒ Object (readonly)

Returns the value of attribute core.



6
7
8
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 6

def core
  @core
end

Instance Method Details

#aggregate_collection(payload, &block) ⇒ Object

INPUT: ParamsOfAggregateCollection collection: String - # # Collection name (accounts, blocks, transactions, messages, block_signatures) filter: Value - # # Collection filter fields: Array<Optional> - # # Projection (result) string RESPONSE: ResultOfAggregateCollection values: Value - # # Values for requested fields. # # Returns an array of strings. Each string refers to the corresponding fields item. Numeric value is returned as a decimal string representations.



50
51
52
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 50

def aggregate_collection(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#batch_query(payload, &block) ⇒ Object

INPUT: ParamsOfBatchQuery operations: Array - # # List of query operations that must be performed per single fetch. RESPONSE: ResultOfBatchQuery results: Array - # # Result values for batched queries. # # Returns an array of values. Each value corresponds to queries item.



27
28
29
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 27

def batch_query(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#create_block_iterator(payload, &block) ⇒ Object

INPUT: ParamsOfCreateBlockIterator start_time: Number<Optional> - # # Starting time to iterate from. # # If the application specifies this parameter then the iterationincludes blocks with gen_utime >= start_time. Otherwise the iteration starts from zero state. Must be specified in seconds. end_time: Number<Optional> - # # Optional end time to iterate for. # # If the application specifies this parameter then the iterationincludes blocks with gen_utime < end_time. Otherwise the iteration never stops. Must be specified in seconds. shard_filter: Array<Optional> - # # Shard prefix filter. # # If the application specifies this parameter and it is not the empty arraythen the iteration will include items related to accounts that belongs tothe specified shard prefixes. Shard prefix must be represented as a string “workchain:prefix”. Where workchain is a signed integer and the prefix if a hexadecimalrepresentation if the 64-bit unsigned integer with tagged shard prefix. For example: “0:3800000000000000”. result: String<Optional> - # # Projection (result) string. # # List of the fields that must be returned for iterated items. This field is the same as the result parameter ofthe query_collection function. Note that iterated items can contains additional fields that arenot requested in the result. RESPONSE: RegisteredIterator handle: Number - # # Iterator handle. # # Must be removed using ‘remove_iterator`when it is no more needed for the application.



164
165
166
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 164

def create_block_iterator(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#create_transaction_iterator(payload, &block) ⇒ Object

INPUT: ParamsOfCreateTransactionIterator start_time: Number<Optional> - # # Starting time to iterate from. # # If the application specifies this parameter then the iterationincludes blocks with gen_utime >= start_time. Otherwise the iteration starts from zero state. Must be specified in seconds. end_time: Number<Optional> - # # Optional end time to iterate for. # # If the application specifies this parameter then the iterationincludes blocks with gen_utime < end_time. Otherwise the iteration never stops. Must be specified in seconds. shard_filter: Array<Optional> - # # Shard prefix filters. # # If the application specifies this parameter and it is not an empty arraythen the iteration will include items related to accounts that belongs tothe specified shard prefixes. Shard prefix must be represented as a string “workchain:prefix”. Where workchain is a signed integer and the prefix if a hexadecimalrepresentation if the 64-bit unsigned integer with tagged shard prefix. For example: “0:3800000000000000”. Account address conforms to the shard filter ifit belongs to the filter workchain and the first bits of address match tothe shard prefix. Only transactions with suitable account addresses are iterated. accounts_filter: Array<Optional> - # # Account address filter. # # Application can specify the list of accounts for whichit wants to iterate transactions. If this parameter is missing or an empty list then the library iteratestransactions for all accounts that pass the shard filter. Note that the library doesn’t detect conflicts between the account filter and the shard filterif both are specified. So it is an application responsibility to specify the correct filter combination. result: String<Optional> - # # Projection (result) string. # # List of the fields that must be returned for iterated items. This field is the same as the result parameter ofthe query_collection function. Note that iterated items can contain additional fields that arenot requested in the result. include_transfers: Boolean<Optional> - # # Include transfers field in iterated transactions. # # If this parameter is true then each transaction contains field`transfers` with list of transfer. See more about this structure in function description. RESPONSE: RegisteredIterator handle: Number - # # Iterator handle. # # Must be removed using ‘remove_iterator`when it is no more needed for the application.



198
199
200
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 198

def create_transaction_iterator(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#fetch_endpoints(&block) ⇒ Object

RESPONSE: EndpointsSet endpoints: Array - # # List of endpoints provided by server



108
109
110
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 108

def fetch_endpoints(&block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: {}, &block)
end

#find_last_shard_block(payload, &block) ⇒ Object

INPUT: ParamsOfFindLastShardBlock address: String - # # Account address RESPONSE: ResultOfFindLastShardBlock block_id: String - # # Account shard last block ID



102
103
104
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 102

def find_last_shard_block(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#get_endpoints(&block) ⇒ Object

RESPONSE: ResultOfGetEndpoints query: String - # # Current query endpoint endpoints: Array - # # List of all endpoints used by client



121
122
123
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 121

def get_endpoints(&block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: {}, &block)
end

#iterator_next(payload, &block) ⇒ Object

INPUT: ParamsOfIteratorNext iterator: Number - # # Iterator handle limit: Number<Optional> - # # Maximum count of the returned items. # # If value is missing or is less than 1 the library uses 1. return_resume_state: Boolean<Optional> - # # Indicates that function must return the iterator state that can be used for resuming iteration. RESPONSE: ResultOfIteratorNext items: Array - # # Next available items. # # Note that iterator_next can return an empty items and has_more equals to true. In this case the application have to continue iteration. Such situation can take place when there is no data yet butthe requested end_time is not reached. has_more: Boolean - # # Indicates that there are more available items in iterated range. resume_state: Value<Optional> - # # Optional iterator state that can be used for resuming iteration. # # This field is returned only if the return_resume_state parameteris specified. Note that resume_state corresponds to the iteration positionafter the returned items.



225
226
227
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 225

def iterator_next(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#query(payload, &block) ⇒ Object

INPUT: ParamsOfQuery query: String - # # GraphQL query text. variables: Value - # # Variables used in query. # # Must be a map with named values that can be used in query. RESPONSE: ResultOfQuery result: Value - # # Result provided by DAppServer.



19
20
21
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 19

def query(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#query_collection(payload, &block) ⇒ Object

INPUT: ParamsOfQueryCollection collection: String - # # Collection name (accounts, blocks, transactions, messages, block_signatures) filter: Value - # # Collection filter result: String - # # Projection (result) string order: Array<Optional> - # # Sorting order limit: Number<Optional> - # # Number of documents to return RESPONSE: ResultOfQueryCollection result: Array - # # Objects that match the provided criteria



39
40
41
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 39

def query_collection(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#query_counterparties(payload, &block) ⇒ Object

INPUT: ParamsOfQueryCounterparties account: String - # # Account address result: String - # # Projection (result) string first: Number<Optional> - # # Number of counterparties to return after: String<Optional> - # # cursor field of the last received result RESPONSE: ResultOfQueryCollection result: Array - # # Objects that match the provided criteria



132
133
134
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 132

def query_counterparties(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#query_transaction_tree(payload, &block) ⇒ Object

INPUT: ParamsOfQueryTransactionTree in_msg: String - # # Input message id. abi_registry: Array<Optional> - # # List of contract ABIs that will be used to decode message bodies. Library will try to decode each returned message body using any ABI from the registry. timeout: Number<Optional> - # # Timeout used to limit waiting time for the missing messages and transaction. # # If some of the following messages and transactions are missing yetThe maximum waiting time is regulated by this option. Default value is 60000 (1 min). RESPONSE: ResultOfQueryTransactionTree messages: Array - # # Messages. transactions: Array - # # Transactions.



144
145
146
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 144

def query_transaction_tree(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#remove_iterator(payload, &block) ⇒ Object

INPUT: RegisteredIterator handle: Number - # # Iterator handle. # # Must be removed using ‘remove_iterator`when it is no more needed for the application.



231
232
233
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 231

def remove_iterator(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#resume(&block) ⇒ Object 



94
95
96
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 94

def resume(&block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: {}, &block)
end

#resume_block_iterator(payload, &block) ⇒ Object

INPUT: ParamsOfResumeBlockIterator resume_state: Value - # # Iterator state from which to resume. # # Same as value returned from iterator_next. RESPONSE: RegisteredIterator handle: Number - # # Iterator handle. # # Must be removed using ‘remove_iterator`when it is no more needed for the application.



172
173
174
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 172

def resume_block_iterator(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#resume_transaction_iterator(payload, &block) ⇒ Object

INPUT: ParamsOfResumeTransactionIterator resume_state: Value - # # Iterator state from which to resume. # # Same as value returned from iterator_next. accounts_filter: Array<Optional> - # # Account address filter. # # Application can specify the list of accounts for whichit wants to iterate transactions. If this parameter is missing or an empty list then the library iteratestransactions for all accounts that passes the shard filter. Note that the library doesn’t detect conflicts between the account filter and the shard filterif both are specified. So it is the application’s responsibility to specify the correct filter combination. RESPONSE: RegisteredIterator handle: Number - # # Iterator handle. # # Must be removed using ‘remove_iterator`when it is no more needed for the application.



210
211
212
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 210

def resume_transaction_iterator(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#set_endpoints(payload, &block) ⇒ Object

INPUT: EndpointsSet endpoints: Array - # # List of endpoints provided by server



114
115
116
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 114

def set_endpoints(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#subscribe(payload, &block) ⇒ Object

INPUT: ParamsOfSubscribe subscription: String - # # GraphQL subscription text. variables: Value - # # Variables used in subscription. # # Must be a map with named values that can be used in query. RESPONSE: ResultOfSubscribeCollection handle: Number - # # Subscription handle. # # Must be closed with unsubscribe



86
87
88
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 86

def subscribe(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#subscribe_collection(payload, &block) ⇒ Object

INPUT: ParamsOfSubscribeCollection collection: String - # # Collection name (accounts, blocks, transactions, messages, block_signatures) filter: Value - # # Collection filter result: String - # # Projection (result) string RESPONSE: ResultOfSubscribeCollection handle: Number - # # Subscription handle. # # Must be closed with unsubscribe



77
78
79
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 77

def subscribe_collection(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#suspend(&block) ⇒ Object 



90
91
92
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 90

def suspend(&block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: {}, &block)
end

#unsubscribe(payload, &block) ⇒ Object

INPUT: ResultOfSubscribeCollection handle: Number - # # Subscription handle. # # Must be closed with unsubscribe



67
68
69
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 67

def unsubscribe(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end

#wait_for_collection(payload, &block) ⇒ Object

INPUT: ParamsOfWaitForCollection collection: String - # # Collection name (accounts, blocks, transactions, messages, block_signatures) filter: Value - # # Collection filter result: String - # # Projection (result) string timeout: Number<Optional> - # # Query timeout RESPONSE: ResultOfWaitForCollection result: Value - # # First found object that matches the provided criteria



61
62
63
 
# File 'lib/everscale-client-ruby/Client/Net.rb', line 61

def wait_for_collection(payload, &block)
  core.requestLibrary(context: context.id, method_name: full_method_name(MODULE, __method__.to_s), payload: payload, &block)
end