Reference for integrating Rivellum into Godot 4.x projects.

Implementation in This Repository

• SDK path: sdk/godot/
• Plugin path: sdk/godot/addons/rivellum/
• Optional C# bridge: sdk/godot/addons/rivellum/csharp/

Runtime Model

Godot Client -> Rivellum Godot SDK -> Rivellum Node RPC

Baseline Setup

1. Copy sdk/godot/addons/rivellum/ into your project's addons/ directory.
2. Enable the plugin in Project Settings.
3. Configure node URL in RivellumClientConfig.

Core API Shape

Typical integration operations:

• get_balance
• simulate_intent
• send_intent
• event subscription flows

For signing in development, local dev signer flows exist. For production wallets, use external wallet custody patterns.

Example Profile

• Wallet UI and balance polling
• Intent simulation before submit
• Game rewards issuance and claim flows
• Live event-driven updates

Security Notes

• Do not ship local dev key storage in production builds.
• Keep signing isolated from game process where possible.
• Use TLS termination in front of node RPC endpoints.

Related References

• /docs/dev/sdk-surface
• /docs/dev/unity-integration
• /docs/dev/mobile-integration
• /docs/dev/sdk-guide