@socket.tech/dl-core

Socket DL

The smart contracts that power the Data Layer of Socket. Socket DL is a protocol for generic message passing between chains. It has been designed to be highly configurable so that dapps (plugs) can choose the best tradeoffs for specific use cases.

Local Development

Prereqs

• Foundry
• NodeJS
• Yarn

Setup

Clone project and install dependencies.

# clone the repository
git clone https://github.com/SocketDotTech/socket-dl

# move to repository folder
cd socket-dl

# install forge dependencies
forge install

# install node modules
yarn install

Project Layout

├── contracts
│   └── Contract.sol - Core contracts
|
├── deployments
│   └── <mode>_addresses.json - Latest deployments on multiple chains
|
├── lib
│   └── forge-std - forge dependencies installed as git submodules
|
└── scripts
|   └── contains different scripts needed for deployment, configuration and admin related transactions
|
└── test
|   └── Contract.t.sol - Tests for core contracts
|
└── Files for project setup

Lint

Linter is run automatically before each commit. It can also be triggered manually using yarn lint script.

yarn lint

Test

Tests are run using the Forge tool of Foundry.

yarn test

Deploy

Deployments use Hardhat

Testnet deployments:

bash deploy.sh

• This will store addresses in deployments/ folder in root which are used to configure the contracts later for each remote chain.
• For more detailed deployments, see DEPLOY.md

Publish

To publish, make sure contracts are compiled, run yarn abi. Then publish as normal.

IDE Setup

It is recommended to setup the ide to work with solidity development. In case of VSCode, Solidity and Prettier plugins should work best when configured using following settings -

{
    "solidity.compileUsingRemoteVersion": "v0.8.15+commit.e14f2714",
    "solidity.packageDefaultDependenciesContractsDirectory": "src",
    "solidity.packageDefaultDependenciesDirectory": "lib",
    "editor.formatOnSave": true,
    "[solidity]": {
        "editor.tabSize": 4,
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "solidity.remappings": [
        "forge-std/=lib/forge-std/src/",
        "ds-test/=lib/forge-std/lib/ds-test/src/"
    ],
}

Error Signatures

Error	Signature
OnlyOwner()	0x5fc483c5
OnlyNominee()	0x7c91ccdd
PacketNotProposed()	0x1c936052
InvalidPacketId()	0xb21147c1
InvalidProof()	0x09bde339
MessageAlreadyExecuted()	0x7448c64c
NotExecutor()	0xc32d1d76
VerificationFailed()	0x439cc0cd
ErrInSourceValidation()	0xb39fb5d5
LowGasLimit()	0xd38edae0
InvalidTransmitter()	0x58a70a0a
SwitchboardExists()	0x2dff8555
InvalidConnection()	0x63228f29
NoPermit(bytes32)	0x962f6333
InvalidSigLength()	0xd2453293
ZeroAddress()	0xd92e233d
InvalidTokenAddress()	0x1eb00b06
OnlySocket()	0x503284dc
InvalidNonce()	0x756688fe
MsgValueTooLow()	0x508aaf00
MsgValueTooHigh()	0x5dffc92f
InsufficientMsgValue()	0x78f38f76
InsufficientFees()	0x8d53e553
InvalidMsgValue()	0x1841b4e1
FeesTooHigh()	0xc9034e18
PayloadTooLarge()	0x492f620d
InvalidBatchSize()	0x7862e959
InsufficientMessageLength()	0xbcfdc01d
InvalidPacketLength()	0x5a375a8e
PacketLengthNotAllowed()	0x83d360ad
WatcherFound()	0xa080b558
WatcherNotFound()	0xa278e4ad
AlreadyAttested()	0x35d90805
InvalidRole()	0xd954416a
InvalidRoot()	0x504570e3
UnequalArrayLengths()	0x11e86f73
InvalidCapacitorType()	0x39354089
OnlyExecutionManager()	0x03c377c5
InvalidCapacitorAddress()	0x73d817fb
PlugDisconnected()	0xe741bafb
NoPendingPacket()	0xa9023923
FeesNotEnough()	0x217b529e
AlreadyInitialized()	0x0dc149f0
InvalidSender()	0xddb5de5e
NoRootFound()	0x849713b0

Contributing

We really appreciate and value any form of contribution to Socket Data Layer Contracts. As a contributor, you are expected to fork this repository, work on your own fork and then submit pull requests. The PRs are expected to have a proper description to make reviewing easy. The code is expected to be properly linted and tested.

Smart contracts manage value and are highly vulnerable to errors and attacks. We have very strict guidlines, please make sure to follow these -

Simple and Modular

We look for small files, small contracts, and small functions. If you can separate a contract into two independent functionalities you should probably do it.

Naming Matters

We take our time with picking names. Code is going to be written once, and read hundreds of times. Renaming for clarity is encouraged. If any function or variable changes its intention, an accompanying name change is expected.

Tests

Write tests for all your code. We encourage Test Driven Development so we know when our code is right. When writing tests ask yourself what is expected to be true before and after a function call. And perform explicit checks for those conditions. Write helper functions to make the tests as short and concise as possible.

Code Consistency

The codebase should be as unified as possible. Read existing code and get inspired before you write your own. Don’t hesitate to ask for help on how to best write a specific piece of code.

Code Style

In order to be consistent with all the other Solidity projects, we follow the official recommendations documented in the Solidity style guide. Any exception or additions specific to our project are documented below.

• Try to avoid acronyms and abbreviations.
• All state variables should be private/internal. Write explicit getter functions where needed.
• All private and internal variables/functions should have an underscore prefix.

uint256 private _foo;
function _bar() internal {
    ...
}

• All function parameters should have an underscore postfix.

function foo(uint256 bar_) external {
    ...
}

• Contract instances should have double underscore postfix.

function foo() external {
    Bar bar__ = Bar(barAddress);
}

• Events should be emitted immediately after the state change that they represent, and consequently they should be named in past tense (when not in conflict with defined standard eg. ERC20).

function _burn(address who, uint256 value) internal {
    super._burn(who, value);
    emit TokensBurned(who, value);
}