Integration Guides

Using @maroo-chain/contracts in Your Project

Install the @maroo-chain/contracts npm package, import the Solidity precompile interfaces, and consume the pre-generated TypeScript ABIs from ethers or viem.

Understanding Maroo Address Formats

Maroo accounts have two equivalent string representations — EVM hex (0x…) and Bech32 (maroo1…). When each one matters, and how to convert between them in JS/TS.

How to Handle OKRW Precompile Errors

Learn how to effectively handle custom errors from the OKRW precompile in both Solidity smart contracts and client-side applications using Ethers.js.

Querying EAS Data

How to read attestations from Maroo's EAS — via Solidity contract calls (the canonical surface), via the EAS Indexer for reverse lookups, and via the JS/TS SDKs.

How to Simulate Compliance Checks with runOnPcl

A focused guide on using the PCL's runOnPcl function to perform pre-flight transaction checks, improving dApp user experience and preventing wasted gas.

Building a Compliant ERC20 Token with PCL — End-to-End

An end-to-end walk-through: issue a KYC attestation via EAS, deploy a stock ERC20, attach a PCL ContractPolicyConfig that requires the attestation, then verify rejections.

Verifying Identity with EAS on Maroo

A complete walkthrough of registering a schema, issuing an attestation, and verifying it via standard EVM JSON-RPC.