Dojang

Trusted offchain facts, verifiably issued onchain.

Dojang is a service that issues offchain information (outside the blockchain) as onchain attestations on the GIWA chain. It plays an important role in linking onchain wallet addresses with offchain information. This allows users to hold an onchain identity without revealing Personally Identifiable Information (PII) from their wallet.

Dojang aims to establish the trust layer of the GIWA ecosystem by leveraging Ethereum Attestation Service (EAS).

Contracts

GIWA Testnet (Sepolia)

• Schemas

Schema Name	Description	Schema Content	Schema ID	Schema UID
Verified Address	Wallet address which is verified by a trusted issuer	bool isVerified	0x568eb581cdf80b03d3bdfa414f3203bfdcc4bba4e66355612bd0e879da812f06	0x072d75e18b2be4f89a13a7147240477481c4b526d5795802acba59046b426e08
Balance Root	Root of a Merkle tree of balances	uint256 coinType,uint64 snapshotAt,uint192 leafCount,uint256 totalAmount,bytes32 root	0xf09c1384d860519bb4ea5bb2a45ab64b00a8d900d47fb79203663be6da21e06c	0x369faa9c2cd261c45be3db5e230b585f5f1abecf8e12be575bb543e917e6db52
Verified Balance	User's balance verified by a trusted issuer	uint256 balance,bytes32 salt,bytes32[] proofs	0x06c3bd846f5ea60b0b6f5a835ef85fd8253b53f67917d6c690be628d032f841b	0x77bf88ca262cc63e1b185dccd870aacc5320b8987ef6c7169920f265fe6ab5e9
Verified Code	Authentication code verified by a trusted issuer	bytes32 codeHash,string domain	0x68053e055c01ce9b3577f3162b36324bb195ebcb574c48e823480d205f06af9b	0x55ac1369dac97522d062b89ffdc4e752b48fbeba86915fdb956c7c2d0501d280

• Contracts

Name	Description	Address	Version
SchemaRegistry	Handles schema registration and lookup	0x4200000000000000000000000000000000000020	v1.3.1-beta.2
EAS	Issues, revokes, and fetches attestations	0x4200000000000000000000000000000000000021	1.4.1-beta.3
SchemaBook	Manages the list of registered schemas	0x78cBb3413FBb6aF05EF1D21e646440e56baE3AD6	v0.2.0
DojangAttesterBook	Manages the list of attesters used in Dojang	0xDA282E89244424E297Ce8e78089B54D043FB28B6	v0.2.0
AttestationIndexer	Indexes all Dojang attestations for query	0x9C9Bf29880448aB39795a11b669e22A0f1d790ec	v0.2.0
AddressDojangResolver	Triggered on issuance or revocation of a Verified Address attestation	0x692009FE206C3F897867F6BF7B5B45506B747F9e	v0.2.0
BalanceRootDojangResolver	Triggered on issuance or revocation of a Balance Root attestation	0xD90a964aB65bc02397De1E7fcBd230803bC1bEd0	v0.4.0
BalanceDojangResolver	Triggered on issuance or revocation of a Verified Balance attestation	0x6FFa7ABc1E380Bb967C78D5E648EF804e1fE6dAd	v0.4.0
VerifyCodeDojangResolver	Triggered on issuance or revocation of a Verified Code attestation	0x843fF433f7657901118fF3E2Eca915abb9BC12Df	v0.5.0
DojangScroll	Provides convenient read access to Dojang data	0xd5077b67dcb56caC8b270C7788FC3E6ee03F17B9	v0.5.0

Usage

Install

npm install -g pnpm
pnpm install
curl -L https://foundry.paradigm.xyz | bash

Build

pnpm dep        # install dependencies
pnpm build 

CI

• Test

pnpm test

• Check Coverage

pnpm test:coverage
pnpm test:coverage-report

• Lint

pnpm lint
pnpm lint:fix

• Static Analysis

pnpm slither

Deploy

source .env
forge script script/deploy/Deploy.s.sol --rpc-url $RPC_URL --verifier blockscout --verifier-url $EXPLORER_URL --broadcast --slow --verify