Managing Handle Access

Welcome to the guide on managing handle access with Nox. This section will help you get started with controlling access to encrypted data.

Overview

Handles are the on-chain representation of encrypted data. Managing access to handles is crucial for ensuring that only authorized parties can decrypt and use the data. With Nox, you can easily manage handle access through direct interactions with the Nox protocol contract.

Addresses can have different roles written in the handle ACL contract, which determine their permissions:

role \ permissions	decrypt	use as input	add viewer	allow admin	make public
none	❌	❌	❌	❌	❌
viewer	✅	❌	❌	❌	❌
admin	✅	✅	✅	✅	✅
transient	✅	✅	❌	❌	❌

INFO

Transient access expires automatically at the end of the transaction — no revoke needed. See Transient Access.

What You'll Learn

• Manage transient access
  • Understand the default transient behavior of new handles
  • Persist contract access with allowThis
  • Pass handles between contracts with allowTransient
• Manage viewers
  • Check if an address is a viewer for a handle
  • Add viewers to a handle
• Manage admins
  • Check if an address is an admin for a handle
  • Add admins to a handle
• Manage public decryption
  • Check if a handle is publicly decryptable
  • Enable public decryption for a handle

Next Steps

• Transient Access - Learn about the default transient behavior and how to persist handle access
• Manage viewers - Learn how to manage viewers for a handle
• Manage admins - Learn how to manage admins for a handle
• Manage public decryption - Learn how to manage public decryption for a handle