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);
}