Download the PHP package mayvenstudios/flow-php-sdk without Composer
On this page you can find all versions of the php package mayvenstudios/flow-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mayvenstudios/flow-php-sdk
More information about mayvenstudios/flow-php-sdk
Files in mayvenstudios/flow-php-sdk
Package flow-php-sdk
Short Description PHP SDK for the Flow blockchain
License Apache-2.0
Informations about the package flow-php-sdk
Flow PHP SDK
:warning: 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:
- [x] 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)
Installation
Composer
To add this SDK to your project using Composer, use the following:
Environment variables
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
Cadence folder
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.
Config file (optional)
If you're using Laravel you can also run this command to publish the config files if you need.
Install the grpc extension (optional)
This is only needed if you want to help develop the full GRPC version.
Example Usage
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.
Get the latest Block
Get the latest Block by ID
Get Events within a range of Blocks (250 max)
Run a script
Execute a transaction
Arguments
You can easily pass arguments to the script and transactions by using the following methods
Integer (UInt64)
Fix (UFix64)
String
Address
Bool
DictionaryString (Dictionary of {String:String})
Contribution
Project is in the very early phase, all contributions are welcomed.
Read the contributing guide to get started.
Dependencies
Protobuf-PHP Illuminate-Support