Documentation

You can access the full docs at docs.gaming.chainsafe.io.

Our codebase is quite easy to use. To immediately start with reading from the blockchain, once you've installed our core package, you can simply add a new Web3 client to your scene and do the following:

async void Awake()
{
    // Initialize the Web3 Client
    await Web3Unity.Instance.Initialize(false);
    
    // Read the balance of a custom token for the specified account address
    var balance = await Web3Unity.Web3.Erc20.GetBalanceOf(contractAddress, accountAddress);   
}

Additional sample scripts can be found at docs.gaming.chainsafe.io/current/sample-scripts.

Support

• Need help with web3.unity or found a bug? Be sure to read the documentation above, then review existing issues or create a new one here. This is the best way to get help from the ChainSafe Gaming team.
• Need help from the community, including questions not related to web3.unity? Ask in #community-code-support on Discord.

Contributing

• Have an idea for a new feature that would improve web3.unity? Create a feature request here.
• Have a code contribution you'd like to make directly? Make a pull request to this repo!
• Join our community! Say hi on Discord in #web3unity-gaming-general and share your project built with web3.unity in #gaming-showcase.

Building the code

• Clone the repository and run the setup script.
• You can now open src/UnitySampleProject in Unity and start hacking!
• Whenever you make changes to the code in the libraries, run the src/ChainSafe.Gaming.Unity/publish-to-unity-package script from within the folder it is in. This will build and publish the libraries to the UPM package's folder, thus making any new code accessible inside Unity.

ChainSafe Security Policy

Reporting a Security Bug

We take all security issues seriously, if you believe you have found a security issue within a ChainSafe project please notify us immediately. If an issue is confirmed, we will take all necessary precautions to ensure a statement and patch release is made in a timely manner.

Please email us a description of the flaw and any related information (e.g. reproduction steps, version) to security at chainsafe dot io.