Parallel Tokens

Summary

This repository contains all the contracts of Parallel Tokens with associated contract.

Architecture

TokenP contract is the ERC20 stablecoin.
BridgeableTokenP is an OFT (layerZero standard) contract that unlock the power of TokenP to be bridgeable between specific chains.
FlashParallelToken is the flashloan contract on top of TokenP's contracts.

Documentation Links

Deployment Addresses

Mainnet

USDp is live on the 24 chains listed below.

Ethereum

Contract	Explore
USDp	0x9B3a8f7CEC208e247d97dEE13313690977e24459
FlashParallelToken	0xC9B6279baa19dBB8bCc3250c89cAa093AaBA0bfc
BridgeableUSDp	0x78BB4882b77D74aD9B04Ab71fE8e61f72595823C

Polygon

Contract	Explore
USDp	0x1250304F66404cd153fA39388DDCDAec7E0f1707
FlashParallelToken	0xC15Fd01A21E8f6625f709b16f6b3562d2848Da5f
BridgeableUSDp	0x9aFDB5A5eC2BBDDdAa4573BAA25CAA4e4e4a2CA9

Base

Contract	Explore
USDp	0x76A9A0062ec6712b99B4f63bD2b4270185759dd5
FlashParallelToken	0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182
BridgeableUSDp	0x4Dde0e308CFB60515218C6ad2DF1134Fc48531FC

Optimism

Contract	Explore
USDp	0x90337e484B1Cb02132fc150d3Afa262147348545
FlashParallelToken	0x3EBE332d2AA8cCB5dDc051c9925D9A41708e54D9
BridgeableUSDp	0x76A9A0062ec6712b99B4f63bD2b4270185759dd5

Arbitrum

Contract	Explore
USDp	0x76A9A0062ec6712b99B4f63bD2b4270185759dd5
FlashParallelToken	0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182
BridgeableUSDp	0x4Dde0e308CFB60515218C6ad2DF1134Fc48531FC

Sonic

Contract	Explore
USDp	0x08417cdb7F52a5021bB4eb6E0deAf3f295c3f182
FlashParallelToken	0x2cb56dF31b909854B01D4B1EAd5676cf90e885E7
BridgeableUSDp	0xDa818995DdEee3AC36BF492133E1FeAE1FA377E6

Sei

Contract	Explore
USDp	0x048C4e07D170eEdEE8772cA76AEE1C4e2D133d5c
FlashParallelToken	0xc0e62F863bbD9dab9d2F79e4EcC248e60c4fE3FA
BridgeableUSDp	0x7b54f3D993d3bcA077946034Ea710F9c07420C72

Avalanche

Contract	Explore
USDp	0x9eE1963f05553eF838604Dd39403be21ceF26AA4
FlashParallelToken	0x9e0DCF7a33bBde6689560C5c807dd2a3dF991277
BridgeableUSDp	0x9fFaCB3dB5cB74BdD4C68af3b7CF203130c699ec

BSC

Contract	Explore
USDp	0x048C4e07D170eEdEE8772cA76AEE1C4e2D133d5c
FlashParallelToken	0xc0e62F863bbD9dab9d2F79e4EcC248e60c4fE3FA
BridgeableUSDp	0x7b54f3D993d3bcA077946034Ea710F9c07420C72

Berachain

Contract	Explore
USDp	0x9eE1963f05553eF838604Dd39403be21ceF26AA4
FlashParallelToken	0x9e0DCF7a33bBde6689560C5c807dd2a3dF991277
BridgeableUSDp	0x9fFaCB3dB5cB74BdD4C68af3b7CF203130c699ec

Scroll

Contract	Explore
USDp	0x9eE1963f05553eF838604Dd39403be21ceF26AA4
FlashParallelToken	0x9e0DCF7a33bBde6689560C5c807dd2a3dF991277
BridgeableUSDp	0x9fFaCB3dB5cB74BdD4C68af3b7CF203130c699ec

Gnosis

Contract	Explore
USDp	0x9eE1963f05553eF838604Dd39403be21ceF26AA4
FlashParallelToken	0x9e0DCF7a33bBde6689560C5c807dd2a3dF991277
BridgeableUSDp	0x9fFaCB3dB5cB74BdD4C68af3b7CF203130c699ec

Unichain

Contract	Explore
USDp	0x9eE1963f05553eF838604Dd39403be21ceF26AA4
FlashParallelToken	0x9e0DCF7a33bBde6689560C5c807dd2a3dF991277
BridgeableUSDp	0x9fFaCB3dB5cB74BdD4C68af3b7CF203130c699ec

Ink

Contract	Explore
USDp	0x9eE1963f05553eF838604Dd39403be21ceF26AA4
FlashParallelToken	0x9e0DCF7a33bBde6689560C5c807dd2a3dF991277
BridgeableUSDp	0x9fFaCB3dB5cB74BdD4C68af3b7CF203130c699ec

HyperEVM

Contract	Explore
USDp	0xBE65F0F410A72BeC163dC65d46c83699e957D588
FlashParallelToken	0x15452454A9735D68df430879B2941316a09295B1
BridgeableUSDp	0xC3BEF21Ea7dEB5C34CF33E918c8e28972C8048eD

Tac

Contract	Explore
USDp	0x4DeF531c3060686948f00EcC7504f2E0b71EDa14
FlashParallelToken	0x76A9A0062ec6712b99B4f63bD2b4270185759dd5
BridgeableUSDp	0xB3DbecE41acDD6aD76d037b8Da2e53C58826746c

Plasma

Contract	Explore
USDp	0xC2f8B5d893217462aE9c9879c9285A5a3AAbcb8F
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

xLayer

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Plume

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Katana

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Fraxtal

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Linea

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Hemi

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Worldchain

Contract	Explore
USDp	0x8fCf9118fdD359f6277cDd143c2Da206e64140F3
FlashParallelToken	0x46B053Ce47F16390574Bb8f54cAccd04C1E3Faf2
BridgeableUSDp	0x9E79eC4BC3574f2865636aECFF44B60A723A9eE7

Testnet

Sepolia

Contract	Explore
USDp	0xe8a3DA6f5ed1cf04c58ac7f6A7383641e877517b
FlashParallelToken	0x8B899796b4a442e7723E02f8b5B65a39F27EDAf1
BridgeableUSDp	0xFeFc8635edf0fAAD83312A713Cb67722D049C9Bc

Arbitrum Sepolia

Contract	Explore
USDp	0xA7eb076F57960E265B91514c03d1d1281055a75c
BridgeableUSDp	0xA8FE9843B4Cc2aAB136209B49E2c3E2A7ebD5CFA

Security

Assumptions

Every restricted access is managed by an AccessManager contract following the OpenZeppelin standard
The owner of BridgeableTokenP will be the AccessManager contract or a multisig.

Known Issues

When updating the FlashloanFeeRecipient current fees are not sent to the current recipient before update (to prevent that this function could be restricted with a timelock role on the AccessManager).
In BridgeableTokenP, LZ messages can be received (causing tokens to be credited) even when the contract is paused. DAO must unlink peers with others chains when pausing a BridgeableTokenP.
Fee rate changes can lead to unexpected number of received tokens if fees are updated during an ongoing bridge.
When feesRate=0 in the BridgeableToken, bridge can be done repeatedly to DOS swaps from LZ->Principal token. However, user will still pay fees to LZ.

Audits

Bailsec

Audited by Bailsec in March/April 2025:

Certora

Formal Verification by Certora in March/April 2025:

Development

Foundry

Install foundry follow the instructions.

Install js dependencies

bun install

Setup `.env` file

In order to interact with non local networks, you must create an .env that has:

PRIVATE_KEY="PRIVATE_KEY"
ALCHEMY_API_KEY="ALCHEMY_API_KEY"
MAINNET_ETHERSCAN_API_KEY="MAINNET_ETHERSCAN_API_KEY"

For additional keys, you can check the .env.example file.

Warning: always keep your confidential information safe

Compile contracts

bun run compile

Run tests

bun run test

Slither

bun run slither

You will find other useful commands in the package.json file.

Contributing

If you're interested in contributing, please see our contributions guidelines.

Questions & Feedback

For any question or feedback you can use discord. Don't hesitate to reach out on Twitter as well.

Licensing

The primary license for this repository is the MIT license. See LICENSE. Minus the following exceptions:

tests files are under UNLICENSED license
mocks contracts are under UNLICENSED license

Each of these files states their license type.

Name		Name	Last commit message	Last commit date
.github		.github
.vscode		.vscode
broadcast		broadcast
contracts		contracts
deploy		deploy
deployments		deployments
docs/audits		docs/audits
generated/types		generated/types
layerZero		layerZero
scripts		scripts
tests		tests
typechain-types		typechain-types
utils		utils
.env.example		.env.example
.gitignore		.gitignore
.gitmodules		.gitmodules
.npmrc		.npmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
.solhint.json		.solhint.json
.solhintignore		.solhintignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
bun.lock		bun.lock
foundry.toml		foundry.toml
hardhat.config.ts		hardhat.config.ts
package.json		package.json
remappings.txt		remappings.txt
rocketh.ts		rocketh.ts
slither.config.json		slither.config.json
slither.db.json		slither.db.json
solhint.config.js		solhint.config.js
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

Parallel Tokens

Summary

Architecture

Documentation Links

Deployment Addresses

Mainnet

Ethereum

Polygon

Base

Optimism

Arbitrum

Sonic

Sei

Avalanche

BSC

Berachain

Scroll

Gnosis

Unichain

Ink

HyperEVM

Tac

Plasma

xLayer

Plume

Katana

Fraxtal

Linea

Hemi

Worldchain

Testnet

Sepolia

Arbitrum Sepolia

Security

Assumptions

Known Issues

Audits

Bailsec

Certora

Development

Foundry

Install js dependencies

Setup .env file

Compile contracts

Run tests

Slither

Contributing

Questions & Feedback

Licensing

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages

Setup `.env` file