🆕 Nillion SDK Release v0.9.0

[oceans404]

Release TL;DR

Nillion SDK v0.9.0 and Nillion Client releases introduce ECDSA signature support and top-up payments within the Nillion TypeScript Client, enabling users to sign secrets directly on the network and process multiple operations more efficiently through a single balance.
This release also includes improved error reporting, boolean value support, hex string support for UserIds, and a new credits system with balance expiration tracking.

Please note this release contains breaking changes requiring updates to the latest SDK and client versions - refer to our upgrade and migration guide for detailed upgrade instructions.

What’s New

TypeScript Client

• ECDSA Signatures: Sign secrets directly on the Nillion network
• Top-up Payments: Process multiple operations efficiently using a single balance
• Boolean Support: Use boolean values in your network operations
• UserId Helpers: Create UserIds from hex strings
• Better Error Handling: Improved error reporting with clearer root cause identification

SDK Features

• Credits System:
  • View account balance with expiration tracking
  • New helper operations for managing funds (add funds, account balance)
• Permissions bug fix: Compute permissions assignment

Node Updates

• Enhanced Quotes: Price information now displayed in both tokens and credits

How to Upgrade and Migrate

1. Install the latest version of the Nillion SDK from your CLI

nilup install latest
nilup use latest
nillion -V

You should see version nillion v0.9.0 or higher.

2. Upgrade blind apps to use the latest versions of Nillion clients and Nada DSL

Python Client and Nada: nillion-client 0.2.0 and nada-dsl 0.8.0

pip install nillion-client
pip install nada-dsl

Make sure to re-compile and re-upload any Nada programs after installing the latest version of Nada DSL.

Python examples: https://github.com/NillionNetwork/python-examples

TypeScript Client packages: @nillion/client-wasm@^0.3.0 and @nillion/client-vms@^0.3.0

npm i @nillion/client-wasm@^0.3.0 @nillion/client-vms@^0.3.0 

Check out the Node.js Signatures Example with the Nillion TypeScript Client: https://github.com/NillionNetwork/blind-module-examples/tree/main/nilvm/secretsigning-nodejs

React Hooks Package: @nillion/client-react-hooks@^0.3.0

npm i @nillion/client-react-hooks@^0.3.0

Check out the Next.js Examples with React Hooks: https://github.com/NillionNetwork/client-ts/blob/main/examples-nextjs/package.json

3. Update your Nillion Network config to point to the nilVM Testnet (previously Photon1 or Photon2). No changes are needed for nilChain endpoints.

# Bootnode Multi Address
nilVM GRPC Endpoint: https://node-1.nilvm-testnet-1.nillion-network.testnet.nillion.network:14311

Check out the difference between Photon Testnets and nilVM Testnet here: https://docs.nillion.com/network#nilvm-nodes

Sunsetting Photon1 and Photon2

As we build towards Mainnet, we are consolidating our testnet environments. Photon1 and Photon2 testnets will sunset in 2 months on April 11, 2025, with all development moving to our latest nilVM Testnet network (configuration shown above). The Photon1 and Photon2 Testnet networks have served as critical testing grounds since July 2024, enabling hundreds of developers to build blind apps with secure storage, computation, and testnet payments. We encourage all developers to migrate their applications to the latest Testnet environment using SDK v0.9.0 to take advantage of these new features and ensure readiness for Mainnet deployment. If you need help upgrading or migrating, reach out to our dev team on Discord or ask a question here in Github Discussions.

[oceans404]

Check out our new SecretSigner docs to learn how to build with ECDSA signatures: https://docs.nillion.com/build/secretSigner/overview