A collection of helpful utilities for building contracts on Abstract

Installation

To install with Foundry:

forge install abstract-foundation/absmate

Ensure you include the following in your foundry.toml as some libraries may require system contract calls.

[profile.default.zksync]
enable_eravm_extensions = true

Contracts

The Solidity smart contracts are located in the src directory.

utils
├─ LibAGW - "Utilities for AGW smart accounts"
├─ LibClone — "Clones for ZKsync"
├─ LibEVM — "Detection of EVM bytecode contracts"
└─ vrng
   ├─ DataTypes - "Data structures for vRNG operations"
   ├─ Errors - "Custom error definitions for vRNG consumers"
   ├─ VRNGConsumer - "Basic random number consumer contract"
   └─ VRNGConsumerAdvanced - "Advanced random number consumer with custom normalization"

Note

Using vrng contracts requires a subscription to Proof of Play vRNG. Make sure you have an active subscription before implementing vRNG functionality.

Contributing

This repository is designed as a playground for helpful snippets when developing smart contracts for Abstract

Feel free to make a pull request.

Safety

This is experimental software and is provided on an "as is" and "as available" basis.

We do not give any warranties and will not be liable for any loss incurred through any use of this codebase.

Please always include your own thorough tests when using absmate to make sure it works correctly with your code.