github.com/stafiprotocol/go-substrate-rpc-client@v1.4.7/rpc/state/get_child_storage.go (about)

     1  // Go Substrate RPC Client (GSRPC) provides APIs and types around Polkadot and any Substrate-based chain RPC calls
     2  //
     3  // Copyright 2020 Stafi Protocol
     4  //
     5  // Licensed under the Apache License, Version 2.0 (the "License");
     6  // you may not use this file except in compliance with the License.
     7  // You may obtain a copy of the License at
     8  //
     9  //     http://www.apache.org/licenses/LICENSE-2.0
    10  //
    11  // Unless required by applicable law or agreed to in writing, software
    12  // distributed under the License is distributed on an "AS IS" BASIS,
    13  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    14  // See the License for the specific language governing permissions and
    15  // limitations under the License.
    16  
    17  package state
    18  
    19  import (
    20  	"github.com/stafiprotocol/go-substrate-rpc-client/pkg/client"
    21  	"github.com/stafiprotocol/go-substrate-rpc-client/types"
    22  )
    23  
    24  // GetChildStorage retreives the child storage for a key and decodes them into the provided interface. Ok is true if the
    25  // value is not empty.
    26  func (s *State) GetChildStorage(childStorageKey, key types.StorageKey, target interface{}, blockHash types.Hash) (
    27  	ok bool, err error) {
    28  	raw, err := s.getChildStorageRaw(childStorageKey, key, &blockHash)
    29  	if err != nil {
    30  		return false, err
    31  	}
    32  	if len(*raw) == 0 {
    33  		return false, nil
    34  	}
    35  	return true, types.DecodeFromBytes(*raw, target)
    36  }
    37  
    38  // GetChildStorageLatest retreives the child storage for a key for the latest block height and decodes them into the
    39  // provided interface. Ok is true if the value is not empty.
    40  func (s *State) GetChildStorageLatest(childStorageKey, key types.StorageKey, target interface{}) (ok bool, err error) {
    41  	raw, err := s.getChildStorageRaw(childStorageKey, key, nil)
    42  	if err != nil {
    43  		return false, err
    44  	}
    45  	if len(*raw) == 0 {
    46  		return false, nil
    47  	}
    48  	return true, types.DecodeFromBytes(*raw, target)
    49  }
    50  
    51  // GetChildStorageRaw retreives the child storage for a key as raw bytes, without decoding them
    52  func (s *State) GetChildStorageRaw(childStorageKey, key types.StorageKey, blockHash types.Hash) (
    53  	*types.StorageDataRaw, error) {
    54  	return s.getChildStorageRaw(childStorageKey, key, &blockHash)
    55  }
    56  
    57  // GetChildStorageRawLatest retreives the child storage for a key for the latest block height as raw bytes,
    58  // without decoding them
    59  func (s *State) GetChildStorageRawLatest(childStorageKey, key types.StorageKey) (*types.StorageDataRaw, error) {
    60  	return s.getChildStorageRaw(childStorageKey, key, nil)
    61  }
    62  
    63  func (s *State) getChildStorageRaw(childStorageKey, key types.StorageKey, blockHash *types.Hash) (
    64  	*types.StorageDataRaw, error) {
    65  	var res string
    66  	err := client.CallWithBlockHash(s.client, &res, "state_getChildStorage", blockHash, childStorageKey.Hex(),
    67  		key.Hex())
    68  	if err != nil {
    69  		return nil, err
    70  	}
    71  
    72  	bz, err := types.HexDecodeString(res)
    73  	if err != nil {
    74  		return nil, err
    75  	}
    76  
    77  	data := types.NewStorageDataRaw(bz)
    78  	return &data, nil
    79  }