feat(per): Per solidity sdk (#1325)

* feat(per): add solidity sdk

* refactor(evm): refactor abi generator script

* feat(evm): add abi_generator package

Author: m30m

express_relay/sdk/js/package.json

@@ -2,10 +2,8 @@
   "name": "@pythnetwork/express-relay-evm-js",
   "version": "0.1.1",
   "description": "Utilities for interacting with the express relay protocol",
-  "homepage": "https://pyth.network",
-  "author": {
-    "name": "Pyth Data Association"
-  },
+  "homepage": "https://github.com/pyth-network/pyth-crosschain/tree/main/express_relay/sdk/js",
+  "author": "Douro Labs",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [

express_relay/sdk/solidity/IPERFeeReceiver.sol

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: UNLICENSED
+// Copyright (C) 2024 Lavra Holdings Limited - All Rights Reserved
+pragma solidity ^0.8.0;
+
+interface IPERFeeReceiver {
+    // Receive the proceeds of an auction.
+    // @param permissionKey The permission key where the auction was conducted on.
+    function receiveAuctionProceedings(
+        bytes calldata permissionKey
+    ) external payable;
+}

express_relay/sdk/solidity/IPERMulticall.sol

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: UNLICENSED
+// Copyright (C) 2024 Lavra Holdings Limited - All Rights Reserved
+pragma solidity ^0.8.0;
+
+interface IPERMulticall {
+    // Check if the combination of protocol and permissionKey is allowed within this transaction.
+    // This will return true if and only if it's being called while executing the auction winner call.
+    // @param protocol The address of the protocol that is gating an action behind this permission
+    // @param permissionKey The permission key that is being checked
+    // @return permissioned True if the permission is allowed, false otherwise
+    function isPermissioned(
+        address protocol,
+        bytes calldata permissionKey
+    ) external view returns (bool permissioned);
+}

express_relay/sdk/solidity/README.md

@@ -0,0 +1,27 @@
+# Pyth Express Relay Solidity SDK
+
+## Install
+
+### Truffle/Hardhat
+
+If you are using Truffle or Hardhat, simply install the NPM package:
+
+```bash
+npm install @pythnetwork/per-sdk-solidity
+```
+
+### Foundry
+
+If you are using Foundry, you will need to create an NPM project if you don't already have one.
+From the root directory of your project, run:
+
+```bash
+npm init -y
+npm install @pythnetwork/per-sdk-solidity
+```
+
+Then add the following line to your `remappings.txt` file:
+
+```text
+@pythnetwork/per-sdk-solidity/=node_modules/@pythnetwork/per-sdk-solidity
+```

express_relay/sdk/solidity/abis/IPERFeeReceiver.json

@@ -0,0 +1,15 @@
+[
+  {
+    "inputs": [
+      {
+        "internalType": "bytes",
+        "name": "permissionKey",
+        "type": "bytes"
+      }
+    ],
+    "name": "receiveAuctionProceedings",
+    "outputs": [],
+    "stateMutability": "payable",
+    "type": "function"
+  }
+]

express_relay/sdk/solidity/abis/IPERMulticall.json

@@ -0,0 +1,26 @@
+[
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "protocol",
+        "type": "address"
+      },
+      {
+        "internalType": "bytes",
+        "name": "permissionKey",
+        "type": "bytes"
+      }
+    ],
+    "name": "isPermissioned",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "permissioned",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  }
+]

express_relay/sdk/solidity/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@pythnetwork/per-sdk-solidity",
+  "version": "0.1.0",
+  "description": "Solidity SDK for interacting with Pyth express relay contracts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyth-network/pyth-crosschain",
+    "directory": "express_relay/sdk/solidity"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "format": "npx prettier --write .",
+    "generate-abi": "npx generate-abis IPERMulticall IPERFeeReceiver",
+    "check-abi": "git diff --exit-code abis"
+  },
+  "keywords": [
+    "pyth",
+    "oracle",
+    "relay"
+  ],
+  "author": "Douro Labs",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/pyth-network/pyth-crosschain/issues"
+  },
+  "homepage": "https://github.com/pyth-network/pyth-crosschain/tree/main/express_relay/sdk/solidity",
+  "devDependencies": {
+    "prettier": "^2.7.1",
+    "prettier-plugin-solidity": "^1.0.0-rc.1",
+    "abi_generator": "*"
+  }
+}