⚠️ This is an alpha release; functionality may change.

This is a Laravel PHP package that allows you to interact with the Flow blockchain by using the Flow CLI.

In the future we'll make a full integration with the GRPC interface, but for now it's just a wrapper around the Flow CLI.

At the moment, the SDK includes the following features:

• Wrapper around Flow CLI for basic scripts, transactions, events and block calls.
• Communication with the Flow Access API over gRPC (coming soon)
• Transaction preparation and signing (coming soon)
• Events parsing (coming soon)

To add this SDK to your project using Composer, use the following:

composer require mayvenstudios/flow-php-sdk

After this, you should add the following variables in your .env file. This example shows the default Flow CLI path for macOS if you're using Homebrew, but on a Linux server it will likely be ~/.local/bin

FLOW_PATH=/opt/homebrew/bin/
FLOW_NETWORK=testnet

It's very important that you put all your flow.json config file and the contracts, scripts and transactions in a folder called cadence in the root directory of your project. This folder will be used as the base path to run the flow command, so that it will be able to read all the necessary Flow configurations.

If you're using Laravel you can also run this command to publish the config files if you need.

php artisan vendor:publish

This is only needed if you want to help develop the full GRPC version.

$ [sudo] pecl install grpc

Once you have added the package via Composer and setup the environment variables, you can use the Flow Facade in the following ways.

Please remember to import the class at the beginning of your PHP with use Flow;

All the output will be returned as PHP Object parsed from the JSON returned by the Flow CLI.

Flow::getLatestBlock();

Flow::getBlock(123456);

Flow::event('event_name_with_address_goes_here')->minBlock(1)->maxBlock(100)->run();

Flow::script('path_to_cadence_script_file')->run();

Flow::transaction('path_to_cadence_transaction_file')->run();

You can easily pass arguments to the script and transactions by using the following methods

Flow::transaction('path_to_cadence_transaction_file')->argInt(100)->run();

Flow::transaction('path_to_cadence_transaction_file')->argFix(9.99)->run();

Flow::transaction('path_to_cadence_transaction_file')->argString('something')->run();

Flow::transaction('path_to_cadence_transaction_file')->argAddress('0x711eba2a0d39d21a')->run();

Flow::transaction('path_to_cadence_transaction_file')->argBool(true)->run();

Flow::transaction('path_to_cadence_transaction_file')->argDictionaryString(['key' => 'value'])->run();

Project is in the very early phase, all contributions are welcomed.

Read the contributing guide to get started.

Protobuf-PHP Illuminate-Support

Apache License 2.0