Pactus gRPC Client Library

A Dart gRPC client library for seamless interaction with the Pactus Blockchain.
This package provides generated gRPC code to access Pactus blockchain services efficiently.

Features

Comprehensive gRPC Support: Full access to all Pactus blockchain services.
Type-Safe Interactions: Uses generated Protobuf classes for robust, type-safe API usage.
Multi-Service Integration: Supports Blockchain, Network, Transaction, Wallet, and Utility services.
Cross-Platform Compatibility: Works with both Dart and Flutter applications.

Installation

Add the dependency to your pubspec.yaml:

dependencies:
  flutter_pactus_grpc: ^0.1.2

Then fetch the package:

dart pub get

Quick Start

Example usage of flutter_pactus_grpc:

import 'package:flutter_pactus_grpc/flutter_pactus_grpc.dart';

void main() {
  // Initialize blockchain service
  final blockchainService = BlockchainService();

  // Create a transaction instance
  final transaction = Transaction();

  // Initialize wallet service
  final walletService = WalletService();
}

Services Overview

Blockchain Service

Retrieve blockchain metadata and status.
Access block data and transaction history.
Query network statistics.

Network Service

Monitor network topology and peer connections.
Retrieve connection status and performance metrics.

Transaction Service

Create and broadcast transactions.
Validate and query transaction details.

Wallet Service

Manage accounts and perform balance queries.
Execute transfers and other wallet operations.

Utility Service

Access common utilities and helper functions.
Perform cryptographic operations.

Example Usage

Connecting to a Pactus node and retrieving blockchain information:

import 'package:flutter_pactus_grpc/flutter_pactus_grpc.dart';
import 'package:grpc/grpc.dart';

Future<void> connectToPactus() async {
  // Establish a gRPC channel
  final channel = ClientChannel(
    'localhost',
    port: 50051,
    options: const ChannelOptions(
      credentials: ChannelCredentials.insecure(),
    ),
  );

  // Initialize the blockchain service client
  final client = BlockchainServiceClient(channel);

  try {
    // Fetch blockchain information
    final response = await client.getBlockchainInfo(BlockchainRequest());
    print('Blockchain Height: ${response.height}');
  } catch (e) {
    print('Error: $e');
  } finally {
    // Clean up and close the channel
    await channel.shutdown();
  }
}

void main() {
  connectToPactus();
}

API Documentation

For full API reference, visit the
👉 Pactus Blockchain Documentation

Requirements

Dart SDK: >= 3.0.0
Pactus Node: Must be running with gRPC enabled