use ERC20 datatype

.commitlintrc.yaml

@@ -0,0 +1,2 @@
+extends:
+  - "@commitlint/config-conventional"

.czrc

@@ -0,0 +1,3 @@
+{
+  "path": "cz-conventional-changelog"
+}

.env.example

@@ -1,5 +1,4 @@
 MNEMONIC="{INSERT_12_WORD_MNEMONIC}"
-PRIVATE_KEY="{INSERT_0x_PRIVATE_KEY}"
 
 INFURA_API_KEY="{INSERT_API_KEY}"
 ALCHEMY_API_KEY="{INSERT_API_KEY}"

.eslintignore

@@ -0,0 +1,21 @@
+# directories
+.yarn/
+**/.coverage_artifacts
+**/.coverage_cache
+**/.coverage_contracts
+**/artifacts
+**/build
+**/cache
+**/coverage
+**/dist
+**/node_modules
+**/types
+
+# files
+*.env
+*.log
+.pnp.*
+coverage.json
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

.eslintrc.yaml

@@ -0,0 +1,21 @@
+extends:
+  - "eslint:recommended"
+  - "plugin:@typescript-eslint/eslint-recommended"
+  - "plugin:@typescript-eslint/recommended"
+  - "prettier"
+parser: "@typescript-eslint/parser"
+parserOptions:
+  project: "./tsconfig.json"
+plugins:
+  - "@typescript-eslint"
+root: true
+rules:
+  "@typescript-eslint/no-floating-promises":
+    - error
+    - ignoreIIFE: true
+      ignoreVoid: true
+  "@typescript-eslint/no-inferrable-types": "off"
+  "@typescript-eslint/no-unused-vars":
+    - error
+    - argsIgnorePattern: "_"
+      varsIgnorePattern: "_"

.github/workflows/lint.yml

@@ -1,32 +0,0 @@
-name: Lint
-
-on:
-  push:
-    branches: [main, dev]
-  pull_request:
-    branches: [main, dev]
-
-concurrency:
-  group: lint-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  lint:
-    name: Solidity + TypeScript + Prettier
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Enable Corepack
-        run: corepack enable
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: yarn
-
-      - name: Install dependencies
-        run: yarn install --immutable
-
-      - name: Run lint
-        run: yarn lint

.github/workflows/test.yml

@@ -1,35 +0,0 @@
-name: Test
-
-on:
-  push:
-    branches: [main, dev]
-  pull_request:
-    branches: [main, dev]
-
-concurrency:
-  group: test-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  test:
-    name: Hardhat tests
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Enable Corepack
-        run: corepack enable
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: yarn
-
-      - name: Install dependencies
-        run: yarn install --immutable
-
-      - name: Compile contracts
-        run: yarn compile
-
-      - name: Run tests
-        run: yarn test

.gitignore

@@ -5,8 +5,7 @@
 !.yarn/plugins
 !.yarn/sdks
 !.yarn/versions
-artifacts
+# **/artifacts
-**/artifacts
 artifacts/build-info
 **/build
 **/ref
@@ -17,8 +16,6 @@ artifacts/build-info
 **/.coverage_contracts
 **/dist
 **/node_modules
-.deps
-src/types
 
 # files
 *.env
@@ -28,11 +25,3 @@ coverage.json
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-docs/lib/mock/*.md
-.dagrobin/
-
-# Hardhat Ignition local/ephemeral deployments
-ignition/deployments/chain-31337/
-
-# Per-developer local deploy state (deterministic per mnemonic)
-deploys/localhost.json

.husky/.gitignore

@@ -0,0 +1 @@
+_

.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+yarn dlx commitlint --edit $1

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+yarn dlx lint-staged

.prettierignore

@@ -11,12 +11,6 @@
 **/node_modules
 **/types
 
-# deploy artifacts
-deploys/old/
-
-# auto-generated docs
-docs/
-
 # files
 *.env
 *.log
@@ -24,4 +18,6 @@ docs/
 coverage.json
 npm-debug.log*
 yarn-debug.log*
-yarn-error.log*
+yarn-error.log*
+
+contracts/p2pix.sol

.prettierrc.yaml

@@ -1,8 +1,10 @@
-plugins:
-  - prettier-plugin-solidity
 arrowParens: avoid
 bracketSpacing: true
 endOfLine: auto
+importOrder: ["<THIRD_PARTY_MODULES>", "^[./]"]
+importOrderParserPlugins: ["typescript"]
+importOrderSeparation: true
+importOrderSortSpecifiers: true
 printWidth: 62
 singleQuote: false
 tabWidth: 2

.solcover.js

@@ -1,22 +1,7 @@
 module.exports = {
-  configureYulOptimizer: true,
-  solcOptimizerDetails: {
-    deduplicate: true,
-    cse: true,
-    constantOptimizer: true,
-    peephole: true,
-    jumpdestRemover: true,
-    yul: true,
-    // inliner: false,
-    // orderLiterals: true,
-  },
   istanbulReporter: ["html", "lcov"],
   providerOptions: {
     mnemonic: process.env.MNEMONIC,
   },
-  skipFiles: [
+  skipFiles: ["test"],
-    "test",
-    "core/BaseUtils.sol",
-    "core/OwnerSettings.sol",
-  ],
 };

.solhint.json

@@ -3,7 +3,6 @@
   "plugins": ["prettier"],
   "rules": {
     "code-complexity": ["error", 8],
-    "avoid-low-level-calls": "off",
     "compiler-version": ["error", ">=0.8.4"],
     "const-name-snakecase": "off",
     "constructor-syntax": "error",
@@ -11,14 +10,7 @@
       "error",
       { "ignoreConstructors": true }
     ],
-    "function-max-lines": "off",
-    "gas-calldata-parameters": "off",
-    "gas-indexed-events": "off",
-    "gas-strict-inequalities": "off",
-    "gas-struct-packing": "off",
-    "interface-starts-with-i": "off",
     "max-line-length": ["error", 120],
-    "no-inline-assembly": "off",
     "not-rely-on-time": "off",
     "prettier/prettier": [
       "error",
@@ -26,7 +18,6 @@
         "endOfLine": "auto"
       }
     ],
-    "reason-string": ["warn", { "maxLength": 64 }],
+    "reason-string": ["warn", { "maxLength": 64 }]
-    "use-natspec": "off"
   }
 }

.solhintignore

@@ -1,6 +1,3 @@
 # directories
 **/artifacts
-**/cache
 **/node_modules
-deploys/
-docs/

.yarnrc.yml

@@ -1,7 +1,7 @@
-compressionLevel: mixed
-
-enableGlobalCache: false
-
 nodeLinker: node-modules
 
-yarnPath: .yarn/releases/yarn-4.9.2.cjs
+plugins:
+  - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
+    spec: "@yarnpkg/plugin-interactive-tools"
+
+yarnPath: .yarn/releases/yarn-3.2.1.cjs

README.md

@@ -6,7 +6,6 @@
 
 ```rs
 ./contracts/
-├── Constants.sol
 ├── DataTypes.sol
 ├── EventAndErrors.sol
 ├── lib
@@ -19,9 +18,7 @@
 │   ├── tokens
 │   │   └── ERC20.sol
 │   └── utils
-│       ├── ECDSA.sol
 │       ├── MerkleProofLib.sol
-│       ├── Multicall.sol
 │       ├── ReentrancyGuard.sol
 │       └── SafeTransferLib.sol
 ├── p2pix.sol
@@ -55,23 +52,25 @@
 
 | Testnet | Token Address                              | P2pix Address                              | Reputation Address                         | Multicall Address                          |
 | ------- | ------------------------------------------ | ------------------------------------------ | ------------------------------------------ | ------------------------------------------ |
-| Sepolia | 0x3eBE212377D847828eBb9D2a100f5c5EA1EF3A72 | 0xb7cDAE58C6e715Cfd795BB142041E43b9CB02497 | 0xFd1194A56995Ef7B62730F4061408e79d88E5207 | 0x2f7f9848A803E67d79C0C8aa42b663dCF6E1B5ed |
+| Goerli  | 0x4A2886EAEc931e04297ed336Cc55c4eb7C75BA00 | 0x2414817FF64A114d91eCFA16a834d3fCf69103d4 | 0x2CFD9354Ec7614fEf036EFd6A730dA1d5fC2762A | 0x8FE009992d96A86c7f0Bccdaf1eC3471E302a8a6 |
+| Mumbai  | 0xC86042E9F2977C62Da8c9dDF7F9c40fde4796A29 | 0x4A2886EAEc931e04297ed336Cc55c4eb7C75BA00 | 0x570445E3eF413bCDb5De79ed27B1c3840683e385 | 0x718B2C4DE4F9654E1349F610ff561249bfe1c418 |
 
 <!-- All contracts deployed by 0x8dC06F985C131166570825F52447E8c88d64aE20 -->
-<!-- https://sepolia.etherscan.io/address/0x3eBE212377D847828eBb9D2a100f5c5EA1EF3A72#code -->
+<!-- https://goerli.etherscan.io/address/0x4A2886EAEc931e04297ed336Cc55c4eb7C75BA00#code -->
-<!-- https://sepolia.etherscan.io/address/0xb7cDAE58C6e715Cfd795BB142041E43b9CB02497#code -->
+<!-- https://goerli.etherscan.io/address/0x2414817FF64A114d91eCFA16a834d3fCf69103d4#code -->
-<!-- https://sepolia.etherscan.io/address/0xFd1194A56995Ef7B62730F4061408e79d88E5207#code -->
+<!-- https://goerli.etherscan.io/address/0x2CFD9354Ec7614fEf036EFd6A730dA1d5fC2762A#code -->
-<!-- https://sepolia.etherscan.io/address/0x2f7f9848A803E67d79C0C8aa42b663dCF6E1B5ed#code -->
+<!-- https://goerli.etherscan.io/address/0x8FE009992d96A86c7f0Bccdaf1eC3471E302a8a6#code -->
+
+<!-- https://mumbai.polygonscan.com/address/0xC86042E9F2977C62Da8c9dDF7F9c40fde4796A29#code -->
+<!-- https://mumbai.polygonscan.com/address/0x4A2886EAEc931e04297ed336Cc55c4eb7C75BA00#code -->
+<!-- https://mumbai.polygonscan.com/address/0x570445e3ef413bcdb5de79ed27b1c3840683e385#code -->
+<!-- https://mumbai.polygonscan.com/address/0x718B2C4DE4F9654E1349F610ff561249bfe1c418#code -->
 
 ## Usage
 
 ### Pre Requisites
 
-Before installing, create a `.env` file and set the authentication method and other env criteria as in `.env.example`.
+Before installing, create a `.env` file and set a BIP-39 compatible mnemonic and other env criteria as in `.env.example`.
-
-You can authenticate with either:
-- `PRIVATE_KEY` — a raw hex private key (e.g. `0x123...`). Takes priority if both are set.
-- `MNEMONIC` — a BIP-39 compatible 12-word mnemonic phrase. Used as fallback when `PRIVATE_KEY` is not set.
 
 ### Install
 
@@ -123,71 +122,36 @@ To grab deployment addresses you can just grab from deploys folder:
 import localhostDeploys from "p2pix-smart-contracts/deploys/localhost.json";
 ```
 
-## Deployment (Hardhat Ignition)
+## Deploying to local environment
 
-Deployments are orchestrated by
+On the first teminal, use the following command and import some wallets to your Metamask, then connect to the network pointed:
-[Hardhat Ignition](https://hardhat.org/ignition). Each module declares its
-contracts; Ignition handles ordering, idempotency, and per-network state
-under `ignition/deployments/`.
-
-### Modules
-
-- `ignition/modules/MockToken.ts` — ERC20 mock used in dev / testnets.
-- `ignition/modules/Reputation.ts` — Reputation + Multicall.
-- `ignition/modules/P2PIX.ts` — production deploy (no MockToken). Token
-  addresses passed via parameters (`tokens` + `allowed`).
-- `ignition/modules/P2PIXWithMock.ts` — dev/test deploy. Wires Reputation +
-  MockToken and deploys P2PIX.
-
-### Per-network parameters
-
-Network-specific values (e.g. `defaultBlocks`, `validSigners`, MockToken
-`supply`) live in `ignition/parameters/<network>.json`. Only
-`localhost.json` is checked in; copy it to e.g. `sepolia.json` and set the
-network values before running the deploy script.
-
-### Local environment
-
-On the first terminal:
 
 ```sh
 yarn hardhat node
 ```
 
-On the second terminal:
+On the second teminal, run the following commands:
 
 ```sh
-yarn deploy:mock --network localhost --parameters ignition/parameters/localhost.json
+yarn deploy1:localhost
+yarn deploy2:localhost
 ```
 
-Addresses for every deployed contract are written to
+**_NOTE_:** The second script transfers 2M tokens to the first wallet of the node.
-`ignition/deployments/chain-31337/deployed_addresses.json` (this path is
+To use the P2Pix smart contract first transfer some of the tokens to other wallets.
-gitignored — local-only state).
 
-### Testnets
+## Deploying to testnets
+
+Deploy to Ethereum's Goerli testnet:
 
 ```sh
-yarn deploy:mock --network sepolia
+yarn deploy1:goerli
+yarn deploy2:goerli
 ```
 
-Requires the matching `ignition/parameters/sepolia.json` and the relevant
+Deploy to Polygon's Mumbai testnet:
-API keys in `.env`.
 
-### Production (real tokens)
+```sh
-
+yarn deploy1:mumbai
-Use the `P2PIX` module when the target network already has the ERC20
+yarn deploy2:mumbai
-tokens you want P2PIX to support — no MockToken is deployed.
+```
-
-1. Copy `ignition/parameters/prod.example.json` to
-   `ignition/parameters/<network>.json` and set:
-   - `defaultBlocks`, `validSigners`
-   - `tokens` — array of ERC20 addresses on the target network
-   - `allowed` — array of booleans, same length as `tokens`
-2. Run:
-
-   ```sh
-   yarn deploy --network <network> --parameters ignition/parameters/<network>.json
-   ```
-
-The deployed Reputation/Multicall/P2PIX addresses are written to
-`ignition/deployments/chain-<id>/deployed_addresses.json`.

artifacts/contracts/DataTypes.sol/DataTypes.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/DataTypes.sol/DataTypes.json

@@ -0,0 +1,10 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "DataTypes",
+  "sourceName": "contracts/DataTypes.sol",
+  "abi": [],
+  "bytecode": "0x602d6037600b82828239805160001a607314602a57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea164736f6c6343000809000a",
+  "deployedBytecode": "0x73000000000000000000000000000000000000000030146080604052600080fdfea164736f6c6343000809000a",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/EventAndErrors.sol/EventAndErrors.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/EventAndErrors.sol/EventAndErrors.json

@@ -0,0 +1,357 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "EventAndErrors",
+  "sourceName": "contracts/EventAndErrors.sol",
+  "abi": [
+    {
+      "inputs": [],
+      "name": "AddressDenied",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "AlreadyReleased",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "AmountNotAllowed",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "DecOverflow",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "DepositAlreadyExists",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "EmptyPixTarget",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "InvalidDeposit",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "InvalidSigner",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "LengthMismatch",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "LockExpired",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "LoopOverflow",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "MaxBalExceeded",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "NoTokens",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "NotEnoughTokens",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "NotExpired",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "NotInitialized",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "OnlySeller",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "StaticCallFailed",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "TokenDenied",
+      "type": "error"
+    },
+    {
+      "inputs": [],
+      "name": "TxAlreadyUsed",
+      "type": "error"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "token",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "bool",
+          "name": "state",
+          "type": "bool"
+        }
+      ],
+      "name": "AllowedERC20Updated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "seller",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "token",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "DepositAdded",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "seller",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "token",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "DepositWithdrawn",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "owner",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "FundsWithdrawn",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "buyer",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "uint256",
+          "name": "lockID",
+          "type": "uint256"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "seller",
+          "type": "uint256"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "LockAdded",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "blocks",
+          "type": "uint256"
+        }
+      ],
+      "name": "LockBlocksUpdated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "buyer",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "lockId",
+          "type": "uint256"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "LockReleased",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "buyer",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "lockId",
+          "type": "uint256"
+        }
+      ],
+      "name": "LockReturned",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "reputation",
+          "type": "address"
+        }
+      ],
+      "name": "ReputationUpdated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "seller",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "bytes32",
+          "name": "merkleRoot",
+          "type": "bytes32"
+        }
+      ],
+      "name": "RootUpdated",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "seller",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "token",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "bool",
+          "name": "state",
+          "type": "bool"
+        }
+      ],
+      "name": "ValidSet",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "address[]",
+          "name": "signers",
+          "type": "address[]"
+        }
+      ],
+      "name": "ValidSignersUpdated",
+      "type": "event"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/Reputation.sol/Reputation.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/Reputation.sol/Reputation.json

@@ -0,0 +1,106 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "Reputation",
+  "sourceName": "contracts/Reputation.sol",
+  "abi": [
+    {
+      "inputs": [],
+      "stateMutability": "nonpayable",
+      "type": "constructor"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "user",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "newOwner",
+          "type": "address"
+        }
+      ],
+      "name": "OwnerUpdated",
+      "type": "event"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "uint256",
+          "name": "_userCredit",
+          "type": "uint256"
+        }
+      ],
+      "name": "limiter",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "_spendLimit",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "pure",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "magicValue",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "maxLimit",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "owner",
+      "outputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "newOwner",
+          "type": "address"
+        }
+      ],
+      "name": "setOwner",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x608060405234801561001057600080fd5b50600080546001600160a01b031916339081178255604051909182917f8292fce18fa69edf4db7b94ea2e58241df0ae57f97e0a6c9b29067028bf92d76908290a350610416806100616000396000f3fe608060405234801561001057600080fd5b50600436106100675760003560e01c80634d2b1791116100505780634d2b17911461009e5780638da5cb5b146100b1578063a4b34557146100f657600080fd5b806313af40351461006c5780631a861d2614610081575b600080fd5b61007f61007a3660046102f4565b610102565b005b61008b620f424081565b6040519081526020015b60405180910390f35b61008b6100ac366004610331565b6101f7565b6000546100d19073ffffffffffffffffffffffffffffffffffffffff1681565b60405173ffffffffffffffffffffffffffffffffffffffff9091168152602001610095565b61008b643a3529440081565b60005473ffffffffffffffffffffffffffffffffffffffff163314610187576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152600c60248201527f554e415554484f52495a45440000000000000000000000000000000000000000604482015260640160405180910390fd5b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83169081178255604051909133917f8292fce18fa69edf4db7b94ea2e58241df0ae57f97e0a6c9b29067028bf92d769190a350565b600061021a6102068380610379565b61021590643a352944006103b6565b610242565b61022783620f4240610379565b61023191906103ce565b61023c9060016103b6565b92915050565b60b5817101000000000000000000000000000000000081106102695760409190911b9060801c5b690100000000000000000081106102855760209190911b9060401c5b65010000000000811061029d5760109190911b9060201c5b630100000081106102b35760089190911b9060101c5b62010000010260121c80820401600190811c80830401811c80830401811c80830401811c80830401811c80830401811c80830401901c908190048111900390565b60006020828403121561030657600080fd5b813573ffffffffffffffffffffffffffffffffffffffff8116811461032a57600080fd5b9392505050565b60006020828403121561034357600080fd5b5035919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b6000817fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff04831182151516156103b1576103b161034a565b500290565b600082198211156103c9576103c961034a565b500190565b600082610404577f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b50049056fea164736f6c6343000809000a",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100675760003560e01c80634d2b1791116100505780634d2b17911461009e5780638da5cb5b146100b1578063a4b34557146100f657600080fd5b806313af40351461006c5780631a861d2614610081575b600080fd5b61007f61007a3660046102f4565b610102565b005b61008b620f424081565b6040519081526020015b60405180910390f35b61008b6100ac366004610331565b6101f7565b6000546100d19073ffffffffffffffffffffffffffffffffffffffff1681565b60405173ffffffffffffffffffffffffffffffffffffffff9091168152602001610095565b61008b643a3529440081565b60005473ffffffffffffffffffffffffffffffffffffffff163314610187576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152600c60248201527f554e415554484f52495a45440000000000000000000000000000000000000000604482015260640160405180910390fd5b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff83169081178255604051909133917f8292fce18fa69edf4db7b94ea2e58241df0ae57f97e0a6c9b29067028bf92d769190a350565b600061021a6102068380610379565b61021590643a352944006103b6565b610242565b61022783620f4240610379565b61023191906103ce565b61023c9060016103b6565b92915050565b60b5817101000000000000000000000000000000000081106102695760409190911b9060801c5b690100000000000000000081106102855760209190911b9060401c5b65010000000000811061029d5760109190911b9060201c5b630100000081106102b35760089190911b9060101c5b62010000010260121c80820401600190811c80830401811c80830401811c80830401811c80830401811c80830401811c80830401901c908190048111900390565b60006020828403121561030657600080fd5b813573ffffffffffffffffffffffffffffffffffffffff8116811461032a57600080fd5b9392505050565b60006020828403121561034357600080fd5b5035919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b6000817fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff04831182151516156103b1576103b161034a565b500290565b600082198211156103c9576103c961034a565b500190565b600082610404577f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b50049056fea164736f6c6343000809000a",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/auth/Owned.sol/Owned.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/auth/Owned.sol/Owned.json

@@ -0,0 +1,56 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "Owned",
+  "sourceName": "contracts/lib/auth/Owned.sol",
+  "abi": [
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "user",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "newOwner",
+          "type": "address"
+        }
+      ],
+      "name": "OwnerUpdated",
+      "type": "event"
+    },
+    {
+      "inputs": [],
+      "name": "owner",
+      "outputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "newOwner",
+          "type": "address"
+        }
+      ],
+      "name": "setOwner",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/interfaces/IReputation.sol/IReputation.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/interfaces/IReputation.sol/IReputation.json

@@ -0,0 +1,30 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "IReputation",
+  "sourceName": "contracts/lib/interfaces/IReputation.sol",
+  "abi": [
+    {
+      "inputs": [
+        {
+          "internalType": "uint256",
+          "name": "_userCredit",
+          "type": "uint256"
+        }
+      ],
+      "name": "limiter",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "_spendLimit",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "pure",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/mock/mockToken.sol/MockToken.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/tokens/ERC20.sol/ERC20.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/tokens/ERC20.sol/ERC20.json

@@ -0,0 +1,308 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "ERC20",
+  "sourceName": "contracts/lib/tokens/ERC20.sol",
+  "abi": [
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "owner",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "spender",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "Approval",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "from",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "to",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "Transfer",
+      "type": "event"
+    },
+    {
+      "inputs": [],
+      "name": "DOMAIN_SEPARATOR",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        },
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "name": "allowance",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "spender",
+          "type": "address"
+        },
+        {
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "approve",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "name": "balanceOf",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "decimals",
+      "outputs": [
+        {
+          "internalType": "uint8",
+          "name": "",
+          "type": "uint8"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "name",
+      "outputs": [
+        {
+          "internalType": "string",
+          "name": "",
+          "type": "string"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "name": "nonces",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "owner",
+          "type": "address"
+        },
+        {
+          "internalType": "address",
+          "name": "spender",
+          "type": "address"
+        },
+        {
+          "internalType": "uint256",
+          "name": "value",
+          "type": "uint256"
+        },
+        {
+          "internalType": "uint256",
+          "name": "deadline",
+          "type": "uint256"
+        },
+        {
+          "internalType": "uint8",
+          "name": "v",
+          "type": "uint8"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "r",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "s",
+          "type": "bytes32"
+        }
+      ],
+      "name": "permit",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "symbol",
+      "outputs": [
+        {
+          "internalType": "string",
+          "name": "",
+          "type": "string"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "totalSupply",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "to",
+          "type": "address"
+        },
+        {
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "transfer",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "from",
+          "type": "address"
+        },
+        {
+          "internalType": "address",
+          "name": "to",
+          "type": "address"
+        },
+        {
+          "internalType": "uint256",
+          "name": "amount",
+          "type": "uint256"
+        }
+      ],
+      "name": "transferFrom",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/utils/MerkleProofLib.sol/MerkleProofLib.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/utils/MerkleProofLib.sol/MerkleProofLib.json

@@ -0,0 +1,10 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "MerkleProofLib",
+  "sourceName": "contracts/lib/utils/MerkleProofLib.sol",
+  "abi": [],
+  "bytecode": "0x602d6037600b82828239805160001a607314602a57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea164736f6c6343000809000a",
+  "deployedBytecode": "0x73000000000000000000000000000000000000000030146080604052600080fdfea164736f6c6343000809000a",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/utils/Multicall.sol/Multicall.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/utils/Multicall.sol/Multicall.json

@@ -0,0 +1,116 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "Multicall",
+  "sourceName": "contracts/lib/utils/Multicall.sol",
+  "abi": [
+    {
+      "inputs": [],
+      "stateMutability": "payable",
+      "type": "constructor"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "string",
+          "name": "reason",
+          "type": "string"
+        }
+      ],
+      "name": "CallFailed",
+      "type": "error"
+    },
+    {
+      "inputs": [
+        {
+          "components": [
+            {
+              "internalType": "address",
+              "name": "target",
+              "type": "address"
+            },
+            {
+              "internalType": "bytes",
+              "name": "callData",
+              "type": "bytes"
+            }
+          ],
+          "internalType": "struct Multicall.Call[]",
+          "name": "calls",
+          "type": "tuple[]"
+        }
+      ],
+      "name": "mtc1",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        },
+        {
+          "internalType": "bytes[]",
+          "name": "",
+          "type": "bytes[]"
+        }
+      ],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "components": [
+            {
+              "internalType": "address",
+              "name": "target",
+              "type": "address"
+            },
+            {
+              "internalType": "bytes",
+              "name": "callData",
+              "type": "bytes"
+            }
+          ],
+          "internalType": "struct Multicall.Call[]",
+          "name": "calls",
+          "type": "tuple[]"
+        }
+      ],
+      "name": "mtc2",
+      "outputs": [
+        {
+          "internalType": "uint256",
+          "name": "",
+          "type": "uint256"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        },
+        {
+          "components": [
+            {
+              "internalType": "bool",
+              "name": "success",
+              "type": "bool"
+            },
+            {
+              "internalType": "bytes",
+              "name": "returnData",
+              "type": "bytes"
+            }
+          ],
+          "internalType": "struct Multicall.Result[]",
+          "name": "",
+          "type": "tuple[]"
+        }
+      ],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x60806040526108ec806100136000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80631b57b72f1461003b57806386575ee914610066575b600080fd5b61004e610049366004610438565b610087565b60405161005d93929190610527565b60405180910390f35b610079610074366004610438565b610227565b60405161005d9291906105cb565b600080606043804085848167ffffffffffffffff8111156100aa576100aa610653565b6040519080825280602002602001820160405280156100f057816020015b6040805180820190915260008152606060208201528152602001906001900390816100c85790505b50905060005b82811015610217576000808b8b8481811061011357610113610682565b905060200281019061012591906106b1565b6101339060208101906106ef565b73ffffffffffffffffffffffffffffffffffffffff168c8c8581811061015b5761015b610682565b905060200281019061016d91906106b1565b61017b90602081019061072c565b604051610189929190610791565b6000604051808303816000865af19150503d80600081146101c6576040519150601f19603f3d011682016040523d82523d6000602084013e6101cb565b606091505b509150915060405180604001604052808315158152602001828152508484815181106101f9576101f9610682565b60200260200101819052508261020e906107a1565b925050506100f6565b5092989197509195509350505050565b600060604383838167ffffffffffffffff81111561024757610247610653565b60405190808252806020026020018201604052801561027a57816020015b60608152602001906001900390816102655790505b50905060005b828110156104285760008089898481811061029d5761029d610682565b90506020028101906102af91906106b1565b6102bd9060208101906106ef565b73ffffffffffffffffffffffffffffffffffffffff168a8a858181106102e5576102e5610682565b90506020028101906102f791906106b1565b61030590602081019061072c565b604051610313929190610791565b6000604051808303816000865af19150503d8060008114610350576040519150601f19603f3d011682016040523d82523d6000602084013e610355565b606091505b5091509150816103f7576044815110156103aa576040517fb5e1dc2d00000000000000000000000000000000000000000000000000000000815260206004820152600060248201526044015b60405180910390fd5b600481019050808060200190518101906103c49190610801565b6040517fb5e1dc2d0000000000000000000000000000000000000000000000000000000081526004016103a191906108cc565b8084848151811061040a5761040a610682565b60200260200101819052508261041f906107a1565b92505050610280565b50919350909150505b9250929050565b6000806020838503121561044b57600080fd5b823567ffffffffffffffff8082111561046357600080fd5b818501915085601f83011261047757600080fd5b81358181111561048657600080fd5b8660208260051b850101111561049b57600080fd5b60209290920196919550909350505050565b60005b838110156104c85781810151838201526020016104b0565b838111156104d7576000848401525b50505050565b600081518084526104f58160208601602086016104ad565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160200192915050565b60006060820185835260208581850152604060608186015282865180855260808701915060808160051b880101945083880160005b828110156105bb578887037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8001845281518051151588528601518688018690526105a8868901826104dd565b975050928501929085019060010161055c565b50949a9950505050505050505050565b600060408201848352602060408185015281855180845260608601915060608160051b870101935082870160005b82811015610645577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa08887030184526106338683516104dd565b955092840192908401906001016105f9565b509398975050505050505050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc18336030181126106e557600080fd5b9190910192915050565b60006020828403121561070157600080fd5b813573ffffffffffffffffffffffffffffffffffffffff8116811461072557600080fd5b9392505050565b60008083357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe184360301811261076157600080fd5b83018035915067ffffffffffffffff82111561077c57600080fd5b60200191503681900382131561043157600080fd5b8183823760009101908152919050565b60007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8214156107fa577f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b5060010190565b60006020828403121561081357600080fd5b815167ffffffffffffffff8082111561082b57600080fd5b818401915084601f83011261083f57600080fd5b81518181111561085157610851610653565b604051601f82017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0908116603f0116810190838211818310171561089757610897610653565b816040528281528760208487010111156108b057600080fd5b6108c18360208301602088016104ad565b979650505050505050565b60208152600061072560208301846104dd56fea164736f6c6343000809000a",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100365760003560e01c80631b57b72f1461003b57806386575ee914610066575b600080fd5b61004e610049366004610438565b610087565b60405161005d93929190610527565b60405180910390f35b610079610074366004610438565b610227565b60405161005d9291906105cb565b600080606043804085848167ffffffffffffffff8111156100aa576100aa610653565b6040519080825280602002602001820160405280156100f057816020015b6040805180820190915260008152606060208201528152602001906001900390816100c85790505b50905060005b82811015610217576000808b8b8481811061011357610113610682565b905060200281019061012591906106b1565b6101339060208101906106ef565b73ffffffffffffffffffffffffffffffffffffffff168c8c8581811061015b5761015b610682565b905060200281019061016d91906106b1565b61017b90602081019061072c565b604051610189929190610791565b6000604051808303816000865af19150503d80600081146101c6576040519150601f19603f3d011682016040523d82523d6000602084013e6101cb565b606091505b509150915060405180604001604052808315158152602001828152508484815181106101f9576101f9610682565b60200260200101819052508261020e906107a1565b925050506100f6565b5092989197509195509350505050565b600060604383838167ffffffffffffffff81111561024757610247610653565b60405190808252806020026020018201604052801561027a57816020015b60608152602001906001900390816102655790505b50905060005b828110156104285760008089898481811061029d5761029d610682565b90506020028101906102af91906106b1565b6102bd9060208101906106ef565b73ffffffffffffffffffffffffffffffffffffffff168a8a858181106102e5576102e5610682565b90506020028101906102f791906106b1565b61030590602081019061072c565b604051610313929190610791565b6000604051808303816000865af19150503d8060008114610350576040519150601f19603f3d011682016040523d82523d6000602084013e610355565b606091505b5091509150816103f7576044815110156103aa576040517fb5e1dc2d00000000000000000000000000000000000000000000000000000000815260206004820152600060248201526044015b60405180910390fd5b600481019050808060200190518101906103c49190610801565b6040517fb5e1dc2d0000000000000000000000000000000000000000000000000000000081526004016103a191906108cc565b8084848151811061040a5761040a610682565b60200260200101819052508261041f906107a1565b92505050610280565b50919350909150505b9250929050565b6000806020838503121561044b57600080fd5b823567ffffffffffffffff8082111561046357600080fd5b818501915085601f83011261047757600080fd5b81358181111561048657600080fd5b8660208260051b850101111561049b57600080fd5b60209290920196919550909350505050565b60005b838110156104c85781810151838201526020016104b0565b838111156104d7576000848401525b50505050565b600081518084526104f58160208601602086016104ad565b601f017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0169290920160200192915050565b60006060820185835260208581850152604060608186015282865180855260808701915060808160051b880101945083880160005b828110156105bb578887037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8001845281518051151588528601518688018690526105a8868901826104dd565b975050928501929085019060010161055c565b50949a9950505050505050505050565b600060408201848352602060408185015281855180845260608601915060608160051b870101935082870160005b82811015610645577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa08887030184526106338683516104dd565b955092840192908401906001016105f9565b509398975050505050505050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600082357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc18336030181126106e557600080fd5b9190910192915050565b60006020828403121561070157600080fd5b813573ffffffffffffffffffffffffffffffffffffffff8116811461072557600080fd5b9392505050565b60008083357fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe184360301811261076157600080fd5b83018035915067ffffffffffffffff82111561077c57600080fd5b60200191503681900382131561043157600080fd5b8183823760009101908152919050565b60007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8214156107fa577f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b5060010190565b60006020828403121561081357600080fd5b815167ffffffffffffffff8082111561082b57600080fd5b818401915084601f83011261083f57600080fd5b81518181111561085157610851610653565b604051601f82017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0908116603f0116810190838211818310171561089757610897610653565b816040528281528760208487010111156108b057600080fd5b6108c18360208301602088016104ad565b979650505050505050565b60208152600061072560208301846104dd56fea164736f6c6343000809000a",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/utils/ReentrancyGuard.sol/ReentrancyGuard.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/utils/ReentrancyGuard.sol/ReentrancyGuard.json

@@ -0,0 +1,16 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "ReentrancyGuard",
+  "sourceName": "contracts/lib/utils/ReentrancyGuard.sol",
+  "abi": [
+    {
+      "inputs": [],
+      "name": "Reentrancy",
+      "type": "error"
+    }
+  ],
+  "bytecode": "0x",
+  "deployedBytecode": "0x",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/lib/utils/SafeTransferLib.sol/SafeTransferLib.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

artifacts/contracts/lib/utils/SafeTransferLib.sol/SafeTransferLib.json

@@ -0,0 +1,10 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "SafeTransferLib",
+  "sourceName": "contracts/lib/utils/SafeTransferLib.sol",
+  "abi": [],
+  "bytecode": "0x602d6037600b82828239805160001a607314602a57634e487b7160e01b600052600060045260246000fd5b30600052607381538281f3fe73000000000000000000000000000000000000000030146080604052600080fdfea164736f6c6343000809000a",
+  "deployedBytecode": "0x73000000000000000000000000000000000000000030146080604052600080fdfea164736f6c6343000809000a",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

artifacts/contracts/p2pix.sol/P2PIX.dbg.json

@@ -0,0 +1,4 @@
+{
+  "_format": "hh-sol-dbg-1",
+  "buildInfo": "../../build-info/901b067f80b6616939e558d795c555e5.json"
+}

contracts/DataTypes.sol

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.9;
+
+import { ERC20 } from "./lib/tokens/ERC20.sol";
+
+library DataTypes {
+    struct Lock {
+        uint256 sellerKey;
+        uint256 counter;
+        /// @dev Amount to be paid for relayer.
+        uint256 relayerPremium;
+        /// @dev Amount to be tranfered via PIX.
+        uint256 amount;
+        /// @dev If not paid at this block will be expired.
+        uint256 expirationBlock;
+        uint160 pixTarget;
+        /// @dev Where the tokens are sent the when order gets validated.
+        address buyerAddress;
+        /// @dev Relayer's target address that receives `relayerPremium` funds.
+        address relayerTarget;
+        /// @dev Relayer address (msg.sender) that facilitated this transaction.
+        /// @dev Reputation points accruer.
+        address relayerAddress;
+        ERC20 token;
+    }
+
+    // prettier-ignore
+    enum LockStatus {
+        Inexistent,     // 0 := Uninitialized Lock.
+        Active,         // 1 := Valid Lock.
+        Expired,        // 2 := Expired Lock.
+        Released        // 3 := Already released Lock.
+    }
+}

contracts/EventAndErrors.sol

@@ -1,79 +1,64 @@
 // SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
+pragma solidity 0.8.9;
 
-import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+import { ERC20 } from "./lib/tokens/ERC20.sol";
 
 // prettier-ignore
 interface EventAndErrors {
     /// ███ Events ████████████████████████████████████████████████████████████
 
-    /// @dev 0x63d8d7d5e63e9840ec91a12a160d27b7cfab294f6ba070b7359692acfe6b03bf
     event DepositAdded(
         address indexed seller,
         // uint256 depositID,
         ERC20 token,
         uint256 amount
     );
-    /// @dev 0xca585721b6b442dc9183932f7c84dc2880efb67c4da52cc06873e78971105d49
     event ValidSet(
         address indexed seller,
         ERC20 token,
         bool state
     );
-    /// @dev 0x2cd6435b1b961c13f55202979edd0765a809f69a539d8a477436c94c1211e43e
     event DepositWithdrawn(
         address indexed seller,
         ERC20 token,
         uint256 amount
     );
-    /// @dev 0x8fb3989f70bd172a37d15b41b015e48ea09d59329638377304a4198cd0c4ea65
     event LockAdded(
         address indexed buyer,
         uint256 indexed lockID,
-        address seller,
+        uint256 seller,
         uint256 amount
     );
-    /// @dev 0x364537f14276f2a0ce9905588413f96454cbb8fb2e4f5308389307c1098bede8
     event LockReleased(
         address indexed buyer, 
         uint256 lockId,
         uint256 amount
     );
-    /// @dev 0x830501e61b8b075e170b22a430e39454bdb12ed3e9620e586430b6ac00079da5
     event LockReturned(
         address indexed buyer, 
         uint256 lockId
     );
-    /// @dev 0xeaff4b37086828766ad3268786972c0cd24259d4c87a80f9d3963a3c3d999b0d
     event FundsWithdrawn(
         address owner, 
         uint256 amount
     );
-    /// @dev 0x0b294da292f26e55fd442b5c0164fbb9013036ff00c5cfdde0efd01c1baaf632
     event RootUpdated(
-        address indexed seller, 
+        address seller, 
-        bytes32 indexed merkleRoot
+        bytes32 merkleRoot
     );
-    /// @dev 0x5d6e86e5341d57a92c49934296c51542a25015c9b1782a1c2722a940131c3d9a
     event AllowedERC20Updated(
         address indexed token,
         bool indexed state
     );
-    /// @dev 0xbee55516e29d3969d3cb8eb01351eb3c52d06f9e2435bd5a8bfe3647e185df92
-    event TrustedForwarderUpdated(
-        address indexed forwarder, 
-        bool indexed state
-    );
-    /// @dev 0xe127cf589a3879da0156d4a24f43b44f65cfa3570de594806b0bfa2fcf06884f
     event ReputationUpdated(address reputation);
-    /// @dev 0x70fa43ca70216ad905ade86b9e650a691b2ce5a01980d0a81bdd8324141b8511
     event LockBlocksUpdated(uint256 blocks);
-    /// @dev 0x14a422d2412784a5749d03da98921fe468c98577b767851389a9f58ea5a363d7
     event ValidSignersUpdated(address[] signers);
 
-
     /// ███ Errors ████████████████████████████████████████████████████████████
 
+    /// @dev Deposit already exist and it is still valid.
+    /// @dev 0xc44bd765
+    error DepositAlreadyExists();
     /// @dev Only seller could call this function.
     /// @dev `msg.sender` and the seller differ.
     /// @dev 0x85d1f726
@@ -122,6 +107,7 @@ interface EventAndErrors {
     /// @dev Reverts on an expired lock.
     /// @dev 0xf6fafba0
     error LockExpired();
+    
     /// @dev 0xce3a3d37
     error DecOverflow();
     /// @dev 0xf3fb0eb9

contracts/Reputation.sol

@@ -1,9 +1,10 @@
 // SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
+pragma solidity 0.8.9;
 
 import { IReputation } from "./lib/interfaces/IReputation.sol";
+import { Owned } from "./lib/auth/Owned.sol";
 
-contract Reputation is IReputation {
+contract Reputation is IReputation, Owned(msg.sender) {
     /// @dev Asymptote numerator constant value for the `limiter` fx.
     uint256 public constant maxLimit = 1e6;
     /// @dev Denominator's constant operand for the `limiter` fx.
@@ -12,7 +13,7 @@ contract Reputation is IReputation {
     // prettier-ignore
     // solhint-disable no-inline-assembly
     // solhint-disable-next-line no-empty-blocks
-    constructor(/*  */) payable {/*  */}
+    constructor(/*  */) {/*  */}
 
     function limiter(
         uint256 _userCredit

contracts/core/BaseUtils.sol

@@ -1,181 +0,0 @@
-// SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
-
-import { ERC20, OwnerSettings } from "contracts/core/OwnerSettings.sol";
-
-import { ECDSA } from "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
-import { MessageHashUtils } from "@openzeppelin/contracts/utils/cryptography/MessageHashUtils.sol";
-import { MerkleProof as Merkle } from "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";
-import { ReentrancyGuard } from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
-
-abstract contract BaseUtils is
-    OwnerSettings,
-    ReentrancyGuard
-{
-    /// ███ Storage ████████████████████████████████████████████████████████████
-
-    /// @dev List of Pix transactions already signed.
-    ///     mapping(bytes32 => bool) public usedTransactions;
-    /// @dev Value in custom storage slot given by:
-    ///     let value := sload(bytes32).
-
-    /// ███ Helper FX ██████████████████████████████████████████████████████████
-    function _setUsedTransactions(bytes32 message) internal {
-        assembly ("memory-safe") {
-            sstore(message, true)
-        }
-    }
-
-    function usedTransactions(
-        bytes32 message
-    ) public view returns (bool used) {
-        assembly ("memory-safe") {
-            used := sload(message)
-        }
-    }
-
-    function _signerCheck(
-        bytes32 _message,
-        bytes calldata _signature
-    ) internal view {
-        if (usedTransactions(_message))
-            revert TxAlreadyUsed();
-
-        if (
-            !validBacenSigners(
-                _castAddrToKey(
-                    ECDSA.recover(
-                        MessageHashUtils
-                            .toEthSignedMessageHash(_message),
-                        _signature
-                    )
-                )
-            )
-        ) revert InvalidSigner();
-    }
-
-    function _merkleVerify(
-        bytes32[] calldata _merkleProof,
-        bytes32 _root,
-        address _addr
-    ) internal pure {
-        if (
-            !Merkle.verify(
-                _merkleProof,
-                _root,
-                bytes32(uint256(uint160(_addr)))
-            )
-        ) revert AddressDenied();
-    }
-
-    function _castBool(
-        bool _valid
-    ) internal pure returns (uint256 _validCasted) {
-        assembly ("memory-safe") {
-            _validCasted := _valid
-        }
-    }
-
-    function getStr(
-        string memory str
-    ) public pure returns (bytes32 strEnc) {
-        bytes memory enc = bytes(abi.encodePacked(str));
-        assembly ("memory-safe") {
-            if lt(0x20, mload(enc)) {
-                invalid()
-            }
-            strEnc := mload(add(enc, 0x20))
-        }
-    }
-
-    function _setSellerBalance(
-        address _sellerKey,
-        ERC20 _erc20,
-        uint256 _packed,
-        bytes32 _pixTarget
-    ) internal {
-        assembly ("memory-safe") {
-            mstore(0x20, _erc20)
-            mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-            mstore(0x00, _sellerKey)
-            let _loc := keccak256(0x0c, 0x34)
-            sstore(add(_loc, 0x01), _packed)
-            sstore(_loc, _pixTarget)
-        }
-    }
-
-    function _setValidState(
-        address _sellerKey,
-        ERC20 _erc20,
-        uint256 _packed
-    ) internal {
-        assembly ("memory-safe") {
-            mstore(0x20, _erc20)
-            mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-            mstore(0x00, _sellerKey)
-            let _loc := keccak256(0x0c, 0x34)
-            sstore(add(_loc, 0x01), _packed)
-        }
-    }
-
-    function _addSellerBalance(
-        address _sellerKey,
-        ERC20 _erc20,
-        uint256 _amount
-    ) internal {
-        assembly ("memory-safe") {
-            mstore(0x20, _erc20)
-            mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-            mstore(0x00, _sellerKey)
-            let _loc := add(keccak256(0x0c, 0x34), 0x01)
-            sstore(_loc, add(sload(_loc), _amount))
-        }
-    }
-
-    function _decSellerBalance(
-        address _sellerKey,
-        ERC20 _erc20,
-        uint256 _amount
-    ) internal {
-        assembly ("memory-safe") {
-            mstore(0x20, _erc20)
-            mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-            mstore(0x00, _sellerKey)
-            let _loc := add(keccak256(0x0c, 0x34), 0x01)
-            sstore(_loc, sub(sload(_loc), _amount))
-        }
-    }
-
-    function __sellerBalance(
-        address _sellerKey,
-        ERC20 _erc20
-    ) internal view returns (uint256 _packed) {
-        assembly ("memory-safe") {
-            mstore(0x20, _erc20)
-            mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-            mstore(0x00, _sellerKey)
-            _packed := sload(add(keccak256(0x0c, 0x34), 0x01))
-        }
-    }
-
-    /// @notice Public method that handles `address`
-    /// to `uint256` safe type casting.
-    /// @dev Function sighash: 0x4b2ae980.
-    function _castAddrToKey(
-        address _addr
-    ) public pure returns (uint256 _key) {
-        // _key = uint256(uint160(address(_addr))) << 12;
-        assembly ("memory-safe") {
-            _key := shl(0xc, _addr)
-        }
-    }
-
-    function _castKeyToAddr(
-        uint256 _key
-    ) public pure returns (address _addr) {
-        // _addr = address(uint160(uint256(_key >> 12)));
-        assembly ("memory-safe") {
-            _addr := shr(0xc, _key)
-        }
-    }
-}

contracts/core/Constants.sol

@@ -1,56 +0,0 @@
-// SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
-
-abstract contract Constants {
-    /// ███ Constants ██████████████████████████████████████████████████████████
-
-    uint256 internal constant _ROOT_UPDATED_EVENT_SIGNATURE =
-        0x0b294da292f26e55fd442b5c0164fbb9013036ff00c5cfdde0efd01c1baaf632;
-    uint256
-        internal constant _ALLOWED_ERC20_UPDATED_EVENT_SIGNATURE =
-        0x5d6e86e5341d57a92c49934296c51542a25015c9b1782a1c2722a940131c3d9a;
-    uint256
-        internal constant _TRUSTED_FORWARDER_UPDATED_EVENT_SIGNATURE =
-        0xbee55516e29d3969d3cb8eb01351eb3c52d06f9e2435bd5a8bfe3647e185df92;
-
-    /// @dev Seller casted to key => Seller's allowlist merkleroot.
-    /// mapping(uint256 => bytes32) public sellerAllowList;
-    uint256 internal constant _SELLER_ALLOWLIST_SLOT_SEED =
-        0x74dfee70;
-    /// @dev Tokens allowed to serve as the underlying amount of a deposit.
-    /// mapping(ERC20 => bool) public allowedERC20s;
-    uint256 internal constant _ALLOWED_ERC20_SLOT_SEED =
-        0xcbc9d1c4;
-
-    /// @dev `balance` max. value = 10**26.
-    /// @dev `pixTarget` keys are restricted to 160 bits.
-    ///     mapping(uint256 => mapping(ERC20 => { `uint256`, `uint96` } )) public sellerBalance;
-
-    /// @dev Bits layout:
-    /// `bytes32` [0...255] := pixTarget
-    /// `uint96`  [0...94]   := balance
-    /// `bool`    [95]       := valid
-
-    /// @dev Value in custom storage slot given by:
-    ///     mstore(0x20, token)
-    ///     mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-    ///     mstore(0x00, seller)
-    ///     let value := sload(keccak256(0x0c, 0x34)).
-    uint256 internal constant _SELLER_BALANCE_SLOT_SEED =
-        0x739094b1;
-
-    /// @dev The bitmask of `sellerBalance` entry.
-    uint256 internal constant BITMASK_SB_ENTRY =
-        (1 << 94) - 1;
-    /// @dev The bit position of `valid` in `sellerBalance`.
-    uint256 internal constant BITPOS_VALID = 95;
-
-    /// @dev The scalar of BRZ token.
-    uint256 internal constant WAD = 1e18;
-    uint256 internal constant MAXBALANCE_UPPERBOUND =
-        1e8 ether;
-    uint256 internal constant REPUTATION_LOWERBOUND =
-        1e2 ether;
-    uint256 internal constant LOCKAMOUNT_UPPERBOUND =
-        1e6 ether;
-}

contracts/core/DataTypes.sol

@@ -1,24 +0,0 @@
-// SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
-
-import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
-
-library DataTypes {
-    struct Lock {
-        uint256 counter;
-        uint256 expirationBlock;
-        bytes32 pixTarget;
-        uint80 amount;
-        ERC20 token;
-        address buyerAddress;
-        address seller;
-    }
-
-    // prettier-ignore
-    enum LockStatus {
-        Inexistent,     // 0 := Uninitialized Lock.
-        Active,         // 1 := Valid Lock.
-        Expired,        // 2 := Expired Lock.
-        Released        // 3 := Already released Lock.
-    }
-}

contracts/core/OwnerSettings.sol

@@ -1,241 +0,0 @@
-// SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
-
-import { ERC2771 } from "contracts/lib/metatx/ERC2771Context.sol";
-import { ERC20, SafeTransferLib } from "contracts/lib/utils/SafeTransferLib.sol";
-import { IReputation } from "contracts/lib/interfaces/IReputation.sol";
-import { EventAndErrors } from "contracts/core/EventAndErrors.sol";
-import { Constants } from "contracts/core/Constants.sol";
-import { Owned } from "contracts/lib/auth/Owned.sol";
-
-abstract contract OwnerSettings is
-    Constants,
-    EventAndErrors,
-    Owned(msg.sender),
-    ERC2771
-{
-    /// ███ Storage ████████████████████████████████████████████████████████████
-
-    /// @dev List of valid Bacen signature addresses
-    ///     mapping(uint256 => bool) public validBacenSigners;
-    /// @dev Value in custom storage slot given by:
-    ///     let value := sload(shl(12, address)).
-
-    IReputation public reputation;
-    /// @dev Default blocks that lock will hold tokens.
-    uint256 public defaultLockBlocks;
-
-    /// ███ Constructor ████████████████████████████████████████████████████████
-
-    constructor(
-        uint256 defaultBlocks,
-        address[] memory validSigners,
-        address _reputation,
-        ERC20[] memory tokens,
-        bool[] memory tokenStates
-    ) {
-        setDefaultLockBlocks(defaultBlocks);
-        setValidSigners(validSigners);
-        setReputation(IReputation(_reputation));
-        tokenSettings(tokens, tokenStates);
-    }
-
-    /// ███ Owner Only █████████████████████████████████████████████████████████
-
-    function setTrustedFowarders(
-        address[] memory forwarders,
-        bool[] memory states
-    ) external onlyOwner {
-        assembly ("memory-safe") {
-            // first 32 bytes eq to array's length
-            let fLen := mload(forwarders)
-            // halts execution if forwarders.length eq 0
-            if iszero(fLen) {
-                invalid()
-            }
-            // revert with `LengthMismatch()`
-            if iszero(eq(fLen, mload(states))) {
-                mstore(0x00, 0xff633a38)
-                revert(0x1c, 0x04)
-            }
-            let fLoc := add(forwarders, 0x20)
-            let sLoc := add(states, 0x20)
-            for {
-                let end := add(fLoc, shl(5, fLen))
-            } iszero(eq(fLoc, end)) {
-                fLoc := add(fLoc, 0x20)
-                sLoc := add(sLoc, 0x20)
-            } {
-                // cache hashmap entry in scratch space
-                mstore(0x20, trustedForwarders.slot)
-                mstore(0x00, mload(fLoc))
-                //  let mapSlot := keccak256(0x00, 0x40)
-                sstore(keccak256(0x00, 0x40), mload(sLoc))
-
-                // emit TrustedForwarderUpdated(address, bool)
-                log3(
-                    0,
-                    0,
-                    _TRUSTED_FORWARDER_UPDATED_EVENT_SIGNATURE,
-                    mload(fLoc),
-                    mload(sLoc)
-                )
-            }
-        }
-    }
-
-    /// @dev Contract's underlying balance withdraw method.
-    /// @dev Function sighash: 0x5fd8c710.
-    function withdrawBalance() external onlyOwner {
-        uint256 balance = address(this).balance;
-        SafeTransferLib.safeTransferETH(msg.sender, balance);
-        emit FundsWithdrawn(msg.sender, balance);
-    }
-
-    function setReputation(
-        IReputation _reputation
-    ) public onlyOwner {
-        assembly ("memory-safe") {
-            sstore(reputation.slot, _reputation)
-        }
-        emit ReputationUpdated(address(_reputation));
-    }
-
-    function setDefaultLockBlocks(
-        uint256 _blocks
-    ) public onlyOwner {
-        assembly ("memory-safe") {
-            sstore(defaultLockBlocks.slot, _blocks)
-        }
-        emit LockBlocksUpdated(_blocks);
-    }
-
-    function setValidSigners(
-        address[] memory _validSigners
-    ) public onlyOwner {
-        assembly ("memory-safe") {
-            let i := add(_validSigners, 0x20)
-            let end := add(i, shl(0x05, mload(_validSigners)))
-            for {
-                /*  */
-            } iszero(returndatasize()) {
-                /*  */
-            } {
-                sstore(shl(0xc, mload(i)), true)
-                i := add(i, 0x20)
-
-                if iszero(lt(i, end)) {
-                    break
-                }
-            }
-        }
-        emit ValidSignersUpdated(_validSigners);
-    }
-
-    function tokenSettings(
-        ERC20[] memory _tokens,
-        bool[] memory _states
-    ) public onlyOwner {
-        /* Yul Impl */
-        assembly ("memory-safe") {
-            // first 32 bytes eq to array's length
-            let tLen := mload(_tokens)
-            // NoTokens()
-            if iszero(tLen) {
-                mstore(0x00, 0xdf957883)
-                revert(0x1c, 0x04)
-            }
-            // LengthMismatch()
-            if iszero(eq(tLen, mload(_states))) {
-                mstore(0x00, 0xff633a38)
-                revert(0x1c, 0x04)
-            }
-            let tLoc := add(_tokens, 0x20)
-            let sLoc := add(_states, 0x20)
-            for {
-                let end := add(tLoc, shl(5, tLen))
-            } iszero(eq(tLoc, end)) {
-                tLoc := add(tLoc, 0x20)
-                sLoc := add(sLoc, 0x20)
-            } {
-                // cache hashmap entry in scratch space
-                mstore(0x0c, _ALLOWED_ERC20_SLOT_SEED)
-                mstore(0x00, mload(tLoc))
-                //  let mapSlot := keccak256(0x0c, 0x20)
-                sstore(keccak256(0x0c, 0x20), mload(sLoc))
-
-                // emit AllowedERC20Updated(address, bool)
-                log3(
-                    0,
-                    0,
-                    _ALLOWED_ERC20_UPDATED_EVENT_SIGNATURE,
-                    mload(tLoc),
-                    mload(sLoc)
-                )
-            }
-        }
-    }
-
-    /// ███ View FX ████████████████████████████████████████████████████████████
-
-    function validBacenSigners(
-        uint256 signer
-    ) public view returns (bool valid) {
-        assembly ("memory-safe") {
-            valid := sload(signer)
-        }
-    }
-
-    function sellerAllowList(
-        address sellerKey
-    ) public view returns (bytes32 root) {
-        assembly ("memory-safe") {
-            mstore(0x0c, _SELLER_ALLOWLIST_SLOT_SEED)
-            mstore(0x00, sellerKey)
-            root := sload(keccak256(0x00, 0x20))
-        }
-    }
-
-    function allowedERC20s(
-        ERC20 erc20
-    ) public view returns (bool state) {
-        assembly ("memory-safe") {
-            mstore(0x0c, _ALLOWED_ERC20_SLOT_SEED)
-            mstore(0x00, erc20)
-            state := sload(keccak256(0x0c, 0x20))
-        }
-    }
-
-    function _limiter(
-        uint256 _userCredit
-    ) internal view returns (uint256 _spendLimit) {
-        bytes memory encodedParams = abi.encodeWithSelector(
-            // IReputation.limiter.selector,
-            0x4d2b1791,
-            _userCredit
-        );
-        bool success;
-        assembly ("memory-safe") {
-            success := staticcall(
-                // gas
-                gas(),
-                // address
-                sload(reputation.slot),
-                // argsOffset
-                add(encodedParams, 0x20),
-                // argsSize
-                mload(encodedParams),
-                // retOffset
-                0x00,
-                // retSize
-                0x20
-            )
-            _spendLimit := mload(0x00)
-            if iszero(success) {
-                // StaticCallFailed()
-                mstore(0x00, 0xe10bf1cc)
-                revert(0x1c, 0x04)
-            }
-        }
-    }
-}

contracts/lib/auth/Owned.sol

@@ -4,8 +4,6 @@ pragma solidity >=0.8.4;
 /// @notice Simple single owner authorization mixin.
 /// @author Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/auth/Owned.sol)
 abstract contract Owned {
-    error Unauthorized();
-
     /*//////////////////////////////////////////////////////////////
                                  EVENTS
     //////////////////////////////////////////////////////////////*/
@@ -22,7 +20,7 @@ abstract contract Owned {
     address public owner;
 
     modifier onlyOwner() virtual {
-        if (msg.sender != owner) revert Unauthorized();
+        require(msg.sender == owner, "UNAUTHORIZED");
 
         _;
     }

contracts/lib/metatx/ERC2771Context.sol

@@ -1,15 +0,0 @@
-// SPDX-License-Identifier: MIT
-
-pragma solidity ^0.8.20;
-
-import { ERC2771Context } from "@openzeppelin/contracts/metatx/ERC2771Context.sol";
-
-abstract contract ERC2771 is ERC2771Context(address(0)) {
-    mapping(address => bool) public trustedForwarders;
-
-    function isTrustedForwarder(
-        address forwarder
-    ) public view override returns (bool) {
-        return trustedForwarders[forwarder];
-    }
-}

contracts/lib/mock/mockToken.sol

@@ -1,10 +1,10 @@
 // SPDX-License-Identifier: MIT
-pragma solidity ^0.8.19;
+pragma solidity 0.8.9;
 
-import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+import { ERC20 } from "../tokens/ERC20.sol";
 
 contract MockToken is ERC20 {
-    constructor(uint256 supply) ERC20("MockBRL", "MBRL") {
+    constructor(uint256 supply) ERC20("MockBRL", "MBRL", 18) {
         _mint(msg.sender, supply);
     }
 

contracts/lib/tokens/ERC20.sol

@@ -0,0 +1,250 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4;
+
+/// @notice Modern and gas efficient ERC20 + EIP-2612 implementation.
+/// @author Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/tokens/ERC20.sol)
+/// @author Modified from Uniswap (https://github.com/Uniswap/uniswap-v2-core/blob/master/contracts/UniswapV2ERC20.sol)
+/// @dev Do not manually set balances without updating totalSupply, as the sum of all user balances must not exceed it.
+abstract contract ERC20 {
+    /*//////////////////////////////////////////////////////////////
+                                 EVENTS
+    //////////////////////////////////////////////////////////////*/
+
+    event Transfer(
+        address indexed from,
+        address indexed to,
+        uint256 amount
+    );
+
+    event Approval(
+        address indexed owner,
+        address indexed spender,
+        uint256 amount
+    );
+
+    /*//////////////////////////////////////////////////////////////
+                            METADATA STORAGE
+    //////////////////////////////////////////////////////////////*/
+
+    string public name;
+
+    string public symbol;
+
+    uint8 public immutable decimals;
+
+    /*//////////////////////////////////////////////////////////////
+                              ERC20 STORAGE
+    //////////////////////////////////////////////////////////////*/
+
+    uint256 public totalSupply;
+
+    mapping(address => uint256) public balanceOf;
+
+    mapping(address => mapping(address => uint256))
+        public allowance;
+
+    /*//////////////////////////////////////////////////////////////
+                            EIP-2612 STORAGE
+    //////////////////////////////////////////////////////////////*/
+
+    uint256 internal immutable INITIAL_CHAIN_ID;
+
+    bytes32 internal immutable INITIAL_DOMAIN_SEPARATOR;
+
+    mapping(address => uint256) public nonces;
+
+    /*//////////////////////////////////////////////////////////////
+                               CONSTRUCTOR
+    //////////////////////////////////////////////////////////////*/
+
+    constructor(
+        string memory _name,
+        string memory _symbol,
+        uint8 _decimals
+    ) {
+        name = _name;
+        symbol = _symbol;
+        decimals = _decimals;
+
+        INITIAL_CHAIN_ID = block.chainid;
+        INITIAL_DOMAIN_SEPARATOR = computeDomainSeparator();
+    }
+
+    /*//////////////////////////////////////////////////////////////
+                               ERC20 LOGIC
+    //////////////////////////////////////////////////////////////*/
+
+    function approve(
+        address spender,
+        uint256 amount
+    ) public virtual returns (bool) {
+        allowance[msg.sender][spender] = amount;
+
+        emit Approval(msg.sender, spender, amount);
+
+        return true;
+    }
+
+    function transfer(
+        address to,
+        uint256 amount
+    ) public virtual returns (bool) {
+        balanceOf[msg.sender] -= amount;
+
+        // Cannot overflow because the sum of all user
+        // balances can't exceed the max uint256 value.
+        unchecked {
+            balanceOf[to] += amount;
+        }
+
+        emit Transfer(msg.sender, to, amount);
+
+        return true;
+    }
+
+    function transferFrom(
+        address from,
+        address to,
+        uint256 amount
+    ) public virtual returns (bool) {
+        uint256 allowed = allowance[from][msg.sender]; // Saves gas for limited approvals.
+
+        if (allowed != type(uint256).max)
+            allowance[from][msg.sender] = allowed - amount;
+
+        balanceOf[from] -= amount;
+
+        // Cannot overflow because the sum of all user
+        // balances can't exceed the max uint256 value.
+        unchecked {
+            balanceOf[to] += amount;
+        }
+
+        emit Transfer(from, to, amount);
+
+        return true;
+    }
+
+    /*//////////////////////////////////////////////////////////////
+                             EIP-2612 LOGIC
+    //////////////////////////////////////////////////////////////*/
+
+    function permit(
+        address owner,
+        address spender,
+        uint256 value,
+        uint256 deadline,
+        uint8 v,
+        bytes32 r,
+        bytes32 s
+    ) public virtual {
+        require(
+            deadline >= block.timestamp,
+            "PERMIT_DEADLINE_EXPIRED"
+        );
+
+        // Unchecked because the only math done is incrementing
+        // the owner's nonce which cannot realistically overflow.
+        unchecked {
+            address recoveredAddress = ecrecover(
+                keccak256(
+                    abi.encodePacked(
+                        "\x19\x01",
+                        DOMAIN_SEPARATOR(),
+                        keccak256(
+                            abi.encode(
+                                keccak256(
+                                    "Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)"
+                                ),
+                                owner,
+                                spender,
+                                value,
+                                nonces[owner]++,
+                                deadline
+                            )
+                        )
+                    )
+                ),
+                v,
+                r,
+                s
+            );
+
+            require(
+                recoveredAddress != address(0) &&
+                    recoveredAddress == owner,
+                "INVALID_SIGNER"
+            );
+
+            allowance[recoveredAddress][spender] = value;
+        }
+
+        emit Approval(owner, spender, value);
+    }
+
+    function DOMAIN_SEPARATOR()
+        public
+        view
+        virtual
+        returns (bytes32)
+    {
+        return
+            block.chainid == INITIAL_CHAIN_ID
+                ? INITIAL_DOMAIN_SEPARATOR
+                : computeDomainSeparator();
+    }
+
+    function computeDomainSeparator()
+        internal
+        view
+        virtual
+        returns (bytes32)
+    {
+        return
+            keccak256(
+                abi.encode(
+                    keccak256(
+                        "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"
+                    ),
+                    keccak256(bytes(name)),
+                    keccak256("1"),
+                    block.chainid,
+                    address(this)
+                )
+            );
+    }
+
+    /*//////////////////////////////////////////////////////////////
+                        INTERNAL MINT/BURN LOGIC
+    //////////////////////////////////////////////////////////////*/
+
+    function _mint(
+        address to,
+        uint256 amount
+    ) internal virtual {
+        totalSupply += amount;
+
+        // Cannot overflow because the sum of all user
+        // balances can't exceed the max uint256 value.
+        unchecked {
+            balanceOf[to] += amount;
+        }
+
+        emit Transfer(address(0), to, amount);
+    }
+
+    function _burn(
+        address from,
+        uint256 amount
+    ) internal virtual {
+        balanceOf[from] -= amount;
+
+        // Cannot underflow because a user's balance
+        // will never be larger than the total supply.
+        unchecked {
+            totalSupply -= amount;
+        }
+
+        emit Transfer(from, address(0), amount);
+    }
+}

contracts/lib/utils/MerkleProofLib.sol

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4;
+
+/// @notice Gas optimized verification of proof of inclusion for a leaf in a Merkle tree.
+/// @author Solady
+/// (https://github.com/vectorized/solady/blob/main/src/utils/MerkleProofLib.sol)
+/// @author Modified from Solmate
+/// (https://github.com/transmissions11/solmate/blob/main/src/utils/MerkleProofLib.sol)
+/// @author Modified from OpenZeppelin
+/// (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/MerkleProof.sol)
+library MerkleProofLib {
+    /// @dev Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`.
+    function verify(
+        bytes32[] calldata proof,
+        bytes32 root,
+        bytes32 leaf
+    ) internal pure returns (bool isValid) {
+        /// @solidity memory-safe-assembly
+        assembly {
+            if proof.length {
+                // Left shift by 5 is equivalent to multiplying by 0x20.
+                let end := add(
+                    proof.offset,
+                    shl(5, proof.length)
+                )
+                // Initialize `offset` to the offset of `proof` in the calldata.
+                let offset := proof.offset
+                // Iterate over proof elements to compute root hash.
+                for {
+
+                } 1 {
+
+                } {
+                    // Slot of `leaf` in scratch space.
+                    // If the condition is true: 0x20, otherwise: 0x00.
+                    let scratch := shl(
+                        5,
+                        gt(leaf, calldataload(offset))
+                    )
+                    // Store elements to hash contiguously in scratch space.
+                    // Scratch space is 64 bytes (0x00 - 0x3f) and both elements are 32 bytes.
+                    mstore(scratch, leaf)
+                    mstore(
+                        xor(scratch, 0x20),
+                        calldataload(offset)
+                    )
+                    // Reuse `leaf` to store the hash to reduce stack operations.
+                    leaf := keccak256(0x00, 0x40)
+                    offset := add(offset, 0x20)
+                    if iszero(lt(offset, end)) {
+                        break
+                    }
+                }
+            }
+            isValid := eq(leaf, root)
+        }
+    }
+}

contracts/lib/utils/Multicall.sol

@@ -19,12 +19,12 @@ contract Multicall {
     }
 
     //prettier-ignore
-    //solhint-disable-next-line no-empty-blocks
     constructor(/*  */) payable {/*  */}
 
-    function mtc1(
+    function mtc1(Call[] calldata calls)
-        Call[] calldata calls
+        external
-    ) external returns (uint256, bytes[] memory) {
+        returns (uint256, bytes[] memory)
+    {
         uint256 bn = block.number;
         uint256 len = calls.length;
         bytes[] memory res = new bytes[](len);
@@ -49,14 +49,21 @@ contract Multicall {
         return (bn, res);
     }
 
-    function mtc2(
+    function mtc2(Call[] calldata calls)
-        Call[] calldata calls
+        external
-    ) external returns (uint256, bytes32, Result[] memory) {
+        returns (
+            uint256,
+            bytes32,
+            Result[] memory
+        )
+    {
         uint256 bn = block.number;
         // µ 0 s [0] ≡ P(IHp , µs [0], 0) ∴ P is the hash of a block of a particular number, up to a maximum age.
         // 0 is left on the stack if the looked for `block.number` is >= to the current `block.number` or more than 256
         // blocks behind the current block (Yellow Paper, p. 33, https://ethereum.github.io/yellowpaper/paper.pdf).
-        bytes32 bh = blockhash(bn /* - 1 */);
+        bytes32 bh = blockhash(
+            bn /* - 1 */
+        );
         uint256 len = calls.length;
         Result[] memory res = new Result[](len);
         uint256 i;

contracts/lib/utils/ReentrancyGuard.sol

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.4;
+
+/// @notice Reentrancy protection for smart contracts.
+/// @author z0r0z.eth
+/// @author Modified from Seaport
+///         (https://github.com/ProjectOpenSea/seaport/blob/main/contracts/lib/ReentrancyGuard.sol)
+/// @author Modified from Solmate
+///         (https://github.com/Rari-Capital/solmate/blob/main/src/utils/ReentrancyGuard.sol)
+abstract contract ReentrancyGuard {
+    error Reentrancy();
+
+    uint256 private guard = 1;
+
+    modifier nonReentrant() virtual {
+        setReentrancyGuard();
+
+        _;
+
+        clearReentrancyGuard();
+    }
+
+    /// @dev Check guard sentinel value and set it.
+    function setReentrancyGuard() internal virtual {
+        if (guard == 2) revert Reentrancy();
+
+        guard = 2;
+    }
+
+    /// @dev Unset sentinel value.
+    function clearReentrancyGuard() internal virtual {
+        guard = 1;
+    }
+}

contracts/lib/utils/SafeTransferLib.sol

@@ -1,143 +1,117 @@
 // SPDX-License-Identifier: MIT
 pragma solidity >=0.8.4;
 
-import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+import { ERC20 } from "../tokens/ERC20.sol";
 
 /// @notice Safe ETH and ERC20 transfer library that gracefully handles missing return values.
-/// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/SafeTransferLib.sol)
+/// @author Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/utils/SafeTransferLib.sol)
-/// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/SafeTransferLib.sol)
 /// @dev Caution! This library won't check that a token has code, responsibility is delegated to the caller.
 library SafeTransferLib {
-    /*//////////////////////////////////////////////////////////////
-                             CUSTOM ERRORS
-    //////////////////////////////////////////////////////////////*/
-
-    /// @dev The ETH transfer has failed.
-    error ETHTransferFailed();
-    /// @dev The ERC20 `transferFrom` has failed.
-    error TransferFromFailed();
-    /// @dev The ERC20 `transfer` has failed.
-    error TransferFailed();
-
     /*//////////////////////////////////////////////////////////////
                              ETH OPERATIONS
     //////////////////////////////////////////////////////////////*/
 
-    /// @dev Sends `amount` (in wei) ETH to `to`.
-    /// Reverts upon failure.
     function safeTransferETH(
         address to,
         uint256 amount
     ) internal {
-        /// @solidity memory-safe-assembly
+        bool success;
+
         assembly {
-            // Transfer the ETH and check if it succeeded or not.
+            // Transfer the ETH and store if it succeeded or not.
-            if iszero(call(gas(), to, amount, 0, 0, 0, 0)) {
+            success := call(gas(), to, amount, 0, 0, 0, 0)
-                // Store the function selector of `ETHTransferFailed()`.
-                mstore(0x00, 0xb12d13eb)
-                // Revert with (offset, size).
-                revert(0x1c, 0x04)
-            }
         }
+
+        require(success, "ETH_TRANSFER_FAILED");
     }
 
     /*//////////////////////////////////////////////////////////////
                             ERC20 OPERATIONS
     //////////////////////////////////////////////////////////////*/
 
-    /// @dev Sends `amount` of ERC20 `token` from `from` to `to`.
-    /// Reverts upon failure.
-    ///
-    /// The `from` account must have at least `amount` approved for
-    /// the current contract to manage.
     function safeTransferFrom(
         ERC20 token,
         address from,
         address to,
         uint256 amount
     ) internal {
-        /// @solidity memory-safe-assembly
+        bool success;
+
         assembly {
-            let m := mload(0x40) // Cache the free memory pointer.
+            // We'll write our calldata to this slot below, but restore it later.
+            let memPointer := mload(0x40)
 
-            mstore(0x60, amount) // Store the `amount` argument.
+            // Write the abi-encoded calldata into memory, beginning with the function selector.
-            mstore(0x40, to) // Store the `to` argument.
+            mstore(
-            mstore(0x2c, shl(96, from)) // Store the `from` argument.
+                0,
-            // Store the function selector of `transferFrom(address,address,uint256)`.
+                0x23b872dd00000000000000000000000000000000000000000000000000000000
-            mstore(0x0c, 0x23b872dd000000000000000000000000)
+            )
+            mstore(4, from) // Append the "from" argument.
+            mstore(36, to) // Append the "to" argument.
+            mstore(68, amount) // Append the "amount" argument.
 
-            if iszero(
+            success := and(
-                and(
+                // Set success to whether the call reverted, if not we check it either
-                    // The arguments of `and` are evaluated from right to left.
+                // returned exactly 1 (can't just be non-zero data), or had no return data.
-                    // Set success to whether the call reverted, if not we check it either
+                or(
-                    // returned exactly 1 (can't just be non-zero data), or had no return data.
+                    and(
-                    or(
+                        eq(mload(0), 1),
-                        eq(mload(0x00), 1),
+                        gt(returndatasize(), 31)
-                        iszero(returndatasize())
                     ),
-                    call(
+                    iszero(returndatasize())
-                        gas(),
+                ),
-                        token,
+                // We use 100 because that's the total length of our calldata (4 + 32 * 3)
-                        0,
+                // Counterintuitively, this call() must be positioned after the or() in the
-                        0x1c,
+                // surrounding and() because and() evaluates its arguments from right to left.
-                        0x64,
+                call(gas(), token, 0, 0, 100, 0, 32)
-                        0x00,
+            )
-                        0x20
-                    )
-                )
-            ) {
-                // Store the function selector of `TransferFromFailed()`.
-                mstore(0x00, 0x7939f424)
-                // Revert with (offset, size).
-                revert(0x1c, 0x04)
-            }
 
             mstore(0x60, 0) // Restore the zero slot to zero.
-            mstore(0x40, m) // Restore the free memory pointer.
+            mstore(0x40, memPointer) // Restore the memPointer.
         }
+
+        require(success, "TRANSFER_FROM_FAILED");
     }
 
-    /// @dev Sends `amount` of ERC20 `token` from the current contract to `to`.
-    /// Reverts upon failure.
     function safeTransfer(
         ERC20 token,
         address to,
         uint256 amount
     ) internal {
-        /// @solidity memory-safe-assembly
+        bool success;
-        assembly {
-            mstore(0x14, to) // Store the `to` argument.
-            mstore(0x34, amount) // Store the `amount` argument.
-            // Store the function selector of `transfer(address,uint256)`.
-            mstore(0x00, 0xa9059cbb000000000000000000000000)
 
-            if iszero(
+        assembly {
-                and(
+            // We'll write our calldata to this slot below, but restore it later.
-                    // The arguments of `and` are evaluated from right to left.
+            let memPointer := mload(0x40)
-                    // Set success to whether the call reverted, if not we check it either
+
-                    // returned exactly 1 (can't just be non-zero data), or had no return data.
+            // Write the abi-encoded calldata into memory, beginning with the function selector.
-                    or(
+            mstore(
-                        eq(mload(0x00), 1),
+                0,
-                        iszero(returndatasize())
+                0xa9059cbb00000000000000000000000000000000000000000000000000000000
+            )
+            mstore(4, to) // Append the "to" argument.
+            mstore(36, amount) // Append the "amount" argument.
+
+            success := and(
+                // Set success to whether the call reverted, if not we check it either
+                // returned exactly 1 (can't just be non-zero data), or had no return data.
+                or(
+                    and(
+                        eq(mload(0), 1),
+                        gt(returndatasize(), 31)
                     ),
-                    call(
+                    iszero(returndatasize())
-                        gas(),
+                ),
-                        token,
+                // We use 68 because that's the total length of our calldata (4 + 32 * 2)
-                        0,
+                // Counterintuitively, this call() must be positioned after the or() in the
-                        0x10,
+                // surrounding and() because and() evaluates its arguments from right to left.
-                        0x44,
+                call(gas(), token, 0, 0, 68, 0, 32)
-                        0x00,
+            )
-                        0x20
+
-                    )
+            mstore(0x60, 0) // Restore the zero slot to zero.
-                )
+            mstore(0x40, memPointer) // Restore the memPointer.
-            ) {
-                // Store the function selector of `TransferFailed()`.
-                mstore(0x00, 0x90b8ec18)
-                // Revert with (offset, size).
-                revert(0x1c, 0x04)
-            }
-            // Restore the part of the free memory pointer that was overwritten.
-            mstore(0x34, 0)
         }
+
+        require(success, "TRANSFER_FAILED");
     }
 }

deploys/localhost.json

@@ -3,6 +3,6 @@
     "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
     "0x70997970C51812dc3A010C7d01b50e0d17dc79C8"
   ],
-  "p2pix": "",
+  "p2pix": "0xC86042E9F2977C62Da8c9dDF7F9c40fde4796A29",
-  "token": ""
+  "token": "0xD38D6367f452D097ccBfDe4490b7de570B6A72Db"
 }

deploys/old/rsktestnet.json

@@ -1,9 +0,0 @@
-{
-  "signers": [
-    "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
-    "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
-    "0x8963E134E6d22Ee9A26ac62a99964aB391ead816"
-  ],
-  "token": "0xfE841c74250e57640390f46d914C88d22C51e82e",
-  "p2pix": "0x57Dcba05980761169508886eEdc6f5E7EC0411Dc"
-}

deploys/old/sepolia.json

@@ -1,8 +0,0 @@
-{
-  "signers": [
-    "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
-    "0x70997970C51812dc3A010C7d01b50e0d17dc79C8"
-  ],
-  "p2pix": "0xb7cD135F5eFD9760981e02E2a898790b688939fe",
-  "token": "0x3eBE67A2C7bdB2081CBd34ba3281E90377462289"
-}

docs/DataTypes.md

@@ -0,0 +1 @@
+# DataTypes

docs/EventAndErrors.md

@@ -0,0 +1,264 @@
+# EventAndErrors
+
+## Events
+
+### AllowedERC20Updated
+
+```solidity
+event AllowedERC20Updated(address indexed token, bool indexed state)
+```
+
+#### Parameters
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| token `indexed` | address | undefined   |
+| state `indexed` | bool    | undefined   |
+
+### DepositAdded
+
+```solidity
+event DepositAdded(address indexed seller, uint256 depositID, address token, uint256 amount)
+```
+
+███ Events ████████████████████████████████████████████████████████████
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| seller `indexed` | address | undefined   |
+| depositID        | uint256 | undefined   |
+| token            | address | undefined   |
+| amount           | uint256 | undefined   |
+
+### DepositClosed
+
+```solidity
+event DepositClosed(address indexed seller, uint256 depositID)
+```
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| seller `indexed` | address | undefined   |
+| depositID        | uint256 | undefined   |
+
+### DepositWithdrawn
+
+```solidity
+event DepositWithdrawn(address indexed seller, uint256 depositID, uint256 amount)
+```
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| seller `indexed` | address | undefined   |
+| depositID        | uint256 | undefined   |
+| amount           | uint256 | undefined   |
+
+### FundsWithdrawn
+
+```solidity
+event FundsWithdrawn(address owner, uint256 amount)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| owner  | address | undefined   |
+| amount | uint256 | undefined   |
+
+### LockAdded
+
+```solidity
+event LockAdded(address indexed buyer, bytes32 indexed lockID, uint256 depositID, uint256 amount)
+```
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| buyer `indexed`  | address | undefined   |
+| lockID `indexed` | bytes32 | undefined   |
+| depositID        | uint256 | undefined   |
+| amount           | uint256 | undefined   |
+
+### LockBlocksUpdated
+
+```solidity
+event LockBlocksUpdated(uint256 blocks)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| blocks | uint256 | undefined   |
+
+### LockReleased
+
+```solidity
+event LockReleased(address indexed buyer, bytes32 lockId)
+```
+
+#### Parameters
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| buyer `indexed` | address | undefined   |
+| lockId          | bytes32 | undefined   |
+
+### LockReturned
+
+```solidity
+event LockReturned(address indexed buyer, bytes32 lockId)
+```
+
+#### Parameters
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| buyer `indexed` | address | undefined   |
+| lockId          | bytes32 | undefined   |
+
+### ReputationUpdated
+
+```solidity
+event ReputationUpdated(address reputation)
+```
+
+#### Parameters
+
+| Name       | Type    | Description |
+| ---------- | ------- | ----------- |
+| reputation | address | undefined   |
+
+### ValidSignersUpdated
+
+```solidity
+event ValidSignersUpdated(address[] signers)
+```
+
+#### Parameters
+
+| Name    | Type      | Description |
+| ------- | --------- | ----------- |
+| signers | address[] | undefined   |
+
+## Errors
+
+### AddressDenied
+
+```solidity
+error AddressDenied()
+```
+
+_Address doesn't exist in a MerkleTree.Address not allowed as relayer.0x3b8474be_
+
+### AlreadyReleased
+
+```solidity
+error AlreadyReleased()
+```
+
+_Lock already released or returned.0x63b4904e_
+
+### AmountNotAllowed
+
+```solidity
+error AmountNotAllowed()
+```
+
+_Wished amount to be locked exceeds the limit allowed.0x1c18f846_
+
+### DepositAlreadyExists
+
+```solidity
+error DepositAlreadyExists()
+```
+
+_Deposit already exist and it is still valid.0xc44bd765_
+
+### InvalidDeposit
+
+```solidity
+error InvalidDeposit()
+```
+
+_Deposit not valid anymore.0xb2e532de_
+
+### InvalidSigner
+
+```solidity
+error InvalidSigner()
+```
+
+_Signer is not a valid signer.0x815e1d64_
+
+### LengthMismatch
+
+```solidity
+error LengthMismatch()
+```
+
+_Arrays' length don't match.0xff633a38_
+
+### LoopOverflow
+
+```solidity
+error LoopOverflow()
+```
+
+_Loop bounds have overflowed.0xdfb035c9_
+
+### NoTokens
+
+```solidity
+error NoTokens()
+```
+
+_No tokens array provided as argument.0xdf957883_
+
+### NotEnoughTokens
+
+```solidity
+error NotEnoughTokens()
+```
+
+_Not enough token remaining on deposit.0x22bbb43c_
+
+### NotExpired
+
+```solidity
+error NotExpired()
+```
+
+_Lock not expired or already released.Another lock with same ID is not expired yet.0xd0404f85_
+
+### OnlySeller
+
+```solidity
+error OnlySeller()
+```
+
+_Only seller could call this function.`msg.sender` and the seller differ.0x85d1f726_
+
+### TokenDenied
+
+```solidity
+error TokenDenied()
+```
+
+_Token address not allowed to be deposited.0x1578328e_
+
+### TxAlreadyUsed
+
+```solidity
+error TxAlreadyUsed()
+```
+
+_Transaction already used to unlock payment.0xf490a6ea_

docs/P2PIX.md

@@ -0,0 +1,694 @@
+# P2PIX
+
+## Methods
+
+### \_castAddrToKey
+
+```solidity
+function _castAddrToKey(address _addr) external pure returns (uint256 _key)
+```
+
+Public method that handles `address` to `uint256` safe type casting.
+
+_Function sighash: 0x4b2ae980._
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| \_addr | address | undefined   |
+
+#### Returns
+
+| Name  | Type    | Description |
+| ----- | ------- | ----------- |
+| \_key | uint256 | undefined   |
+
+### allowedERC20s
+
+```solidity
+function allowedERC20s(contract ERC20) external view returns (bool)
+```
+
+_Tokens allowed to serve as the underlying amount of a deposit._
+
+#### Parameters
+
+| Name | Type           | Description |
+| ---- | -------------- | ----------- |
+| \_0  | contract ERC20 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+### cancelDeposit
+
+```solidity
+function cancelDeposit(uint256 depositID) external nonpayable
+```
+
+Enables seller to invalidate future locks made to his/her token offering order.
+
+_This function does not affect any ongoing active locks.Function sighash: 0x72fada5c._
+
+#### Parameters
+
+| Name      | Type    | Description |
+| --------- | ------- | ----------- |
+| depositID | uint256 | undefined   |
+
+### defaultLockBlocks
+
+```solidity
+function defaultLockBlocks() external view returns (uint256)
+```
+
+_Default blocks that lock will hold tokens._
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### deposit
+
+```solidity
+function deposit(address _token, uint256 _amount, string _pixTarget, bytes32 allowlistRoot) external nonpayable returns (uint256 depositID)
+```
+
+Creates a deposit order based on a seller's offer of an amount of ERC20 tokens.
+
+_Seller needs to send his tokens to the P2PIX smart contract.Function sighash: 0xbfe07da6._
+
+#### Parameters
+
+| Name          | Type    | Description                                             |
+| ------------- | ------- | ------------------------------------------------------- |
+| \_token       | address | undefined                                               |
+| \_amount      | uint256 | undefined                                               |
+| \_pixTarget   | string  | Pix key destination provided by the offer's seller. |
+| allowlistRoot | bytes32 | Optional allow list merkleRoot update `bytes32` value.  |
+
+#### Returns
+
+| Name      | Type    | Description                                                    |
+| --------- | ------- | -------------------------------------------------------------- |
+| depositID | uint256 | The `uint256` return value provided as the deposit identifier. |
+
+### depositCount
+
+```solidity
+function depositCount() external view returns (uint256 _val)
+```
+
+#### Returns
+
+| Name  | Type    | Description |
+| ----- | ------- | ----------- |
+| \_val | uint256 | undefined   |
+
+### lock
+
+```solidity
+function lock(uint256 _depositID, address _buyerAddress, address _relayerTarget, uint256 _relayerPremium, uint256 _amount, bytes32[] merkleProof, bytes32[] expiredLocks) external nonpayable returns (bytes32 lockID)
+```
+
+Public method designed to lock an remaining amount of the deposit order of a seller.
+
+_This method can be performed either by: - An user allowed via the seller's allowlist; - An user with enough userRecord to lock the wished amount; There can only exist a lock per each `_amount` partitioned from the total `remaining` value.Locks can only be performed in valid orders.Function sighash: 0x03aaf306._
+
+#### Parameters
+
+| Name             | Type      | Description                                                                                                              |
+| ---------------- | --------- | ------------------------------------------------------------------------------------------------------------------------ |
+| \_depositID      | uint256   | undefined                                                                                                                |
+| \_buyerAddress   | address   | The address of the buyer of a `_depositID`.                                                                              |
+| \_relayerTarget  | address   | Target address entitled to the `relayerPremim`.                                                                          |
+| \_relayerPremium | uint256   | The refund/premium owed to a relayer.                                                                                    |
+| \_amount         | uint256   | The deposit's remaining amount wished to be locked.                                                                  |
+| merkleProof      | bytes32[] | This value should be: - Provided as a pass if the `msg.sender` is in the seller's allowlist; - Left empty otherwise; |
+| expiredLocks     | bytes32[] | An array of `bytes32` identifiers to be provided so to unexpire locks using this transaction gas push.                   |
+
+#### Returns
+
+| Name   | Type    | Description                                          |
+| ------ | ------- | ---------------------------------------------------- |
+| lockID | bytes32 | The `bytes32` value returned as the lock identifier. |
+
+### mapDeposits
+
+```solidity
+function mapDeposits(uint256) external view returns (uint256 remaining, string pixTarget, address seller, address token, bool valid)
+```
+
+_Seller list of deposits_
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+#### Returns
+
+| Name      | Type    | Description |
+| --------- | ------- | ----------- |
+| remaining | uint256 | undefined   |
+| pixTarget | string  | undefined   |
+| seller    | address | undefined   |
+| token     | address | undefined   |
+| valid     | bool    | undefined   |
+
+### mapLocks
+
+```solidity
+function mapLocks(bytes32) external view returns (uint256 depositID, uint256 relayerPremium, uint256 amount, uint256 expirationBlock, address buyerAddress, address relayerTarget, address relayerAddress)
+```
+
+_List of Locks._
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | bytes32 | undefined   |
+
+#### Returns
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| depositID       | uint256 | undefined   |
+| relayerPremium  | uint256 | undefined   |
+| amount          | uint256 | undefined   |
+| expirationBlock | uint256 | undefined   |
+| buyerAddress    | address | undefined   |
+| relayerTarget   | address | undefined   |
+| relayerAddress  | address | undefined   |
+
+### owner
+
+```solidity
+function owner() external view returns (address)
+```
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+
+### release
+
+```solidity
+function release(bytes32 lockID, address _relayerTarget, uint256 pixTimestamp, bytes32 r, bytes32 s, uint8 v) external nonpayable
+```
+
+Lock release method that liquidate lock orders and distributes relayer fees.
+
+_This method can be called by any public actor as long the signature provided is valid.`relayerPremium` gets splitted equaly if `relayerTarget` addresses differ.If the `msg.sender` of this method and `l.relayerAddress` are the same, `msg.sender` accrues both l.amount and l.relayerPremium as userRecord credit. In case of they differing: - `lock` caller gets accrued with `l.amount` as userRecord credit; - `release` caller gets accrued with `l.relayerPremium` as userRecord credit; Function sighash: 0x4e1389ed._
+
+#### Parameters
+
+| Name            | Type    | Description                                     |
+| --------------- | ------- | ----------------------------------------------- |
+| lockID          | bytes32 | undefined                                       |
+| \_relayerTarget | address | Target address entitled to the `relayerPremim`. |
+| pixTimestamp    | uint256 | undefined                                       |
+| r               | bytes32 | undefined                                       |
+| s               | bytes32 | undefined                                       |
+| v               | uint8   | undefined                                       |
+
+### reputation
+
+```solidity
+function reputation() external view returns (contract IReputation)
+```
+
+███ Storage ████████████████████████████████████████████████████████████
+
+#### Returns
+
+| Name | Type                 | Description |
+| ---- | -------------------- | ----------- |
+| \_0  | contract IReputation | undefined   |
+
+### sellerAllowList
+
+```solidity
+function sellerAllowList(uint256) external view returns (bytes32)
+```
+
+_Seller casted to key => Seller's allowlist merkleroot._
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | bytes32 | undefined   |
+
+### setDefaultLockBlocks
+
+```solidity
+function setDefaultLockBlocks(uint256 _blocks) external nonpayable
+```
+
+#### Parameters
+
+| Name     | Type    | Description |
+| -------- | ------- | ----------- |
+| \_blocks | uint256 | undefined   |
+
+### setOwner
+
+```solidity
+function setOwner(address newOwner) external nonpayable
+```
+
+#### Parameters
+
+| Name     | Type    | Description |
+| -------- | ------- | ----------- |
+| newOwner | address | undefined   |
+
+### setReputation
+
+```solidity
+function setReputation(contract IReputation _reputation) external nonpayable
+```
+
+#### Parameters
+
+| Name         | Type                 | Description |
+| ------------ | -------------------- | ----------- |
+| \_reputation | contract IReputation | undefined   |
+
+### setRoot
+
+```solidity
+function setRoot(address addr, bytes32 merkleroot) external nonpayable
+```
+
+#### Parameters
+
+| Name       | Type    | Description |
+| ---------- | ------- | ----------- |
+| addr       | address | undefined   |
+| merkleroot | bytes32 | undefined   |
+
+### setValidSigners
+
+```solidity
+function setValidSigners(address[] _validSigners) external nonpayable
+```
+
+#### Parameters
+
+| Name           | Type      | Description |
+| -------------- | --------- | ----------- |
+| \_validSigners | address[] | undefined   |
+
+### tokenSettings
+
+```solidity
+function tokenSettings(address[] _tokens, bool[] _states) external nonpayable
+```
+
+#### Parameters
+
+| Name     | Type      | Description |
+| -------- | --------- | ----------- |
+| \_tokens | address[] | undefined   |
+| \_states | bool[]    | undefined   |
+
+### unlockExpired
+
+```solidity
+function unlockExpired(bytes32[] lockIDs) external nonpayable
+```
+
+Unlocks expired locks.
+
+_Triggered in the callgraph by both `lock` and `withdraw` functions.This method can also have any public actor as its `tx.origin`.For each successfull unexpired lock recovered, `userRecord[_castAddrToKey(l.relayerAddress)]` is decreased by half of its value.Function sighash: 0x8e2749d6._
+
+#### Parameters
+
+| Name    | Type      | Description |
+| ------- | --------- | ----------- |
+| lockIDs | bytes32[] | undefined   |
+
+### userRecord
+
+```solidity
+function userRecord(uint256) external view returns (uint256)
+```
+
+_Stores an relayer's last computed credit._
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### validBacenSigners
+
+```solidity
+function validBacenSigners(uint256) external view returns (bool)
+```
+
+_List of valid Bacen signature addresses_
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+### withdraw
+
+```solidity
+function withdraw(uint256 depositID, bytes32[] expiredLocks) external nonpayable
+```
+
+Seller's expired deposit fund sweeper.
+
+_A seller may use this method to recover tokens from expired deposits.Function sighash: 0x36317972._
+
+#### Parameters
+
+| Name         | Type      | Description |
+| ------------ | --------- | ----------- |
+| depositID    | uint256   | undefined   |
+| expiredLocks | bytes32[] | undefined   |
+
+### withdrawBalance
+
+```solidity
+function withdrawBalance() external nonpayable
+```
+
+_Contract's underlying balance withdraw method.Function sighash: 0x5fd8c710._
+
+## Events
+
+### AllowedERC20Updated
+
+```solidity
+event AllowedERC20Updated(address indexed token, bool indexed state)
+```
+
+#### Parameters
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| token `indexed` | address | undefined   |
+| state `indexed` | bool    | undefined   |
+
+### DepositAdded
+
+```solidity
+event DepositAdded(address indexed seller, uint256 depositID, address token, uint256 amount)
+```
+
+███ Events ████████████████████████████████████████████████████████████
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| seller `indexed` | address | undefined   |
+| depositID        | uint256 | undefined   |
+| token            | address | undefined   |
+| amount           | uint256 | undefined   |
+
+### DepositClosed
+
+```solidity
+event DepositClosed(address indexed seller, uint256 depositID)
+```
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| seller `indexed` | address | undefined   |
+| depositID        | uint256 | undefined   |
+
+### DepositWithdrawn
+
+```solidity
+event DepositWithdrawn(address indexed seller, uint256 depositID, uint256 amount)
+```
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| seller `indexed` | address | undefined   |
+| depositID        | uint256 | undefined   |
+| amount           | uint256 | undefined   |
+
+### FundsWithdrawn
+
+```solidity
+event FundsWithdrawn(address owner, uint256 amount)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| owner  | address | undefined   |
+| amount | uint256 | undefined   |
+
+### LockAdded
+
+```solidity
+event LockAdded(address indexed buyer, bytes32 indexed lockID, uint256 depositID, uint256 amount)
+```
+
+#### Parameters
+
+| Name             | Type    | Description |
+| ---------------- | ------- | ----------- |
+| buyer `indexed`  | address | undefined   |
+| lockID `indexed` | bytes32 | undefined   |
+| depositID        | uint256 | undefined   |
+| amount           | uint256 | undefined   |
+
+### LockBlocksUpdated
+
+```solidity
+event LockBlocksUpdated(uint256 blocks)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| blocks | uint256 | undefined   |
+
+### LockReleased
+
+```solidity
+event LockReleased(address indexed buyer, bytes32 lockId)
+```
+
+#### Parameters
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| buyer `indexed` | address | undefined   |
+| lockId          | bytes32 | undefined   |
+
+### LockReturned
+
+```solidity
+event LockReturned(address indexed buyer, bytes32 lockId)
+```
+
+#### Parameters
+
+| Name            | Type    | Description |
+| --------------- | ------- | ----------- |
+| buyer `indexed` | address | undefined   |
+| lockId          | bytes32 | undefined   |
+
+### OwnerUpdated
+
+```solidity
+event OwnerUpdated(address indexed user, address indexed newOwner)
+```
+
+#### Parameters
+
+| Name               | Type    | Description |
+| ------------------ | ------- | ----------- |
+| user `indexed`     | address | undefined   |
+| newOwner `indexed` | address | undefined   |
+
+### ReputationUpdated
+
+```solidity
+event ReputationUpdated(address reputation)
+```
+
+#### Parameters
+
+| Name       | Type    | Description |
+| ---------- | ------- | ----------- |
+| reputation | address | undefined   |
+
+### ValidSignersUpdated
+
+```solidity
+event ValidSignersUpdated(address[] signers)
+```
+
+#### Parameters
+
+| Name    | Type      | Description |
+| ------- | --------- | ----------- |
+| signers | address[] | undefined   |
+
+## Errors
+
+### AddressDenied
+
+```solidity
+error AddressDenied()
+```
+
+_Address doesn't exist in a MerkleTree.Address not allowed as relayer.0x3b8474be_
+
+### AlreadyReleased
+
+```solidity
+error AlreadyReleased()
+```
+
+_Lock already released or returned.0x63b4904e_
+
+### AmountNotAllowed
+
+```solidity
+error AmountNotAllowed()
+```
+
+_Wished amount to be locked exceeds the limit allowed.0x1c18f846_
+
+### DepositAlreadyExists
+
+```solidity
+error DepositAlreadyExists()
+```
+
+_Deposit already exist and it is still valid.0xc44bd765_
+
+### InvalidDeposit
+
+```solidity
+error InvalidDeposit()
+```
+
+_Deposit not valid anymore.0xb2e532de_
+
+### InvalidSigner
+
+```solidity
+error InvalidSigner()
+```
+
+_Signer is not a valid signer.0x815e1d64_
+
+### LengthMismatch
+
+```solidity
+error LengthMismatch()
+```
+
+_Arrays' length don't match.0xff633a38_
+
+### LoopOverflow
+
+```solidity
+error LoopOverflow()
+```
+
+_Loop bounds have overflowed.0xdfb035c9_
+
+### NoTokens
+
+```solidity
+error NoTokens()
+```
+
+_No tokens array provided as argument.0xdf957883_
+
+### NotEnoughTokens
+
+```solidity
+error NotEnoughTokens()
+```
+
+_Not enough token remaining on deposit.0x22bbb43c_
+
+### NotExpired
+
+```solidity
+error NotExpired()
+```
+
+_Lock not expired or already released.Another lock with same ID is not expired yet.0xd0404f85_
+
+### OnlySeller
+
+```solidity
+error OnlySeller()
+```
+
+_Only seller could call this function.`msg.sender` and the seller differ.0x85d1f726_
+
+### Reentrancy
+
+```solidity
+error Reentrancy()
+```
+
+### TokenDenied
+
+```solidity
+error TokenDenied()
+```
+
+_Token address not allowed to be deposited.0x1578328e_
+
+### TxAlreadyUsed
+
+```solidity
+error TxAlreadyUsed()
+```
+
+_Transaction already used to unlock payment.0xf490a6ea_

docs/Reputation.md

@@ -1,28 +1,6 @@
-# Solidity API
+# Reputation
 
-## Reputation
+## Methods
-
-### maxLimit
-
-```solidity
-uint256 maxLimit
-```
-
-_Asymptote numerator constant value for the `limiter` fx._
-
-### magicValue
-
-```solidity
-uint256 magicValue
-```
-
-_Denominator's constant operand for the `limiter` fx._
-
-### constructor
-
-```solidity
-constructor() public payable
-```
 
 ### limiter
 
@@ -30,12 +8,81 @@ constructor() public payable
 function limiter(uint256 _userCredit) external pure returns (uint256 _spendLimit)
 ```
 
-### sqrt
+#### Parameters
+
+| Name         | Type    | Description |
+| ------------ | ------- | ----------- |
+| \_userCredit | uint256 | undefined   |
+
+#### Returns
+
+| Name         | Type    | Description |
+| ------------ | ------- | ----------- |
+| \_spendLimit | uint256 | undefined   |
+
+### magicValue
 
 ```solidity
-function sqrt(uint256 x) internal pure returns (uint256 z)
+function magicValue() external view returns (uint256)
 ```
 
-Taken from Solmate's FixedPointMathLib.
+_Denominator's constant operand for the `limiter` fx. _
-(https://github.com/transmissions11/solmate/blob/main/src/utils/FixedPointMathLib.sol)
 
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### maxLimit
+
+```solidity
+function maxLimit() external view returns (uint256)
+```
+
+_Asymptote numerator constant value for the `limiter` fx._
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### owner
+
+```solidity
+function owner() external view returns (address)
+```
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+
+### setOwner
+
+```solidity
+function setOwner(address newOwner) external nonpayable
+```
+
+#### Parameters
+
+| Name     | Type    | Description |
+| -------- | ------- | ----------- |
+| newOwner | address | undefined   |
+
+## Events
+
+### OwnerUpdated
+
+```solidity
+event OwnerUpdated(address indexed user, address indexed newOwner)
+```
+
+#### Parameters
+
+| Name               | Type    | Description |
+| ------------------ | ------- | ----------- |
+| user `indexed`     | address | undefined   |
+| newOwner `indexed` | address | undefined   |

docs/core/BaseUtils.md

@@ -1,89 +0,0 @@
-# Solidity API
-
-## BaseUtils
-
-### _setUsedTransactions
-
-```solidity
-function _setUsedTransactions(bytes32 message) internal
-```
-
-███ Helper FX ██████████████████████████████████████████████████████████
-
-### usedTransactions
-
-```solidity
-function usedTransactions(bytes32 message) public view returns (bool used)
-```
-
-### _signerCheck
-
-```solidity
-function _signerCheck(bytes32 _message, bytes _signature) internal view
-```
-
-### _merkleVerify
-
-```solidity
-function _merkleVerify(bytes32[] _merkleProof, bytes32 _root, address _addr) internal pure
-```
-
-### _castBool
-
-```solidity
-function _castBool(bool _valid) internal pure returns (uint256 _validCasted)
-```
-
-### getStr
-
-```solidity
-function getStr(string str) public pure returns (bytes32 strEnc)
-```
-
-### _setSellerBalance
-
-```solidity
-function _setSellerBalance(address _sellerKey, contract ERC20 _erc20, uint256 _packed, bytes32 _pixTarget) internal
-```
-
-### _setValidState
-
-```solidity
-function _setValidState(address _sellerKey, contract ERC20 _erc20, uint256 _packed) internal
-```
-
-### _addSellerBalance
-
-```solidity
-function _addSellerBalance(address _sellerKey, contract ERC20 _erc20, uint256 _amount) internal
-```
-
-### _decSellerBalance
-
-```solidity
-function _decSellerBalance(address _sellerKey, contract ERC20 _erc20, uint256 _amount) internal
-```
-
-### __sellerBalance
-
-```solidity
-function __sellerBalance(address _sellerKey, contract ERC20 _erc20) internal view returns (uint256 _packed)
-```
-
-### _castAddrToKey
-
-```solidity
-function _castAddrToKey(address _addr) public pure returns (uint256 _key)
-```
-
-Public method that handles `address`
-to `uint256` safe type casting.
-
-_Function sighash: 0x4b2ae980._
-
-### _castKeyToAddr
-
-```solidity
-function _castKeyToAddr(uint256 _key) public pure returns (address _addr)
-```
-

docs/core/Constants.md

@@ -1,96 +0,0 @@
-# Solidity API
-
-## Constants
-
-### _ROOT_UPDATED_EVENT_SIGNATURE
-
-```solidity
-uint256 _ROOT_UPDATED_EVENT_SIGNATURE
-```
-
-███ Constants ██████████████████████████████████████████████████████████
-
-### _ALLOWED_ERC20_UPDATED_EVENT_SIGNATURE
-
-```solidity
-uint256 _ALLOWED_ERC20_UPDATED_EVENT_SIGNATURE
-```
-
-### _TRUSTED_FORWARDER_UPDATED_EVENT_SIGNATURE
-
-```solidity
-uint256 _TRUSTED_FORWARDER_UPDATED_EVENT_SIGNATURE
-```
-
-### _SELLER_ALLOWLIST_SLOT_SEED
-
-```solidity
-uint256 _SELLER_ALLOWLIST_SLOT_SEED
-```
-
-_Seller casted to key => Seller's allowlist merkleroot.
-mapping(uint256 => bytes32) public sellerAllowList;_
-
-### _ALLOWED_ERC20_SLOT_SEED
-
-```solidity
-uint256 _ALLOWED_ERC20_SLOT_SEED
-```
-
-_Tokens allowed to serve as the underlying amount of a deposit.
-mapping(ERC20 => bool) public allowedERC20s;_
-
-### _SELLER_BALANCE_SLOT_SEED
-
-```solidity
-uint256 _SELLER_BALANCE_SLOT_SEED
-```
-
-_Value in custom storage slot given by:
-    mstore(0x20, token)
-    mstore(0x0c, _SELLER_BALANCE_SLOT_SEED)
-    mstore(0x00, seller)
-    let value := sload(keccak256(0x0c, 0x34))._
-
-### BITMASK_SB_ENTRY
-
-```solidity
-uint256 BITMASK_SB_ENTRY
-```
-
-_The bitmask of `sellerBalance` entry._
-
-### BITPOS_VALID
-
-```solidity
-uint256 BITPOS_VALID
-```
-
-_The bit position of `valid` in `sellerBalance`._
-
-### WAD
-
-```solidity
-uint256 WAD
-```
-
-_The scalar of BRZ token._
-
-### MAXBALANCE_UPPERBOUND
-
-```solidity
-uint256 MAXBALANCE_UPPERBOUND
-```
-
-### REPUTATION_LOWERBOUND
-
-```solidity
-uint256 REPUTATION_LOWERBOUND
-```
-
-### LOCKAMOUNT_UPPERBOUND
-
-```solidity
-uint256 LOCKAMOUNT_UPPERBOUND
-```
-

docs/core/DataTypes.md

@@ -1,29 +0,0 @@
-# Solidity API
-
-## DataTypes
-
-### Lock
-
-```solidity
-struct Lock {
-  uint256 counter;
-  uint256 expirationBlock;
-  bytes32 pixTarget;
-  uint80 amount;
-  contract ERC20 token;
-  address buyerAddress;
-  address seller;
-}
-```
-
-### LockStatus
-
-```solidity
-enum LockStatus {
-  Inexistent,
-  Active,
-  Expired,
-  Released
-}
-```
-

docs/core/EventAndErrors.md

@@ -1,278 +0,0 @@
-# Solidity API
-
-## EventAndErrors
-
-### DepositAdded
-
-```solidity
-event DepositAdded(address seller, contract ERC20 token, uint256 amount)
-```
-
-_0x63d8d7d5e63e9840ec91a12a160d27b7cfab294f6ba070b7359692acfe6b03bf_
-
-### ValidSet
-
-```solidity
-event ValidSet(address seller, contract ERC20 token, bool state)
-```
-
-_0xca585721b6b442dc9183932f7c84dc2880efb67c4da52cc06873e78971105d49_
-
-### DepositWithdrawn
-
-```solidity
-event DepositWithdrawn(address seller, contract ERC20 token, uint256 amount)
-```
-
-_0x2cd6435b1b961c13f55202979edd0765a809f69a539d8a477436c94c1211e43e_
-
-### LockAdded
-
-```solidity
-event LockAdded(address buyer, uint256 lockID, address seller, uint256 amount)
-```
-
-_0x8fb3989f70bd172a37d15b41b015e48ea09d59329638377304a4198cd0c4ea65_
-
-### LockReleased
-
-```solidity
-event LockReleased(address buyer, uint256 lockId, uint256 amount)
-```
-
-_0x364537f14276f2a0ce9905588413f96454cbb8fb2e4f5308389307c1098bede8_
-
-### LockReturned
-
-```solidity
-event LockReturned(address buyer, uint256 lockId)
-```
-
-_0x830501e61b8b075e170b22a430e39454bdb12ed3e9620e586430b6ac00079da5_
-
-### FundsWithdrawn
-
-```solidity
-event FundsWithdrawn(address owner, uint256 amount)
-```
-
-_0xeaff4b37086828766ad3268786972c0cd24259d4c87a80f9d3963a3c3d999b0d_
-
-### RootUpdated
-
-```solidity
-event RootUpdated(address seller, bytes32 merkleRoot)
-```
-
-_0x0b294da292f26e55fd442b5c0164fbb9013036ff00c5cfdde0efd01c1baaf632_
-
-### AllowedERC20Updated
-
-```solidity
-event AllowedERC20Updated(address token, bool state)
-```
-
-_0x5d6e86e5341d57a92c49934296c51542a25015c9b1782a1c2722a940131c3d9a_
-
-### TrustedForwarderUpdated
-
-```solidity
-event TrustedForwarderUpdated(address forwarder, bool state)
-```
-
-_0xbee55516e29d3969d3cb8eb01351eb3c52d06f9e2435bd5a8bfe3647e185df92_
-
-### ReputationUpdated
-
-```solidity
-event ReputationUpdated(address reputation)
-```
-
-_0xe127cf589a3879da0156d4a24f43b44f65cfa3570de594806b0bfa2fcf06884f_
-
-### LockBlocksUpdated
-
-```solidity
-event LockBlocksUpdated(uint256 blocks)
-```
-
-_0x70fa43ca70216ad905ade86b9e650a691b2ce5a01980d0a81bdd8324141b8511_
-
-### ValidSignersUpdated
-
-```solidity
-event ValidSignersUpdated(address[] signers)
-```
-
-_0x14a422d2412784a5749d03da98921fe468c98577b767851389a9f58ea5a363d7_
-
-### OnlySeller
-
-```solidity
-error OnlySeller()
-```
-
-_Only seller could call this function.
-`msg.sender` and the seller differ.
-0x85d1f726_
-
-### NotExpired
-
-```solidity
-error NotExpired()
-```
-
-_Lock not expired or already released.
-Another lock with same ID is not expired yet.
-0xd0404f85_
-
-### LoopOverflow
-
-```solidity
-error LoopOverflow()
-```
-
-_Loop bounds have overflowed.
-0xdfb035c9_
-
-### InvalidDeposit
-
-```solidity
-error InvalidDeposit()
-```
-
-_Deposit not valid anymore.
-0xb2e532de_
-
-### NotEnoughTokens
-
-```solidity
-error NotEnoughTokens()
-```
-
-_Not enough token remaining on deposit.
-0x22bbb43c_
-
-### AlreadyReleased
-
-```solidity
-error AlreadyReleased()
-```
-
-_Lock already released or returned.
-0x63b4904e_
-
-### TxAlreadyUsed
-
-```solidity
-error TxAlreadyUsed()
-```
-
-_Transaction already used to unlock payment.
-0xf490a6ea_
-
-### InvalidSigner
-
-```solidity
-error InvalidSigner()
-```
-
-_Signer is not a valid signer.
-0x815e1d64_
-
-### AddressDenied
-
-```solidity
-error AddressDenied()
-```
-
-_Address doesn't exist in a MerkleTree.
-Address not allowed as relayer.
-0x3b8474be_
-
-### LengthMismatch
-
-```solidity
-error LengthMismatch()
-```
-
-_Arrays' length don't match.
-0xff633a38_
-
-### NoTokens
-
-```solidity
-error NoTokens()
-```
-
-_No tokens array provided as argument.
-0xdf957883_
-
-### TokenDenied
-
-```solidity
-error TokenDenied()
-```
-
-_Token address not allowed to be deposited.
-0x1578328e_
-
-### AmountNotAllowed
-
-```solidity
-error AmountNotAllowed()
-```
-
-_Wished amount to be locked exceeds the limit allowed.
-0x1c18f846_
-
-### StaticCallFailed
-
-```solidity
-error StaticCallFailed()
-```
-
-_Reverts when success return value returns false.
-0xe10bf1cc_
-
-### LockExpired
-
-```solidity
-error LockExpired()
-```
-
-_Reverts on an expired lock.
-0xf6fafba0_
-
-### DecOverflow
-
-```solidity
-error DecOverflow()
-```
-
-_0xce3a3d37_
-
-### MaxBalExceeded
-
-```solidity
-error MaxBalExceeded()
-```
-
-_0xf3fb0eb9_
-
-### EmptyPixTarget
-
-```solidity
-error EmptyPixTarget()
-```
-
-_0x6a3bc53e_
-
-### NotInitialized
-
-```solidity
-error NotInitialized()
-```
-
-_0x87138d5c_
-

docs/core/OwnerSettings.md

@@ -1,98 +0,0 @@
-# Solidity API
-
-## OwnerSettings
-
-### reputation
-
-```solidity
-contract IReputation reputation
-```
-
-_List of valid Bacen signature addresses
-    mapping(uint256 => bool) public validBacenSigners;
-Value in custom storage slot given by:
-    let value := sload(shl(12, address))._
-
-### defaultLockBlocks
-
-```solidity
-uint256 defaultLockBlocks
-```
-
-_Default blocks that lock will hold tokens._
-
-### constructor
-
-```solidity
-constructor(uint256 defaultBlocks, address[] validSigners, address _reputation, contract ERC20[] tokens, bool[] tokenStates) internal
-```
-
-███ Constructor ████████████████████████████████████████████████████████
-
-### setTrustedFowarders
-
-```solidity
-function setTrustedFowarders(address[] forwarders, bool[] states) external
-```
-
-███ Owner Only █████████████████████████████████████████████████████████
-
-### withdrawBalance
-
-```solidity
-function withdrawBalance() external
-```
-
-_Contract's underlying balance withdraw method.
-Function sighash: 0x5fd8c710._
-
-### setReputation
-
-```solidity
-function setReputation(contract IReputation _reputation) public
-```
-
-### setDefaultLockBlocks
-
-```solidity
-function setDefaultLockBlocks(uint256 _blocks) public
-```
-
-### setValidSigners
-
-```solidity
-function setValidSigners(address[] _validSigners) public
-```
-
-### tokenSettings
-
-```solidity
-function tokenSettings(contract ERC20[] _tokens, bool[] _states) public
-```
-
-### validBacenSigners
-
-```solidity
-function validBacenSigners(uint256 signer) public view returns (bool valid)
-```
-
-███ View FX ████████████████████████████████████████████████████████████
-
-### sellerAllowList
-
-```solidity
-function sellerAllowList(address sellerKey) public view returns (bytes32 root)
-```
-
-### allowedERC20s
-
-```solidity
-function allowedERC20s(contract ERC20 erc20) public view returns (bool state)
-```
-
-### _limiter
-
-```solidity
-function _limiter(uint256 _userCredit) internal view returns (uint256 _spendLimit)
-```
-

docs/lib/auth/Owned.md

@@ -1,42 +1,46 @@
-# Solidity API
+# Owned
 
-## Owned
+_Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/auth/Owned.sol)_
 
 Simple single owner authorization mixin.
 
-### Unauthorized
+## Methods
-
-```solidity
-error Unauthorized()
-```
-
-### OwnerUpdated
-
-```solidity
-event OwnerUpdated(address user, address newOwner)
-```
 
 ### owner
 
 ```solidity
-address owner
+function owner() external view returns (address)
 ```
 
-### onlyOwner
+#### Returns
 
-```solidity
+| Name | Type    | Description |
-modifier onlyOwner()
+| ---- | ------- | ----------- |
-```
+| \_0  | address | undefined   |
-
-### constructor
-
-```solidity
-constructor(address _owner) internal
-```
 
 ### setOwner
 
 ```solidity
-function setOwner(address newOwner) public virtual
+function setOwner(address newOwner) external nonpayable
 ```
 
+#### Parameters
+
+| Name     | Type    | Description |
+| -------- | ------- | ----------- |
+| newOwner | address | undefined   |
+
+## Events
+
+### OwnerUpdated
+
+```solidity
+event OwnerUpdated(address indexed user, address indexed newOwner)
+```
+
+#### Parameters
+
+| Name               | Type    | Description |
+| ------------------ | ------- | ----------- |
+| user `indexed`     | address | undefined   |
+| newOwner `indexed` | address | undefined   |

docs/lib/interfaces/IReputation.md

@@ -1,6 +1,6 @@
-# Solidity API
+# IReputation
 
-## IReputation
+## Methods
 
 ### limiter
 
@@ -8,3 +8,14 @@
 function limiter(uint256 _userCredit) external pure returns (uint256 _spendLimit)
 ```
 
+#### Parameters
+
+| Name         | Type    | Description |
+| ------------ | ------- | ----------- |
+| \_userCredit | uint256 | undefined   |
+
+#### Returns
+
+| Name         | Type    | Description |
+| ------------ | ------- | ----------- |
+| \_spendLimit | uint256 | undefined   |

docs/lib/metatx/ERC2771Context.md

@@ -1,53 +0,0 @@
-# Solidity API
-
-## Context
-
-_Provides information about the current execution context, including the
-sender of the transaction and its data. While these are generally available
-via msg.sender and msg.data, they should not be accessed in such a direct
-manner, since when dealing with meta-transactions the account sending and
-paying for execution may not be the actual sender (as far as an application
-is concerned).
-
-This contract is only required for intermediate, library-like contracts._
-
-### _msgSender
-
-```solidity
-function _msgSender() internal view virtual returns (address)
-```
-
-### _msgData
-
-```solidity
-function _msgData() internal view virtual returns (bytes)
-```
-
-## ERC2771Context
-
-_Context variant with ERC2771 support._
-
-### trustedForwarders
-
-```solidity
-mapping(address => bool) trustedForwarders
-```
-
-### _msgSender
-
-```solidity
-function _msgSender() internal view virtual returns (address sender)
-```
-
-### isTrustedForwarder
-
-```solidity
-function isTrustedForwarder(address forwarder) public view virtual returns (bool)
-```
-
-### _msgData
-
-```solidity
-function _msgData() internal view virtual returns (bytes)
-```
-

docs/lib/mock/MockToken.md

@@ -0,0 +1,224 @@
+# MockToken
+
+## Methods
+
+### DOMAIN_SEPARATOR
+
+```solidity
+function DOMAIN_SEPARATOR() external view returns (bytes32)
+```
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | bytes32 | undefined   |
+
+### allowance
+
+```solidity
+function allowance(address, address) external view returns (uint256)
+```
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+| \_1  | address | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### approve
+
+```solidity
+function approve(address spender, uint256 amount) external nonpayable returns (bool)
+```
+
+#### Parameters
+
+| Name    | Type    | Description |
+| ------- | ------- | ----------- |
+| spender | address | undefined   |
+| amount  | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+### balanceOf
+
+```solidity
+function balanceOf(address) external view returns (uint256)
+```
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### decimals
+
+```solidity
+function decimals() external view returns (uint8)
+```
+
+#### Returns
+
+| Name | Type  | Description |
+| ---- | ----- | ----------- |
+| \_0  | uint8 | undefined   |
+
+### name
+
+```solidity
+function name() external view returns (string)
+```
+
+#### Returns
+
+| Name | Type   | Description |
+| ---- | ------ | ----------- |
+| \_0  | string | undefined   |
+
+### nonces
+
+```solidity
+function nonces(address) external view returns (uint256)
+```
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### permit
+
+```solidity
+function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) external nonpayable
+```
+
+#### Parameters
+
+| Name     | Type    | Description |
+| -------- | ------- | ----------- |
+| owner    | address | undefined   |
+| spender  | address | undefined   |
+| value    | uint256 | undefined   |
+| deadline | uint256 | undefined   |
+| v        | uint8   | undefined   |
+| r        | bytes32 | undefined   |
+| s        | bytes32 | undefined   |
+
+### symbol
+
+```solidity
+function symbol() external view returns (string)
+```
+
+#### Returns
+
+| Name | Type   | Description |
+| ---- | ------ | ----------- |
+| \_0  | string | undefined   |
+
+### totalSupply
+
+```solidity
+function totalSupply() external view returns (uint256)
+```
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### transfer
+
+```solidity
+function transfer(address to, uint256 amount) external nonpayable returns (bool)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| to     | address | undefined   |
+| amount | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+### transferFrom
+
+```solidity
+function transferFrom(address from, address to, uint256 amount) external nonpayable returns (bool)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| from   | address | undefined   |
+| to     | address | undefined   |
+| amount | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+## Events
+
+### Approval
+
+```solidity
+event Approval(address indexed owner, address indexed spender, uint256 amount)
+```
+
+#### Parameters
+
+| Name              | Type    | Description |
+| ----------------- | ------- | ----------- |
+| owner `indexed`   | address | undefined   |
+| spender `indexed` | address | undefined   |
+| amount            | uint256 | undefined   |
+
+### Transfer
+
+```solidity
+event Transfer(address indexed from, address indexed to, uint256 amount)
+```
+
+#### Parameters
+
+| Name           | Type    | Description |
+| -------------- | ------- | ----------- |
+| from `indexed` | address | undefined   |
+| to `indexed`   | address | undefined   |
+| amount         | uint256 | undefined   |

docs/lib/tokens/ERC20.md

@@ -1,128 +1,230 @@
-# Solidity API
+# ERC20
 
-## ERC20
+_Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/tokens/ERC20.sol)Modified from Uniswap (https://github.com/Uniswap/uniswap-v2-core/blob/master/contracts/UniswapV2ERC20.sol)_
 
 Modern and gas efficient ERC20 + EIP-2612 implementation.
 
 _Do not manually set balances without updating totalSupply, as the sum of all user balances must not exceed it._
 
-### Transfer
+## Methods
-
-```solidity
-event Transfer(address from, address to, uint256 amount)
-```
-
-### Approval
-
-```solidity
-event Approval(address owner, address spender, uint256 amount)
-```
-
-### name
-
-```solidity
-string name
-```
-
-### symbol
-
-```solidity
-string symbol
-```
-
-### decimals
-
-```solidity
-uint8 decimals
-```
-
-### totalSupply
-
-```solidity
-uint256 totalSupply
-```
-
-### balanceOf
-
-```solidity
-mapping(address => uint256) balanceOf
-```
-
-### allowance
-
-```solidity
-mapping(address => mapping(address => uint256)) allowance
-```
-
-### INITIAL_CHAIN_ID
-
-```solidity
-uint256 INITIAL_CHAIN_ID
-```
-
-### INITIAL_DOMAIN_SEPARATOR
-
-```solidity
-bytes32 INITIAL_DOMAIN_SEPARATOR
-```
-
-### nonces
-
-```solidity
-mapping(address => uint256) nonces
-```
-
-### constructor
-
-```solidity
-constructor(string _name, string _symbol, uint8 _decimals) internal
-```
-
-### approve
-
-```solidity
-function approve(address spender, uint256 amount) public virtual returns (bool)
-```
-
-### transfer
-
-```solidity
-function transfer(address to, uint256 amount) public virtual returns (bool)
-```
-
-### transferFrom
-
-```solidity
-function transferFrom(address from, address to, uint256 amount) public virtual returns (bool)
-```
-
-### permit
-
-```solidity
-function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public virtual
-```
 
 ### DOMAIN_SEPARATOR
 
 ```solidity
-function DOMAIN_SEPARATOR() public view virtual returns (bytes32)
+function DOMAIN_SEPARATOR() external view returns (bytes32)
 ```
 
-### computeDomainSeparator
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | bytes32 | undefined   |
+
+### allowance
 
 ```solidity
-function computeDomainSeparator() internal view virtual returns (bytes32)
+function allowance(address, address) external view returns (uint256)
 ```
 
-### _mint
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+| \_1  | address | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### approve
 
 ```solidity
-function _mint(address to, uint256 amount) internal virtual
+function approve(address spender, uint256 amount) external nonpayable returns (bool)
 ```
 
-### _burn
+#### Parameters
+
+| Name    | Type    | Description |
+| ------- | ------- | ----------- |
+| spender | address | undefined   |
+| amount  | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+### balanceOf
 
 ```solidity
-function _burn(address from, uint256 amount) internal virtual
+function balanceOf(address) external view returns (uint256)
 ```
 
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### decimals
+
+```solidity
+function decimals() external view returns (uint8)
+```
+
+#### Returns
+
+| Name | Type  | Description |
+| ---- | ----- | ----------- |
+| \_0  | uint8 | undefined   |
+
+### name
+
+```solidity
+function name() external view returns (string)
+```
+
+#### Returns
+
+| Name | Type   | Description |
+| ---- | ------ | ----------- |
+| \_0  | string | undefined   |
+
+### nonces
+
+```solidity
+function nonces(address) external view returns (uint256)
+```
+
+#### Parameters
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | address | undefined   |
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### permit
+
+```solidity
+function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) external nonpayable
+```
+
+#### Parameters
+
+| Name     | Type    | Description |
+| -------- | ------- | ----------- |
+| owner    | address | undefined   |
+| spender  | address | undefined   |
+| value    | uint256 | undefined   |
+| deadline | uint256 | undefined   |
+| v        | uint8   | undefined   |
+| r        | bytes32 | undefined   |
+| s        | bytes32 | undefined   |
+
+### symbol
+
+```solidity
+function symbol() external view returns (string)
+```
+
+#### Returns
+
+| Name | Type   | Description |
+| ---- | ------ | ----------- |
+| \_0  | string | undefined   |
+
+### totalSupply
+
+```solidity
+function totalSupply() external view returns (uint256)
+```
+
+#### Returns
+
+| Name | Type    | Description |
+| ---- | ------- | ----------- |
+| \_0  | uint256 | undefined   |
+
+### transfer
+
+```solidity
+function transfer(address to, uint256 amount) external nonpayable returns (bool)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| to     | address | undefined   |
+| amount | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+### transferFrom
+
+```solidity
+function transferFrom(address from, address to, uint256 amount) external nonpayable returns (bool)
+```
+
+#### Parameters
+
+| Name   | Type    | Description |
+| ------ | ------- | ----------- |
+| from   | address | undefined   |
+| to     | address | undefined   |
+| amount | uint256 | undefined   |
+
+#### Returns
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| \_0  | bool | undefined   |
+
+## Events
+
+### Approval
+
+```solidity
+event Approval(address indexed owner, address indexed spender, uint256 amount)
+```
+
+#### Parameters
+
+| Name              | Type    | Description |
+| ----------------- | ------- | ----------- |
+| owner `indexed`   | address | undefined   |
+| spender `indexed` | address | undefined   |
+| amount            | uint256 | undefined   |
+
+### Transfer
+
+```solidity
+event Transfer(address indexed from, address indexed to, uint256 amount)
+```
+
+#### Parameters
+
+| Name           | Type    | Description |
+| -------------- | ------- | ----------- |
+| from `indexed` | address | undefined   |
+| to `indexed`   | address | undefined   |
+| amount         | uint256 | undefined   |

docs/lib/utils/ECDSA.md

@@ -1,38 +0,0 @@
-# Solidity API
-
-## ECDSA
-
-Gas optimized ECDSA wrapper.
-
-### InvalidSignature
-
-```solidity
-error InvalidSignature()
-```
-
-_The signature is invalid._
-
-### recoverCalldata
-
-```solidity
-function recoverCalldata(bytes32 hash, bytes signature) internal view returns (address result)
-```
-
-_Recovers the signer's address from a message digest `hash`,
-and the `signature`.
-
-This function does NOT accept EIP-2098 short form signatures.
-Use `recover(bytes32 hash, bytes32 r, bytes32 vs)` for EIP-2098
-short form signatures instead._
-
-### toEthSignedMessageHash
-
-```solidity
-function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 result)
-```
-
-_Returns an Ethereum Signed Message, created from a `hash`.
-This produces a hash corresponding to the one signed with the
-[`eth_sign`](https://eth.wiki/json-rpc/API#eth_sign)
-JSON-RPC method as part of EIP-191._
-

docs/lib/utils/MerkleProofLib.md

@@ -1,14 +1,5 @@
-# Solidity API
+# MerkleProofLib
 
-## MerkleProofLib
+_Solady (https://github.com/vectorized/solady/blob/main/src/utils/MerkleProofLib.sol)Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/MerkleProofLib.sol)Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/utils/cryptography/MerkleProof.sol)_
 
 Gas optimized verification of proof of inclusion for a leaf in a Merkle tree.
-
-### verify
-
-```solidity
-function verify(bytes32[] proof, bytes32 root, bytes32 leaf) internal pure returns (bool isValid)
-```
-
-_Returns whether `leaf` exists in the Merkle tree with `root`, given `proof`._
-

docs/lib/utils/Multicall.md

@@ -1,50 +0,0 @@
-# Solidity API
-
-## Multicall
-
-Contract that batches view function calls and aggregates their results.
-
-### CallFailed
-
-```solidity
-error CallFailed(string reason)
-```
-
-_0x_
-
-### Call
-
-```solidity
-struct Call {
-  address target;
-  bytes callData;
-}
-```
-
-### Result
-
-```solidity
-struct Result {
-  bool success;
-  bytes returnData;
-}
-```
-
-### constructor
-
-```solidity
-constructor() public payable
-```
-
-### mtc1
-
-```solidity
-function mtc1(struct Multicall.Call[] calls) external returns (uint256, bytes[])
-```
-
-### mtc2
-
-```solidity
-function mtc2(struct Multicall.Call[] calls) external returns (uint256, bytes32, struct Multicall.Result[])
-```
-

docs/lib/utils/ReentrancyGuard.md

@@ -1,34 +1,13 @@
-# Solidity API
+# ReentrancyGuard
 
-## ReentrancyGuard
+_z0r0z.ethModified from Seaport (https://github.com/ProjectOpenSea/seaport/blob/main/contracts/lib/ReentrancyGuard.sol)Modified from Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/utils/ReentrancyGuard.sol)_
 
 Reentrancy protection for smart contracts.
 
+## Errors
+
 ### Reentrancy
 
 ```solidity
 error Reentrancy()
 ```
-
-### nonReentrant
-
-```solidity
-modifier nonReentrant()
-```
-
-### setReentrancyGuard
-
-```solidity
-function setReentrancyGuard() internal virtual
-```
-
-_Check guard sentinel value and set it._
-
-### clearReentrancyGuard
-
-```solidity
-function clearReentrancyGuard() internal virtual
-```
-
-_Unset sentinel value._
-

docs/lib/utils/SafeTransferLib.md

@@ -1,62 +1,7 @@
-# Solidity API
+# SafeTransferLib
 
-## SafeTransferLib
+_Solmate (https://github.com/Rari-Capital/solmate/blob/main/src/utils/SafeTransferLib.sol)_
 
 Safe ETH and ERC20 transfer library that gracefully handles missing return values.
 
-_Caution! This library won't check that a token has code, responsibility is delegated to the caller._
+_Caution! This library won't check that a token has code, responsibility is delegated to the caller._
-
-### ETHTransferFailed
-
-```solidity
-error ETHTransferFailed()
-```
-
-_The ETH transfer has failed._
-
-### TransferFromFailed
-
-```solidity
-error TransferFromFailed()
-```
-
-_The ERC20 `transferFrom` has failed._
-
-### TransferFailed
-
-```solidity
-error TransferFailed()
-```
-
-_The ERC20 `transfer` has failed._
-
-### safeTransferETH
-
-```solidity
-function safeTransferETH(address to, uint256 amount) internal
-```
-
-_Sends `amount` (in wei) ETH to `to`.
-Reverts upon failure._
-
-### safeTransferFrom
-
-```solidity
-function safeTransferFrom(contract ERC20 token, address from, address to, uint256 amount) internal
-```
-
-_Sends `amount` of ERC20 `token` from `from` to `to`.
-Reverts upon failure.
-
-The `from` account must have at least `amount` approved for
-the current contract to manage._
-
-### safeTransfer
-
-```solidity
-function safeTransfer(contract ERC20 token, address to, uint256 amount) internal
-```
-
-_Sends `amount` of ERC20 `token` from the current contract to `to`.
-Reverts upon failure._
-

docs/p2pix.md

@@ -1,207 +0,0 @@
-# Solidity API
-
-## P2PIX
-
-### lockCounter
-
-```solidity
-uint256 lockCounter
-```
-
-### mapLocks
-
-```solidity
-mapping(uint256 => struct DataTypes.Lock) mapLocks
-```
-
-_List of Locks._
-
-### userRecord
-
-```solidity
-mapping(uint256 => uint256) userRecord
-```
-
-_Stores an relayer's last computed credit._
-
-### constructor
-
-```solidity
-constructor(uint256 defaultBlocks, address[] validSigners, address _reputation, contract ERC20[] tokens, bool[] tokenStates) public payable
-```
-
-### deposit
-
-```solidity
-function deposit(string pixTarget, bytes32 allowlistRoot, contract ERC20 token, uint96 amount, bool valid) public
-```
-
-Creates a deposit order based on a seller's
-offer of an amount of ERC20 tokens.
-Seller needs to send his tokens to the P2PIX smart contract.
-
-_Function sighash: 0x5e918943_
-
-#### Parameters
-
-| Name | Type | Description |
-| ---- | ---- | ----------- |
-| pixTarget | string | Pix key destination provided by the offer's seller. |
-| allowlistRoot | bytes32 | Optional allow list merkleRoot update `bytes32` value. as the deposit identifier. |
-| token | contract ERC20 |  |
-| amount | uint96 |  |
-| valid | bool |  |
-
-### setValidState
-
-```solidity
-function setValidState(contract ERC20 token, bool state) public
-```
-
-Enables seller to invalidate future
-locks made to his/her token offering order.
-This function does not affect any ongoing active locks.
-
-_Function sighash: 0x6d82d9e0_
-
-### lock
-
-```solidity
-function lock(address seller, contract ERC20 token, uint80 amount, bytes32[] merkleProof, uint256[] expiredLocks) public returns (uint256 lockID)
-```
-
-Public method designed to lock an remaining amount of
-the deposit order of a seller.
-Transaction forwarding must leave `merkleProof` empty;
-otherwise, the trustedForwarder must be previously added 
-to a seller whitelist.
-This method can be performed either by:
-- An user allowed via the seller's allowlist;
-- An user with enough userRecord to lock the wished amount;
-There can only exist a lock per each `_amount` partitioned
-from the total `remaining` value.
-Locks can only be performed in valid orders.
-
-_Function sighash: 0xdc43221c_
-
-#### Parameters
-
-| Name | Type | Description |
-| ---- | ---- | ----------- |
-| seller | address |  |
-| token | contract ERC20 |  |
-| amount | uint80 | The deposit's remaining amount wished to be locked. |
-| merkleProof | bytes32[] | Provided as a pass if the `msg.sender` is in the seller's allowlist; Left empty otherwise; |
-| expiredLocks | uint256[] | An array of identifiers to be provided so to unexpire locks using this transaction gas push. |
-
-#### Return Values
-
-| Name | Type | Description |
-| ---- | ---- | ----------- |
-| lockID | uint256 | The lock identifier. |
-
-### release
-
-```solidity
-function release(uint256 lockID, bytes32 pixTimestamp, bytes signature) public
-```
-
-Lock release method that liquidate lock
-orders and distributes relayer fees.
-This method can be called by any public actor
-as long the signature provided is valid.
-`relayerPremium` gets splitted equaly
-if relayer addresses differ.
-If the `msg.sender` of this method and `l.relayerAddress` are the same,
-`msg.sender` accrues both l.amount and l.relayerPremium as userRecord credit.
- In case of they differing:
-- `lock` caller gets accrued with `l.amount` as userRecord credit;
-- `release` caller gets accrued with `l.relayerPremium` as userRecord credit;
-
-_Function sighash: 0x11fc7f9a_
-
-### unlockExpired
-
-```solidity
-function unlockExpired(uint256[] lockIDs) public
-```
-
-Unlocks expired locks.
-Triggered in the callgraph by both `lock` and `withdraw` functions.
-This method can also have any public actor as its `tx.origin`.
-For each successfull unexpired lock recovered,
-`userRecord[_castAddrToKey(l.relayerAddress)]` is decreased by half of its value.
-
-_Function sighash: 0xb0983d39_
-
-### withdraw
-
-```solidity
-function withdraw(contract ERC20 token, uint256 amount, uint256[] expiredLocks) public
-```
-
-Seller's expired deposit fund sweeper.
-A seller may use this method to recover
-tokens from expired deposits.
-
-_Function sighash: 0xfb8c5ef0_
-
-### setRoot
-
-```solidity
-function setRoot(address addr, bytes32 merkleroot) public
-```
-
-### receive
-
-```solidity
-receive() external payable
-```
-
-### _addLock
-
-```solidity
-function _addLock(uint256 _bal, struct DataTypes.Lock _l) internal
-```
-
-### getBalance
-
-```solidity
-function getBalance(address seller, contract ERC20 token) public view returns (uint256 bal)
-```
-
-### getValid
-
-```solidity
-function getValid(address seller, contract ERC20 token) public view returns (bool valid)
-```
-
-### getPixTarget
-
-```solidity
-function getPixTarget(address seller, contract ERC20 token) public view returns (bytes32 pixTarget)
-```
-
-### getPixTargetString
-
-```solidity
-function getPixTargetString(address seller, contract ERC20 token) public view returns (string pixTarget)
-```
-
-### getBalances
-
-```solidity
-function getBalances(address[] sellers, contract ERC20 token) external view returns (uint256[])
-```
-
-### getLocksStatus
-
-```solidity
-function getLocksStatus(uint256[] ids) external view returns (uint256[], enum DataTypes.LockStatus[])
-```
-
-External getter that returns the status of a lockIDs array.
-Call will not revert if provided with an empty array as parameter.
-
-_Function sighash: 0x49ef8448_
-

eslint.config.js

@@ -1,55 +0,0 @@
-const tseslint = require("typescript-eslint");
-const js = require("@eslint/js");
-const eslintConfigPrettier = require("eslint-config-prettier");
-
-module.exports = tseslint.config(
-  {
-    ignores: [
-      ".yarn/",
-      "**/.coverage_artifacts",
-      "**/.coverage_cache",
-      "**/.coverage_contracts",
-      "**/artifacts",
-      "**/build",
-      "**/cache",
-      "**/coverage",
-      "**/dist",
-      "**/node_modules",
-      "**/types",
-      "deploys/old/",
-      "docs/",
-      "*.env",
-      "*.log",
-      ".pnp.*",
-      "coverage.json",
-      "npm-debug.log*",
-      "yarn-debug.log*",
-      "yarn-error.log*",
-      ".solcover.js",
-      "eslint.config.js",
-    ],
-  },
-  js.configs.recommended,
-  ...tseslint.configs.recommended,
-  eslintConfigPrettier,
-  {
-    languageOptions: {
-      parserOptions: {
-        projectService: true,
-        tsconfigRootDir: __dirname,
-      },
-    },
-    rules: {
-      "@typescript-eslint/no-floating-promises": [
-        "error",
-        { ignoreIIFE: true, ignoreVoid: true },
-      ],
-      "@typescript-eslint/no-inferrable-types": "off",
-      "@typescript-eslint/no-unused-vars": [
-        "error",
-        { argsIgnorePattern: "_", varsIgnorePattern: "_" },
-      ],
-      "@typescript-eslint/no-unused-expressions": "off",
-    },
-  },
-);

hardhat.config.ts

@@ -1,90 +1,96 @@
 import "@nomicfoundation/hardhat-chai-matchers";
 import "@nomicfoundation/hardhat-toolbox";
 import { config as dotenvConfig } from "dotenv";
+import "hardhat-tracer";
 import { HardhatUserConfig } from "hardhat/config";
 import { NetworkUserConfig } from "hardhat/types";
-import "hardhat-contract-sizer";
 import { resolve } from "path";
-import "solidity-docgen";
 
 dotenvConfig({ path: resolve(__dirname, "./.env") });
 
-// Default mnemonic used by Hardhat / Anvil for deterministic accounts.
+const mnemonic: string | undefined = process.env.MNEMONIC;
-// Lets `--network localhost` (and the default in-process `hardhat` net)
+if (!mnemonic) {
-// run without a .env. Public networks still require a real MNEMONIC.
+  throw new Error("Please set your MNEMONIC in a .env file");
-const DEFAULT_MNEMONIC =
+}
-  "test test test test test test test test test test test junk";
+
+const infuraApiKey: string | undefined =
+  process.env.INFURA_API_KEY;
+if (!infuraApiKey) {
+  throw new Error(
+    "Please set your INFURA_API_KEY in a .env file",
+  );
+}
 
-const mnemonic: string =
-  process.env.MNEMONIC ?? DEFAULT_MNEMONIC;
 const alchemyApiKey: string | undefined =
   process.env.ALCHEMY_API_KEY;
-const privateKey: string | undefined =
+if (!alchemyApiKey) {
-  process.env.PRIVATE_KEY;
+  throw new Error(
+    "Please set your ALCHEMY_API_KEY in a .env file",
+  );
+}
 
 const chainIds = {
   // "{INSERT_NAME}": {INSERT_ID},
   hardhat: 31337,
-  localhost: 31337,
   mainnet: 1,
-  "eth-sepolia": 11155111,
+  sepolia: 11155111,
-  "polygon-mainnet": 137,
+  goerli: 5,
-  "arb-mainnet": 42161,
+  "polygon-mumbai": 80001,
-  rootstock: 30,
-  "rootstock-testnet": 31,
 };
 
 function getChainConfig(
   chain: keyof typeof chainIds,
 ): NetworkUserConfig {
-  if (!alchemyApiKey) {
+  let jsonRpcUrl: string;
-    throw new Error(
+  switch (chain) {
-      `Please set ALCHEMY_API_KEY in a .env file before targeting ${chain}`,
+    case "polygon-mumbai":
-    );
+      jsonRpcUrl =
+        "https://polygon-mumbai.g.alchemy.com/v2/" +
+        alchemyApiKey;
+      break;
+    default:
+      jsonRpcUrl =
+        "https://" + chain + ".infura.io/v3/" + infuraApiKey;
   }
-  const jsonRpcUrl =
-    "https://" + chain + ".g.alchemy.com/v2/" + alchemyApiKey;
   return {
-    accounts: privateKey
+    // Comment out for default hardhat account settings
-      ? [privateKey]
+    accounts: {
-      : {
+      count: 10,
-          count: 10,
+      mnemonic,
-          mnemonic,
+      path: "m/44'/60'/0'/0",
-          path: "m/44'/60'/0'/0",
+    },
-        },
+    // gasPrice: 8000000000,
     chainId: chainIds[chain],
     url: jsonRpcUrl,
   };
 }
 
-const liveNetworks: Record<string, NetworkUserConfig> =
-  alchemyApiKey
-    ? {
-        mainnet: getChainConfig("mainnet"),
-        sepolia: getChainConfig("eth-sepolia"),
-        polygon: getChainConfig("polygon-mainnet"),
-        arbitrum: getChainConfig("arb-mainnet"),
-        rootstock: getChainConfig("rootstock"),
-        rsktestnet: getChainConfig("rootstock-testnet"),
-      }
-    : {};
-
 const config: HardhatUserConfig = {
   defaultNetwork: "hardhat",
   etherscan: {
     apiKey: {
       mainnet: process.env.ETHERSCAN_API_KEY || "",
-      sepolia: process.env.ETHERSCAN_API_KEY || "",
+      rinkeby: process.env.ETHERSCAN_API_KEY || "",
-      polygon: process.env.POLYGONSCAN_API_KEY || "",
+      goerli: process.env.ETHERSCAN_API_KEY || "",
-      arbitrumOne: process.env.ARBISCAN_API_KEY || "",
+      polygonMumbai: process.env.POLYGONSCAN_API_KEY || "",
     },
+    // customChains: [
+    //   {
+    //     // network: {INSERT_NAME},
+    //     // chainId: {INSERT_ID},
+    //     // urls: {
+    //       // apiURL:
+    //         // "{INSERT_URL}",
+    //       // browserURL: "{INSERT_URL}",
+    //     // },
+    //   },
+    // ],
   },
   gasReporter: {
     enabled: !!(
       process.env.REPORT_GAS &&
       process.env.REPORT_GAS != "false"
     ),
-    offline: true,
     showTimeSpent: true,
     showMethodSig: true,
     token: "ETH",
@@ -102,16 +108,11 @@ const config: HardhatUserConfig = {
       },
       chainId: chainIds.hardhat,
     },
-    // External Anvil / Hardhat node (e.g. `anvil --port 8545`). Used by
+    // network: getChainConfig("{INSERT_NAME}"),
-    // the frontend e2e suite to deploy a fresh chain per CI run.
+    mainnet: getChainConfig("mainnet"),
-    localhost: {
+    goerli: getChainConfig("goerli"),
-      url: "http://127.0.0.1:8545",
+    sepolia: getChainConfig("sepolia"),
-      chainId: chainIds.localhost,
+    "polygon-mumbai": getChainConfig("polygon-mumbai"),
-      accounts: {
-        mnemonic,
-      },
-    },
-    ...liveNetworks,
   },
   paths: {
     artifacts: "./artifacts",
@@ -120,33 +121,22 @@ const config: HardhatUserConfig = {
     tests: "./test",
   },
   solidity: {
-    version: "0.8.28",
+    version: "0.8.9",
     settings: {
-      viaIR: true,
+      // viaIR: true,
-      evmVersion: "cancun",
+      metadata: {
+        bytecodeHash: "none",
+      },
       optimizer: {
         enabled: true,
+        // max val = 4_294_967_295
         runs: 20_000,
-        details: {
-          deduplicate: true,
-          cse: true,
-          constantOptimizer: true,
-          peephole: true,
-          jumpdestRemover: true,
-          yul: true,
-          yulDetails: {
-            stackAllocation: true,
-          },
-        },
       },
     },
   },
   typechain: {
     outDir: "src/types",
-    target: "ethers-v6",
+    target: "ethers-v5",
-  },
-  docgen: {
-    pages: "files",
   },
 };
 

ignition/modules/MockToken.ts

@@ -1,14 +0,0 @@
-import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
-import { ethers } from "ethers";
-
-const DEFAULT_SUPPLY = ethers
-  .parseEther("20000000")
-  .toString();
-
-export default buildModule("MockToken", m => {
-  const supply = m.getParameter("supply", DEFAULT_SUPPLY);
-
-  const token = m.contract("MockToken", [supply]);
-
-  return { token };
-});

ignition/modules/P2PIX.ts

@@ -1,31 +0,0 @@
-import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
-
-import ReputationModule from "./Reputation";
-
-export default buildModule("P2PIX", m => {
-  const { reputation, multicall } = m.useModule(
-    ReputationModule,
-  );
-
-  const defaultBlocks = m.getParameter("defaultBlocks", 10);
-  const validSigners = m.getParameter<string[]>(
-    "validSigners",
-    [],
-  );
-  const tokens = m.getParameter<string[]>("tokens");
-  const allowed = m.getParameter<boolean[]>("allowed");
-
-  const p2pix = m.contract("P2PIX", [
-    defaultBlocks,
-    validSigners,
-    reputation,
-    tokens,
-    allowed,
-  ]);
-
-  return {
-    p2pix,
-    reputation,
-    multicall,
-  };
-});

ignition/modules/P2PIXWithMock.ts

@@ -1,32 +0,0 @@
-import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
-
-import MockTokenModule from "./MockToken";
-import ReputationModule from "./Reputation";
-
-export default buildModule("P2PIXWithMock", m => {
-  const { token } = m.useModule(MockTokenModule);
-  const { reputation, multicall } = m.useModule(
-    ReputationModule,
-  );
-
-  const defaultBlocks = m.getParameter("defaultBlocks", 10);
-  const validSigners = m.getParameter<string[]>(
-    "validSigners",
-    [],
-  );
-
-  const p2pix = m.contract("P2PIX", [
-    defaultBlocks,
-    validSigners,
-    reputation,
-    [token],
-    [true],
-  ]);
-
-  return {
-    p2pix,
-    reputation,
-    multicall,
-    token,
-  };
-});

ignition/modules/Reputation.ts

@@ -1,8 +0,0 @@
-import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
-
-export default buildModule("Reputation", m => {
-  const reputation = m.contract("Reputation", []);
-  const multicall = m.contract("Multicall", []);
-
-  return { reputation, multicall };
-});

ignition/parameters/localhost.json

@@ -1,9 +0,0 @@
-{
-  "P2PIXWithMock": {
-    "defaultBlocks": 10,
-    "validSigners": []
-  },
-  "MockToken": {
-    "supply": "20000000000000000000000000"
-  }
-}

ignition/parameters/prod.example.json

@@ -1,8 +0,0 @@
-{
-  "P2PIX": {
-    "defaultBlocks": 10,
-    "validSigners": [],
-    "tokens": ["0x0000000000000000000000000000000000000000"],
-    "allowed": [true]
-  }
-}

package.json

@@ -9,65 +9,84 @@
     "url": "https://github.com/doiim/p2pix-smart-contracts/issues"
   },
   "scripts": {
-    "clean": "hardhat clean",
+    "clean": "shx rm -rf ./artifacts ./cache ./coverage ./src/types ./coverage.json && yarn typechain",
-    "compile": "hardhat compile",
+    "commit": "git-cz",
-    "typechain": "hardhat typechain",
+    "compile": "cross-env TS_NODE_TRANSPILE_ONLY=true hardhat compile",
+    "typechain": "cross-env TS_NODE_TRANSPILE_ONLY=true hardhat typechain",
     "test": "hardhat test",
-    "deploy": "hardhat ignition deploy ignition/modules/P2PIX.ts",
+    "deploy1:localhost": "hardhat run scripts/1-deploy-mockToken.ts --network localhost",
-    "deploy:mock": "hardhat ignition deploy ignition/modules/P2PIXWithMock.ts",
+    "deploy2:localhost": "hardhat run scripts/2-deploy-p2pix.ts --network localhost",
+    "deploy1:goerli": "hardhat run scripts/1-deploy-mockToken.ts --network goerli",
+    "deploy2:goerli": "hardhat run scripts/2-deploy-p2pix.ts --network goerli",
+    "deploy1:mumbai": "hardhat run scripts/1-deploy-mockToken.ts --network polygon-mumbai",
+    "deploy2:mumbai": "hardhat run scripts/2-deploy-p2pix.ts --network polygon-mumbai",
     "coverage": "hardhat coverage --solcoverjs ./.solcover.js --temp artifacts --testfiles \"test/**/*.ts\" && yarn typechain",
     "lint": "yarn lint:sol && yarn lint:ts && yarn prettier:check",
     "lint:sol": "solhint --config ./.solhint.json --max-warnings 0 \"contracts/**/*.sol\"",
-    "lint:ts": "eslint .",
+    "lint:ts": "eslint --config ./.eslintrc.yaml --ignore-path ./.eslintignore --ext .js,.ts .",
+    "_postinstall": "husky install",
+    "postpublish": "pinst --enable",
+    "prepublishOnly": "pinst --disable",
     "prettier": "prettier --config ./.prettierrc.yaml --write \"**/*.{js,json,md,sol,ts,yaml,yml}\"",
     "prettier:check": "prettier --check --config ./.prettierrc.yaml \"**/*.{js,json,md,sol,ts,yaml,yml}\""
   },
   "devDependencies": {
-    "@ethersproject/abi": "^5.8.0",
+    "@commitlint/cli": "^17.2.0",
-    "@ethersproject/providers": "^5.8.0",
+    "@commitlint/config-conventional": "^17.2.0",
-    "@nomicfoundation/hardhat-chai-matchers": "^2.1.0",
+    "@ethersproject/abi": "^5.7.0",
-    "@nomicfoundation/hardhat-ethers": "^3.1.0",
+    "@ethersproject/abstract-signer": "^5.7.0",
-    "@nomicfoundation/hardhat-ignition": "^0.15.13",
+    "@ethersproject/bignumber": "^5.7.0",
-    "@nomicfoundation/hardhat-ignition-ethers": "^0.15.14",
+    "@ethersproject/bytes": "^5.7.0",
-    "@nomicfoundation/hardhat-network-helpers": "^1.1.0",
+    "@ethersproject/providers": "^5.7.2",
-    "@nomicfoundation/hardhat-toolbox": "^6.1.0",
+    "@nomicfoundation/hardhat-chai-matchers": "^1.0.4",
-    "@nomicfoundation/hardhat-verify": "^2.1.0",
+    "@nomicfoundation/hardhat-network-helpers": "1.0.6",
-    "@nomicfoundation/hardhat-viem": "^2.1.0",
+    "@nomicfoundation/hardhat-toolbox": "^2.0.0",
-    "@nomicfoundation/ignition-core": "^0.15.13",
+    "@nomiclabs/hardhat-ethers": "^2.2.1",
-    "@openzeppelin/contracts": "5.5.0",
+    "@nomiclabs/hardhat-etherscan": "^3.1.2",
-    "@typechain/ethers-v6": "^0.5.1",
+    "@trivago/prettier-plugin-sort-imports": "^3.4.0",
-    "@typechain/hardhat": "^9.1.0",
+    "@typechain/ethers-v5": "^10.1.1",
-    "@types/chai": "^4.3.20",
+    "@typechain/hardhat": "^6.1.4",
-    "@types/mocha": "^10.0.10",
+    "@types/chai": "^4.3.3",
-    "@types/node": "^24.1.0",
+    "@types/fs-extra": "^9.0.13",
-    "chai": "4.5.0",
+    "@types/mocha": "^9.1.1",
-    "dotenv": "^16.6.1",
+    "@types/node": "^18.11.9",
-    "eslint": "^9.32.0",
+    "@typescript-eslint/eslint-plugin": "^5.42.0",
-    "eslint-config-prettier": "^10.1.8",
+    "@typescript-eslint/parser": "^5.42.0",
-    "ethers": "^6.15.0",
+    "chai": "^4.3.6",
-    "hardhat": "^2.26.1",
+    "chalk": "4.x",
-    "hardhat-contract-sizer": "^2.10.0",
+    "commitizen": "^4.2.5",
-    "hardhat-gas-reporter": "^2.3.0",
+    "cross-env": "^7.0.3",
+    "cz-conventional-changelog": "^3.3.0",
+    "dotenv": "^16.0.3",
+    "eslint": "^8.26.0",
+    "eslint-config-prettier": "^8.5.0",
+    "ethers": "^5.7.2",
+    "fs-extra": "^10.1.0",
+    "hardhat": "^2.12.2",
+    "hardhat-gas-reporter": "^1.0.9",
+    "hardhat-tracer": "beta",
+    "husky": "^8.0.1",
     "keccak256": "^1.0.6",
+    "lint-staged": "^13.0.3",
     "lodash": "^4.17.21",
-    "merkletreejs": "^0.5.2",
+    "merkletreejs": "^0.2.32",
-    "mocha": "^10.8.2",
+    "mocha": "^10.1.0",
-    "prettier": "^3.0.0",
+    "pinst": "^3.0.0",
-    "prettier-plugin-solidity": "^1.0.0",
+    "prettier": "^2.7.1",
-    "solhint": "^6.2.1",
+    "prettier-plugin-solidity": "^1.0.0-rc.1",
-    "solhint-plugin-prettier": "^0.1.0",
+    "shx": "^0.3.4",
-    "solidity-coverage": "^0.8.16",
+    "solhint": "^3.3.7",
-    "solidity-docgen": "^0.6.0-beta.36",
+    "solhint-plugin-prettier": "^0.0.5",
-    "ts-node": "^10.9.2",
+    "solidity-coverage": "^0.8.2",
-    "typechain": "^8.3.2",
+    "ts-generator": "^0.1.1",
-    "typescript": "^5.8.3",
+    "ts-node": "^10.9.1",
-    "typescript-eslint": "^8.60.0",
+    "typechain": "^8.1.1",
-    "viem": "^2.33.1"
+    "typescript": "^4.8.4"
   },
   "files": [
     "/contracts"
   ],
-  "packageManager": "yarn@4.9.2",
+  "packageManager": "yarn@3.2.1",
   "publishConfig": {
     "access": "public"
   }

scripts/1-deploy-mockToken.ts

@@ -0,0 +1,56 @@
+import "@nomiclabs/hardhat-ethers";
+import "@nomiclabs/hardhat-etherscan";
+import { BigNumber } from "ethers";
+import * as fs from "fs";
+import { ethers, network } from "hardhat";
+import hre from "hardhat";
+
+import { Deploys } from "../test/utils/fixtures";
+
+let deploysJson: Deploys;
+const supply: BigNumber = ethers.utils.parseEther("20000000");
+
+const main = async () => {
+  try {
+    const data = fs.readFileSync(
+      `./deploys/${network.name}.json`,
+      { encoding: "utf-8" },
+    );
+    deploysJson = JSON.parse(data);
+  } catch (err) {
+    console.log("Error loading Master address: ", err);
+    process.exit(1);
+  }
+
+  const [deployer] = await ethers.getSigners();
+  console.log(`Deploying contracts with ${deployer.address}`);
+
+  const ERC20Factory = await ethers.getContractFactory(
+    "MockToken",
+  );
+  const erc20 = await ERC20Factory.deploy(supply);
+  await erc20.deployed();
+
+  deploysJson.token = erc20.address;
+  console.log("🚀 Mock Token Deployed:", erc20.address);
+  await erc20.deployTransaction.wait(6);
+
+  fs.writeFileSync(
+    `./deploys/${network.name}.json`,
+    JSON.stringify(deploysJson, undefined, 2),
+  );
+
+  /* UNCOMMENT WHEN DEPLOYING TO MAINNET/PUBLIC TESTNETS */
+  // verify
+  await hre.run("verify:verify", {
+    address: erc20.address,
+    constructorArguments: [supply],
+  });
+};
+
+main()
+  .then(() => process.exit(0))
+  .catch(error => {
+    console.log(error);
+    process.exit(1);
+  });

scripts/2-deploy-p2pix.ts

@@ -0,0 +1,85 @@
+import "@nomiclabs/hardhat-ethers";
+import "@nomiclabs/hardhat-etherscan";
+import * as fs from "fs";
+import { ethers, network } from "hardhat";
+import hre from "hardhat";
+
+import { Deploys } from "../test/utils/fixtures";
+
+let deploysJson: Deploys;
+
+const main = async () => {
+  try {
+    const data = fs.readFileSync(
+      `./deploys/${network.name}.json`,
+      { encoding: "utf-8" },
+    );
+    deploysJson = JSON.parse(data);
+  } catch (err) {
+    console.log("Error loading Master address: ", err);
+    process.exit(1);
+  }
+
+  const [deployer] = await ethers.getSigners();
+  console.log(`Deploying contracts with ${deployer.address}`);
+
+  const Reputation = await ethers.getContractFactory(
+    "Reputation",
+  );
+  const Multicall = await ethers.getContractFactory(
+    "Multicall",
+  );
+  const reputation = await Reputation.deploy();
+  await reputation.deployed();
+  const mutlicall = await Multicall.deploy();
+  await mutlicall.deployed();
+
+  const P2PIX = await ethers.getContractFactory("P2PIX");
+  const p2pix = await P2PIX.deploy(
+    10,
+    deploysJson.signers,
+    reputation.address,
+    [deploysJson.token],
+    [true],
+  );
+  await p2pix.deployed();
+
+  deploysJson.p2pix = p2pix.address;
+  console.log("🚀 P2PIX Deployed:", p2pix.address);
+  console.log("🌠 Reputation Deployed:", reputation.address);
+  console.log("🛰 Multicall Deployed:", mutlicall.address);
+  await p2pix.deployTransaction.wait(6);
+
+  fs.writeFileSync(
+    `./deploys/${network.name}.json`,
+    JSON.stringify(deploysJson, undefined, 2),
+  );
+
+  /* UNCOMMENT WHEN DEPLOYING TO MAINNET/PUBLIC TESTNETS */
+  //verify
+  await hre.run("verify:verify", {
+    address: p2pix.address,
+    constructorArguments: [
+      10,
+      deploysJson.signers,
+      reputation.address,
+      [deploysJson.token],
+      [true],
+    ],
+  });
+  await hre.run("verify:verify", {
+    address: reputation.address,
+    constructorArguments: [],
+  });
+  await hre.run("verify:verify", {
+    address: mutlicall.address,
+    constructorArguments: [],
+  });
+};
+
+main()
+  .then(() => process.exit(0))
+  .catch(error => {
+    console.log(error);
+    process.exit(1);
+  });

scripts/setDefaultBlocks.ts

@@ -2,7 +2,7 @@ import "@nomiclabs/hardhat-ethers";
 import "@nomiclabs/hardhat-etherscan";
 import * as fs from "fs";
 import { ethers, network } from "hardhat";
-import { Deploys } from "../test/utils/interfaces";
+import { Deploys } from "../test/utils/fixtures";
 import { P2PIX__factory } from "../src/types";
 
 let deploysJson: Deploys;
@@ -20,22 +20,12 @@ const main = async () => {
   }
 
   const [deployer] = await ethers.getSigners();
-  console.log(
+  console.log(`Signing transactions with ${deployer.address}`);
-    `Signing transactions with ${deployer.address}`,
-  );
 
-  const iface = new ethers.utils.Interface(
+  const iface = new ethers.utils.Interface(P2PIX__factory.abi);
-    P2PIX__factory.abi,
+  const calldata = iface.encodeFunctionData("setDefaultLockBlocks", ["10000"]);
-  );
+  
-  const calldata = iface.encodeFunctionData(
+  const tx = await deployer.sendTransaction({to:deploysJson.p2pix, data: calldata});
-    "setDefaultLockBlocks",
-    ["10000"],
-  );
-
-  const tx = await deployer.sendTransaction({
-    to: deploysJson.p2pix,
-    data: calldata,
-  });
   const done = await tx.wait();
   console.log(done.transactionHash);
 };

src/types/EventAndErrors.ts

@@ -0,0 +1,328 @@
+/* Autogenerated file. Do not edit manually. */
+/* tslint:disable */
+/* eslint-disable */
+import type {
+  BaseContract,
+  BigNumber,
+  BigNumberish,
+  Signer,
+  utils,
+} from "ethers";
+import type { EventFragment } from "@ethersproject/abi";
+import type { Listener, Provider } from "@ethersproject/providers";
+import type {
+  TypedEventFilter,
+  TypedEvent,
+  TypedListener,
+  OnEvent,
+  PromiseOrValue,
+} from "./common";
+
+export interface EventAndErrorsInterface extends utils.Interface {
+  functions: {};
+
+  events: {
+    "AllowedERC20Updated(address,bool)": EventFragment;
+    "DepositAdded(address,address,uint256)": EventFragment;
+    "DepositWithdrawn(address,address,uint256)": EventFragment;
+    "FundsWithdrawn(address,uint256)": EventFragment;
+    "LockAdded(address,uint256,uint256,uint256)": EventFragment;
+    "LockBlocksUpdated(uint256)": EventFragment;
+    "LockReleased(address,uint256,uint256)": EventFragment;
+    "LockReturned(address,uint256)": EventFragment;
+    "ReputationUpdated(address)": EventFragment;
+    "RootUpdated(address,bytes32)": EventFragment;
+    "ValidSet(address,address,bool)": EventFragment;
+    "ValidSignersUpdated(address[])": EventFragment;
+  };
+
+  getEvent(nameOrSignatureOrTopic: "AllowedERC20Updated"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "DepositAdded"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "DepositWithdrawn"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "FundsWithdrawn"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "LockAdded"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "LockBlocksUpdated"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "LockReleased"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "LockReturned"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "ReputationUpdated"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "RootUpdated"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "ValidSet"): EventFragment;
+  getEvent(nameOrSignatureOrTopic: "ValidSignersUpdated"): EventFragment;
+}
+
+export interface AllowedERC20UpdatedEventObject {
+  token: string;
+  state: boolean;
+}
+export type AllowedERC20UpdatedEvent = TypedEvent<
+  [string, boolean],
+  AllowedERC20UpdatedEventObject
+>;
+
+export type AllowedERC20UpdatedEventFilter =
+  TypedEventFilter<AllowedERC20UpdatedEvent>;
+
+export interface DepositAddedEventObject {
+  seller: string;
+  token: string;
+  amount: BigNumber;
+}
+export type DepositAddedEvent = TypedEvent<
+  [string, string, BigNumber],
+  DepositAddedEventObject
+>;
+
+export type DepositAddedEventFilter = TypedEventFilter<DepositAddedEvent>;
+
+export interface DepositWithdrawnEventObject {
+  seller: string;
+  token: string;
+  amount: BigNumber;
+}
+export type DepositWithdrawnEvent = TypedEvent<
+  [string, string, BigNumber],
+  DepositWithdrawnEventObject
+>;
+
+export type DepositWithdrawnEventFilter =
+  TypedEventFilter<DepositWithdrawnEvent>;
+
+export interface FundsWithdrawnEventObject {
+  owner: string;
+  amount: BigNumber;
+}
+export type FundsWithdrawnEvent = TypedEvent<
+  [string, BigNumber],
+  FundsWithdrawnEventObject
+>;
+
+export type FundsWithdrawnEventFilter = TypedEventFilter<FundsWithdrawnEvent>;
+
+export interface LockAddedEventObject {
+  buyer: string;
+  lockID: BigNumber;
+  seller: BigNumber;
+  amount: BigNumber;
+}
+export type LockAddedEvent = TypedEvent<
+  [string, BigNumber, BigNumber, BigNumber],
+  LockAddedEventObject
+>;
+
+export type LockAddedEventFilter = TypedEventFilter<LockAddedEvent>;
+
+export interface LockBlocksUpdatedEventObject {
+  blocks: BigNumber;
+}
+export type LockBlocksUpdatedEvent = TypedEvent<
+  [BigNumber],
+  LockBlocksUpdatedEventObject
+>;
+
+export type LockBlocksUpdatedEventFilter =
+  TypedEventFilter<LockBlocksUpdatedEvent>;
+
+export interface LockReleasedEventObject {
+  buyer: string;
+  lockId: BigNumber;
+  amount: BigNumber;
+}
+export type LockReleasedEvent = TypedEvent<
+  [string, BigNumber, BigNumber],
+  LockReleasedEventObject
+>;
+
+export type LockReleasedEventFilter = TypedEventFilter<LockReleasedEvent>;
+
+export interface LockReturnedEventObject {
+  buyer: string;
+  lockId: BigNumber;
+}
+export type LockReturnedEvent = TypedEvent<
+  [string, BigNumber],
+  LockReturnedEventObject
+>;
+
+export type LockReturnedEventFilter = TypedEventFilter<LockReturnedEvent>;
+
+export interface ReputationUpdatedEventObject {
+  reputation: string;
+}
+export type ReputationUpdatedEvent = TypedEvent<
+  [string],
+  ReputationUpdatedEventObject
+>;
+
+export type ReputationUpdatedEventFilter =
+  TypedEventFilter<ReputationUpdatedEvent>;
+
+export interface RootUpdatedEventObject {
+  seller: string;
+  merkleRoot: string;
+}
+export type RootUpdatedEvent = TypedEvent<
+  [string, string],
+  RootUpdatedEventObject
+>;
+
+export type RootUpdatedEventFilter = TypedEventFilter<RootUpdatedEvent>;
+
+export interface ValidSetEventObject {
+  seller: string;
+  token: string;
+  state: boolean;
+}
+export type ValidSetEvent = TypedEvent<
+  [string, string, boolean],
+  ValidSetEventObject
+>;
+
+export type ValidSetEventFilter = TypedEventFilter<ValidSetEvent>;
+
+export interface ValidSignersUpdatedEventObject {
+  signers: string[];
+}
+export type ValidSignersUpdatedEvent = TypedEvent<
+  [string[]],
+  ValidSignersUpdatedEventObject
+>;
+
+export type ValidSignersUpdatedEventFilter =
+  TypedEventFilter<ValidSignersUpdatedEvent>;
+
+export interface EventAndErrors extends BaseContract {
+  connect(signerOrProvider: Signer | Provider | string): this;
+  attach(addressOrName: string): this;
+  deployed(): Promise<this>;
+
+  interface: EventAndErrorsInterface;
+
+  queryFilter<TEvent extends TypedEvent>(
+    event: TypedEventFilter<TEvent>,
+    fromBlockOrBlockhash?: string | number | undefined,
+    toBlock?: string | number | undefined
+  ): Promise<Array<TEvent>>;
+
+  listeners<TEvent extends TypedEvent>(
+    eventFilter?: TypedEventFilter<TEvent>
+  ): Array<TypedListener<TEvent>>;
+  listeners(eventName?: string): Array<Listener>;
+  removeAllListeners<TEvent extends TypedEvent>(
+    eventFilter: TypedEventFilter<TEvent>
+  ): this;
+  removeAllListeners(eventName?: string): this;
+  off: OnEvent<this>;
+  on: OnEvent<this>;
+  once: OnEvent<this>;
+  removeListener: OnEvent<this>;
+
+  functions: {};
+
+  callStatic: {};
+
+  filters: {
+    "AllowedERC20Updated(address,bool)"(
+      token?: PromiseOrValue<string> | null,
+      state?: PromiseOrValue<boolean> | null
+    ): AllowedERC20UpdatedEventFilter;
+    AllowedERC20Updated(
+      token?: PromiseOrValue<string> | null,
+      state?: PromiseOrValue<boolean> | null
+    ): AllowedERC20UpdatedEventFilter;
+
+    "DepositAdded(address,address,uint256)"(
+      seller?: PromiseOrValue<string> | null,
+      token?: null,
+      amount?: null
+    ): DepositAddedEventFilter;
+    DepositAdded(
+      seller?: PromiseOrValue<string> | null,
+      token?: null,
+      amount?: null
+    ): DepositAddedEventFilter;
+
+    "DepositWithdrawn(address,address,uint256)"(
+      seller?: PromiseOrValue<string> | null,
+      token?: null,
+      amount?: null
+    ): DepositWithdrawnEventFilter;
+    DepositWithdrawn(
+      seller?: PromiseOrValue<string> | null,
+      token?: null,
+      amount?: null
+    ): DepositWithdrawnEventFilter;
+
+    "FundsWithdrawn(address,uint256)"(
+      owner?: null,
+      amount?: null
+    ): FundsWithdrawnEventFilter;
+    FundsWithdrawn(owner?: null, amount?: null): FundsWithdrawnEventFilter;
+
+    "LockAdded(address,uint256,uint256,uint256)"(
+      buyer?: PromiseOrValue<string> | null,
+      lockID?: PromiseOrValue<BigNumberish> | null,
+      seller?: null,
+      amount?: null
+    ): LockAddedEventFilter;
+    LockAdded(
+      buyer?: PromiseOrValue<string> | null,
+      lockID?: PromiseOrValue<BigNumberish> | null,
+      seller?: null,
+      amount?: null
+    ): LockAddedEventFilter;
+
+    "LockBlocksUpdated(uint256)"(blocks?: null): LockBlocksUpdatedEventFilter;
+    LockBlocksUpdated(blocks?: null): LockBlocksUpdatedEventFilter;
+
+    "LockReleased(address,uint256,uint256)"(
+      buyer?: PromiseOrValue<string> | null,
+      lockId?: null,
+      amount?: null
+    ): LockReleasedEventFilter;
+    LockReleased(
+      buyer?: PromiseOrValue<string> | null,
+      lockId?: null,
+      amount?: null
+    ): LockReleasedEventFilter;
+
+    "LockReturned(address,uint256)"(
+      buyer?: PromiseOrValue<string> | null,
+      lockId?: null
+    ): LockReturnedEventFilter;
+    LockReturned(
+      buyer?: PromiseOrValue<string> | null,
+      lockId?: null
+    ): LockReturnedEventFilter;
+
+    "ReputationUpdated(address)"(
+      reputation?: null
+    ): ReputationUpdatedEventFilter;
+    ReputationUpdated(reputation?: null): ReputationUpdatedEventFilter;
+
+    "RootUpdated(address,bytes32)"(
+      seller?: null,
+      merkleRoot?: null
+    ): RootUpdatedEventFilter;
+    RootUpdated(seller?: null, merkleRoot?: null): RootUpdatedEventFilter;
+
+    "ValidSet(address,address,bool)"(
+      seller?: PromiseOrValue<string> | null,
+      token?: null,
+      state?: null
+    ): ValidSetEventFilter;
+    ValidSet(
+      seller?: PromiseOrValue<string> | null,
+      token?: null,
+      state?: null
+    ): ValidSetEventFilter;
+
+    "ValidSignersUpdated(address[])"(
+      signers?: null
+    ): ValidSignersUpdatedEventFilter;
+    ValidSignersUpdated(signers?: null): ValidSignersUpdatedEventFilter;
+  };
+
+  estimateGas: {};
+
+  populateTransaction: {};
+}

src/types/Reputation.ts

@@ -0,0 +1,211 @@
+/* Autogenerated file. Do not edit manually. */
+/* tslint:disable */
+/* eslint-disable */
+import type {
+  BaseContract,
+  BigNumber,
+  BigNumberish,
+  BytesLike,
+  CallOverrides,
+  ContractTransaction,
+  Overrides,
+  PopulatedTransaction,
+  Signer,
+  utils,
+} from "ethers";
+import type {
+  FunctionFragment,
+  Result,
+  EventFragment,
+} from "@ethersproject/abi";
+import type { Listener, Provider } from "@ethersproject/providers";
+import type {
+  TypedEventFilter,
+  TypedEvent,
+  TypedListener,
+  OnEvent,
+  PromiseOrValue,
+} from "./common";
+
+export interface ReputationInterface extends utils.Interface {
+  functions: {
+    "limiter(uint256)": FunctionFragment;
+    "magicValue()": FunctionFragment;
+    "maxLimit()": FunctionFragment;
+    "owner()": FunctionFragment;
+    "setOwner(address)": FunctionFragment;
+  };
+
+  getFunction(
+    nameOrSignatureOrTopic:
+      | "limiter"
+      | "magicValue"
+      | "maxLimit"
+      | "owner"
+      | "setOwner"
+  ): FunctionFragment;
+
+  encodeFunctionData(
+    functionFragment: "limiter",
+    values: [PromiseOrValue<BigNumberish>]
+  ): string;
+  encodeFunctionData(
+    functionFragment: "magicValue",
+    values?: undefined
+  ): string;
+  encodeFunctionData(functionFragment: "maxLimit", values?: undefined): string;
+  encodeFunctionData(functionFragment: "owner", values?: undefined): string;
+  encodeFunctionData(
+    functionFragment: "setOwner",
+    values: [PromiseOrValue<string>]
+  ): string;
+
+  decodeFunctionResult(functionFragment: "limiter", data: BytesLike): Result;
+  decodeFunctionResult(functionFragment: "magicValue", data: BytesLike): Result;
+  decodeFunctionResult(functionFragment: "maxLimit", data: BytesLike): Result;
+  decodeFunctionResult(functionFragment: "owner", data: BytesLike): Result;
+  decodeFunctionResult(functionFragment: "setOwner", data: BytesLike): Result;
+
+  events: {
+    "OwnerUpdated(address,address)": EventFragment;
+  };
+
+  getEvent(nameOrSignatureOrTopic: "OwnerUpdated"): EventFragment;
+}
+
+export interface OwnerUpdatedEventObject {
+  user: string;
+  newOwner: string;
+}
+export type OwnerUpdatedEvent = TypedEvent<
+  [string, string],
+  OwnerUpdatedEventObject
+>;
+
+export type OwnerUpdatedEventFilter = TypedEventFilter<OwnerUpdatedEvent>;
+
+export interface Reputation extends BaseContract {
+  connect(signerOrProvider: Signer | Provider | string): this;
+  attach(addressOrName: string): this;
+  deployed(): Promise<this>;
+
+  interface: ReputationInterface;
+
+  queryFilter<TEvent extends TypedEvent>(
+    event: TypedEventFilter<TEvent>,
+    fromBlockOrBlockhash?: string | number | undefined,
+    toBlock?: string | number | undefined
+  ): Promise<Array<TEvent>>;
+
+  listeners<TEvent extends TypedEvent>(
+    eventFilter?: TypedEventFilter<TEvent>
+  ): Array<TypedListener<TEvent>>;
+  listeners(eventName?: string): Array<Listener>;
+  removeAllListeners<TEvent extends TypedEvent>(
+    eventFilter: TypedEventFilter<TEvent>
+  ): this;
+  removeAllListeners(eventName?: string): this;
+  off: OnEvent<this>;
+  on: OnEvent<this>;
+  once: OnEvent<this>;
+  removeListener: OnEvent<this>;
+
+  functions: {
+    limiter(
+      _userCredit: PromiseOrValue<BigNumberish>,
+      overrides?: CallOverrides
+    ): Promise<[BigNumber] & { _spendLimit: BigNumber }>;
+
+    magicValue(overrides?: CallOverrides): Promise<[BigNumber]>;
+
+    maxLimit(overrides?: CallOverrides): Promise<[BigNumber]>;
+
+    owner(overrides?: CallOverrides): Promise<[string]>;
+
+    setOwner(
+      newOwner: PromiseOrValue<string>,
+      overrides?: Overrides & { from?: PromiseOrValue<string> }
+    ): Promise<ContractTransaction>;
+  };
+
+  limiter(
+    _userCredit: PromiseOrValue<BigNumberish>,
+    overrides?: CallOverrides
+  ): Promise<BigNumber>;
+
+  magicValue(overrides?: CallOverrides): Promise<BigNumber>;
+
+  maxLimit(overrides?: CallOverrides): Promise<BigNumber>;
+
+  owner(overrides?: CallOverrides): Promise<string>;
+
+  setOwner(
+    newOwner: PromiseOrValue<string>,
+    overrides?: Overrides & { from?: PromiseOrValue<string> }
+  ): Promise<ContractTransaction>;
+
+  callStatic: {
+    limiter(
+      _userCredit: PromiseOrValue<BigNumberish>,
+      overrides?: CallOverrides
+    ): Promise<BigNumber>;
+
+    magicValue(overrides?: CallOverrides): Promise<BigNumber>;
+
+    maxLimit(overrides?: CallOverrides): Promise<BigNumber>;
+
+    owner(overrides?: CallOverrides): Promise<string>;
+
+    setOwner(
+      newOwner: PromiseOrValue<string>,
+      overrides?: CallOverrides
+    ): Promise<void>;
+  };
+
+  filters: {
+    "OwnerUpdated(address,address)"(
+      user?: PromiseOrValue<string> | null,
+      newOwner?: PromiseOrValue<string> | null
+    ): OwnerUpdatedEventFilter;
+    OwnerUpdated(
+      user?: PromiseOrValue<string> | null,
+      newOwner?: PromiseOrValue<string> | null
+    ): OwnerUpdatedEventFilter;
+  };
+
+  estimateGas: {
+    limiter(
+      _userCredit: PromiseOrValue<BigNumberish>,
+      overrides?: CallOverrides
+    ): Promise<BigNumber>;
+
+    magicValue(overrides?: CallOverrides): Promise<BigNumber>;
+
+    maxLimit(overrides?: CallOverrides): Promise<BigNumber>;
+
+    owner(overrides?: CallOverrides): Promise<BigNumber>;
+
+    setOwner(
+      newOwner: PromiseOrValue<string>,
+      overrides?: Overrides & { from?: PromiseOrValue<string> }
+    ): Promise<BigNumber>;
+  };
+
+  populateTransaction: {
+    limiter(
+      _userCredit: PromiseOrValue<BigNumberish>,
+      overrides?: CallOverrides
+    ): Promise<PopulatedTransaction>;
+
+    magicValue(overrides?: CallOverrides): Promise<PopulatedTransaction>;
+
+    maxLimit(overrides?: CallOverrides): Promise<PopulatedTransaction>;
+
+    owner(overrides?: CallOverrides): Promise<PopulatedTransaction>;
+
+    setOwner(
+      newOwner: PromiseOrValue<string>,
+      overrides?: Overrides & { from?: PromiseOrValue<string> }
+    ): Promise<PopulatedTransaction>;
+  };
+}