Blockmaker Unity SDK

Add Algorand wallet auth and transaction signing to your Unity game. Open-source, free, built for Unity 6+.

Supported Wallets

Wallet	How it works
Pera	QR code scan (WalletConnect v1)
Defly	QR code scan (WalletConnect v2)
X-Chain	Any EVM wallet (MetaMask, Rainbow, Coinbase + more) via xChain Accounts
Email	Magic SDK (WebGL) or server-managed OTP (all platforms)

Installation

One-click install

1. Download BlockmakerInstaller.cs (right-click → Save As)
2. Drag it into your Unity project (anywhere in the Assets folder)
3. A dialog will appear — click Install
4. Unity installs everything automatically. Done.

You can delete the installer file after installation.

Manual install (if you prefer)

Open Packages/manifest.json in your project folder and add:

In "dependencies":

"com.blockmaker.sdk": "https://github.com/blockmaker-ai/blockmaker-unity.git",
"com.nethereum.unity": "4.19.2",
"com.reown.sign.nethereum": "1.6.0",
"com.reown.sign.unity": "1.6.0",

At the bottom of the file, before the last }:

,
"scopedRegistries": [
  {
    "name": "OpenUPM",
    "url": "https://package.openupm.com",
    "scopes": ["com.reown", "com.nethereum", "com.cysharp"]
  }
]

Save and reopen Unity.

Setup

Go to Blockmaker > Setup Scene in the menu bar. This automatically:

• Creates a BlockmakerConfig asset
• Adds BlockmakerAuth with the config wired up
• Adds the auth UI with all UXML assets pre-assigned
• Creates PanelSettings and EventSystem if needed

Hit Play — the wallet system is ready. No API keys or signups needed.

Usage

Connect a wallet

using Blockmaker;

// Pera (QR code)
BlockmakerAuth.Instance.ConnectWallet("Pera",
    identity => Debug.Log($"Connected: {identity.Address}"),
    error    => Debug.Log(error)
);

// Defly (QR code)
BlockmakerAuth.Instance.ConnectWallet("Defly",
    identity => Debug.Log($"Connected: {identity.Address}"),
    error    => Debug.Log(error)
);

// X-Chain — any EVM wallet (MetaMask, Rainbow, Coinbase + more)
BlockmakerAuth.Instance.ConnectEvm(
    identity => Debug.Log($"Connected: {identity.Address}"),
    error    => Debug.Log(error)
);

// Email login
BlockmakerAuth.Instance.ConnectMagicEmail("player@example.com",
    identity => Debug.Log($"Signed in: {identity.Address}"),
    error    => Debug.Log(error)
);

Async/await

var identity = await BlockmakerAuth.Instance.ConnectWalletAsync("Pera");
var evmIdentity = await BlockmakerAuth.Instance.ConnectEvmAsync();

Sign transactions

var identity = BlockmakerAuth.Instance.Identity;

// Single transaction
yield return identity.SignTransaction(unsignedTxnBase64,
    signed => Debug.Log("Signed!"),
    error  => Debug.Log(error)
);

// Atomic group
yield return identity.SignTransactions(unsignedTxnsBase64,
    signed => Debug.Log($"Signed {signed.Length} transactions"),
    error  => Debug.Log(error)
);

Check state

BlockmakerAuth.Instance.HasWallet    // true if a wallet is connected
BlockmakerAuth.Instance.Address      // Algorand address
BlockmakerAuth.Instance.CanSign      // true if the wallet can sign right now
BlockmakerAuth.Instance.IsLoggedIn   // true for Email or SelfCustody tier
BlockmakerAuth.Instance.Tier         // Guest, Email, or SelfCustody

Listen for changes

void OnEnable()
{
    BlockmakerAuth.OnIdentityChanged += HandleIdentityChanged;
}

void OnDisable()
{
    BlockmakerAuth.OnIdentityChanged -= HandleIdentityChanged;
}

void HandleIdentityChanged(IBlockmakerIdentity identity)
{
    Debug.Log($"Identity changed: {identity.ProviderName} — {identity.Address}");
}

Logout

BlockmakerAuth.Instance.Logout();

Pre-built UI

The SDK includes ready-to-use UI screens built with UI Toolkit:

• Auth screen — wallet selection, QR display, email OTP flow
• Wallet bar — shows connected address, tier badge
• QR modal — Pera/Defly/X-Chain connection with copy-link fallback
• Wallet upgrade prompt — nudges guests to connect

All UI is optional — you can build your own using the BlockmakerAuth API directly.

Logging

SDK logs are silent in release builds by default. To adjust:

// Show all SDK logs (useful for debugging)
BlockmakerLog.Level = BlockmakerLogLevel.Verbose;

// Intercept logs for your own system
BlockmakerLog.OnLog += (level, msg) => MyLogger.Log(msg);

Configuration Reference

All fields are optional — the SDK works with defaults out of the box.

Field	Description
serverUrl	Your own Blockmaker server URL. Leave empty to use the shared default
apiKey	Your own API key (sk_ prefix). Only used in the Unity Editor, never shipped in player builds
walletConnectProjectId	Your own WalletConnect project ID. Leave empty to use the shared default
magicPublishableKey	Magic SDK key for email login on WebGL
dAppUrl	URL shown in wallet apps when players approve a connection
dAppIconUrl	Icon shown in wallet apps
walletSignTimeoutSeconds	How long to wait for wallet approval (default: 120 seconds)

Requirements

• Unity 6+ (6000.0)
• .NET Standard 2.1+

License

MIT — see LICENSE.

Links

• Report an issue
• Built on Algorand