github.com/aquanetwork/aquachain@v1.7.8/rpc/client_example_test.go (about)

     1  // Copyright 2016 The aquachain Authors
     2  // This file is part of the aquachain library.
     3  //
     4  // The aquachain library is free software: you can redistribute it and/or modify
     5  // it under the terms of the GNU Lesser General Public License as published by
     6  // the Free Software Foundation, either version 3 of the License, or
     7  // (at your option) any later version.
     8  //
     9  // The aquachain library is distributed in the hope that it will be useful,
    10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    12  // GNU Lesser General Public License for more details.
    13  //
    14  // You should have received a copy of the GNU Lesser General Public License
    15  // along with the aquachain library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  package rpc_test
    18  
    19  import (
    20  	"context"
    21  	"fmt"
    22  	"math/big"
    23  	"time"
    24  
    25  	"gitlab.com/aquachain/aquachain/rpc"
    26  )
    27  
    28  // In this example, our client whishes to track the latest 'block number'
    29  // known to the server. The server supports two methods:
    30  //
    31  // aqua_getBlockByNumber("latest", {})
    32  //    returns the latest block object.
    33  //
    34  // aqua_subscribe("newBlocks")
    35  //    creates a subscription which fires block objects when new blocks arrive.
    36  
    37  type Block struct {
    38  	Number *big.Int
    39  }
    40  
    41  func ExampleClientSubscription() {
    42  	// Connect the client.
    43  	client, _ := rpc.Dial("ws://127.0.0.1:8485")
    44  	subch := make(chan Block)
    45  
    46  	// Ensure that subch receives the latest block.
    47  	go func() {
    48  		for i := 0; ; i++ {
    49  			if i > 0 {
    50  				time.Sleep(2 * time.Second)
    51  			}
    52  			subscribeBlocks(client, subch)
    53  		}
    54  	}()
    55  
    56  	// Print events from the subscription as they arrive.
    57  	for block := range subch {
    58  		fmt.Println("latest block:", block.Number)
    59  	}
    60  }
    61  
    62  // subscribeBlocks runs in its own goroutine and maintains
    63  // a subscription for new blocks.
    64  func subscribeBlocks(client *rpc.Client, subch chan Block) {
    65  	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    66  	defer cancel()
    67  
    68  	// Subscribe to new blocks.
    69  	sub, err := client.AquaSubscribe(ctx, subch, "newBlocks")
    70  	if err != nil {
    71  		fmt.Println("subscribe error:", err)
    72  		return
    73  	}
    74  
    75  	// The connection is established now.
    76  	// Update the channel with the current block.
    77  	var lastBlock Block
    78  	if err := client.CallContext(ctx, &lastBlock, "aqua_getBlockByNumber", "latest"); err != nil {
    79  		fmt.Println("can't get latest block:", err)
    80  		return
    81  	}
    82  	subch <- lastBlock
    83  
    84  	// The subscription will deliver events to the channel. Wait for the
    85  	// subscription to end for any reason, then loop around to re-establish
    86  	// the connection.
    87  	fmt.Println("connection lost: ", <-sub.Err())
    88  }