From cbcc97b5af713cd1a8a5a091921f58fe1bf64911 Mon Sep 17 00:00:00 2001 From: yangfang <49144942+JyFangYang@users.noreply.github.com> Date: Tue, 6 Aug 2024 20:07:10 +0800 Subject: [PATCH] (client&connection): init client&connection&account code (#3) --- build.gradle | 12 +- gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes settings.gradle | 9 + .../stub/web3/Web3BaseStubFactory.java | 61 +++ .../wecross/stub/web3/Web3Connection.java | 393 ++++++++++++++++++ .../stub/web3/Web3ConnectionFactory.java | 26 ++ .../wecross/stub/web3/Web3StubFactory.java | 12 +- .../stub/web3/account/Web3Account.java | 70 ++++ .../stub/web3/account/Web3AccountFactory.java | 108 +++++ .../stub/web3/client/ClientWrapper.java | 34 ++ .../web3/client/ClientWrapperFactory.java | 14 + .../stub/web3/client/ClientWrapperImpl.java | 165 ++++++++ .../wecross/stub/web3/common/LRUCache.java | 18 + .../stub/web3/common/ObjectMapperFactory.java | 30 ++ .../stub/web3/common/Web3Constant.java | 18 + .../stub/web3/common/Web3RequestType.java | 9 + .../stub/web3/common/Web3StatusCode.java | 83 ++++ .../stub/web3/common/Web3StubException.java | 9 + .../wecross/stub/web3/common/Web3Toml.java | 24 ++ .../web3/config/AbstractWeb3ConfigParser.java | 31 ++ .../stub/web3/config/Web3AccountConfig.java | 84 ++++ .../web3/config/Web3AccountConfigParser.java | 25 ++ .../stub/web3/config/Web3StubConfig.java | 176 ++++++++ .../web3/config/Web3StubConfigParser.java | 25 ++ .../protocol/request/TransactionParams.java | 116 ++++++ .../protocol/response/TransactionPair.java | 42 ++ src/main/resources/stub.toml | 19 + 27 files changed, 1603 insertions(+), 10 deletions(-) create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 settings.gradle create mode 100644 src/main/java/com/webank/wecross/stub/web3/Web3BaseStubFactory.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/Web3Connection.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/Web3ConnectionFactory.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/account/Web3Account.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/account/Web3AccountFactory.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/client/ClientWrapper.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperFactory.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperImpl.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/LRUCache.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/ObjectMapperFactory.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/Web3Constant.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/Web3RequestType.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/Web3StatusCode.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/Web3StubException.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/common/Web3Toml.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/config/AbstractWeb3ConfigParser.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfig.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfigParser.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfig.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfigParser.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/protocol/request/TransactionParams.java create mode 100644 src/main/java/com/webank/wecross/stub/web3/protocol/response/TransactionPair.java create mode 100644 src/main/resources/stub.toml diff --git a/build.gradle b/build.gradle index be140b2..cf03a44 100644 --- a/build.gradle +++ b/build.gradle @@ -90,6 +90,9 @@ dependencies { exclude group: "io.netty" exclude group: 'org.fisco-bcos', module: 'tcnative' } + + implementation 'org.web3j:core:4.9.8' + // implementation('org.fisco-bcos.java-sdk:fisco-bcos-sdk-abi:2.10.0-SNAPSHOT') // Use JUnit test framework @@ -124,15 +127,8 @@ sourceSets { shadowJar { dependsOn(copyHooks) - dependencies { - //排除掉io.netty:.*，不打包进fat jar - exclude(dependency('io.netty:.*')) - } mergeServiceFiles() - minimize{ - //不优化处理io.grpc:.*，直接打进fat jar - exclude(dependency('io.grpc:.*')) - } + minimize() } diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..f3d88b1c2faf2fc91d853cd5d4242b5547257070 GIT binary patch literal 58695 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 literal 0 HcmV?d00001 diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..98d0a7f --- /dev/null +++ b/settings.gradle @@ -0,0 +1,9 @@ +pluginManagement { + repositories { + maven { + url 'https://maven.aliyun.com/repository/gradle-plugin' + } + gradlePluginPortal() + } +} +rootProject.name = 'WeCross-Web3-Stub' \ No newline at end of file diff --git a/src/main/java/com/webank/wecross/stub/web3/Web3BaseStubFactory.java b/src/main/java/com/webank/wecross/stub/web3/Web3BaseStubFactory.java new file mode 100644 index 0000000..945be0b --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/Web3BaseStubFactory.java @@ -0,0 +1,61 @@ +package com.webank.wecross.stub.web3; + +import com.webank.wecross.stub.Account; +import com.webank.wecross.stub.Connection; +import com.webank.wecross.stub.Driver; +import com.webank.wecross.stub.StubFactory; +import com.webank.wecross.stub.WeCrossContext; +import com.webank.wecross.stub.web3.account.Web3AccountFactory; +import com.webank.wecross.stub.web3.common.Web3Constant; +import java.util.Map; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Web3BaseStubFactory implements StubFactory { + private static final Logger logger = LoggerFactory.getLogger(Web3BaseStubFactory.class); + + @Override + public void init(WeCrossContext weCrossContext) {} + + @Override + public Driver newDriver() { + return null; + } + + @Override + public Connection newConnection(String path) { + try { + logger.info("New connection: {}", path); + Web3Connection connection = Web3ConnectionFactory.build(path, Web3Constant.STUB_TOML_NAME); + + // check proxy contract + if (!connection.hasProxyDeployed()) { + String errorMsg = "WeCrossProxy error: WeCrossProxy contract has not been deployed!"; + System.out.println(errorMsg); + throw new Exception(errorMsg); + } + + // check hub contract + if (!connection.hasHubDeployed()) { + String errorMsg = "WeCrossHub error: WeCrossHub contract has not been deployed!"; + System.out.println(errorMsg); + throw new Exception(errorMsg); + } + return connection; + } catch (Exception e) { + logger.error("New connection fail, e: ", e); + return null; + } + } + + @Override + public Account newAccount(Map properties) { + return Web3AccountFactory.build(properties); + } + + @Override + public void generateAccount(String path, String[] args) {} + + @Override + public void generateConnection(String path, String[] args) {} +} diff --git a/src/main/java/com/webank/wecross/stub/web3/Web3Connection.java b/src/main/java/com/webank/wecross/stub/web3/Web3Connection.java new file mode 100644 index 0000000..f61145c --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/Web3Connection.java @@ -0,0 +1,393 @@ +package com.webank.wecross.stub.web3; + +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.SerializationFeature; +import com.moandjiezana.toml.Toml; +import com.webank.wecross.stub.Connection; +import com.webank.wecross.stub.Request; +import com.webank.wecross.stub.ResourceInfo; +import com.webank.wecross.stub.Response; +import com.webank.wecross.stub.web3.client.ClientWrapper; +import com.webank.wecross.stub.web3.client.ClientWrapperImpl; +import com.webank.wecross.stub.web3.common.ObjectMapperFactory; +import com.webank.wecross.stub.web3.common.Web3Constant; +import com.webank.wecross.stub.web3.common.Web3RequestType; +import com.webank.wecross.stub.web3.common.Web3StatusCode; +import com.webank.wecross.stub.web3.config.Web3StubConfig; +import com.webank.wecross.stub.web3.protocol.request.TransactionParams; +import com.webank.wecross.stub.web3.protocol.response.TransactionPair; +import java.io.IOException; +import java.math.BigInteger; +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.ScheduledThreadPoolExecutor; +import java.util.concurrent.TimeUnit; +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.io.Resource; +import org.springframework.core.io.support.PathMatchingResourcePatternResolver; +import org.springframework.scheduling.concurrent.CustomizableThreadFactory; +import org.web3j.crypto.RawTransaction; +import org.web3j.crypto.TransactionDecoder; +import org.web3j.protocol.core.methods.response.EthBlock; +import org.web3j.protocol.core.methods.response.EthCall; +import org.web3j.protocol.core.methods.response.EthSendTransaction; +import org.web3j.protocol.core.methods.response.Transaction; +import org.web3j.protocol.core.methods.response.TransactionReceipt; + +public class Web3Connection implements Connection { + private static final Logger logger = LoggerFactory.getLogger(Web3Connection.class); + public static final String RECEIPT_SUCCESS = "0x1"; + + private final ObjectMapper objectMapper = ObjectMapperFactory.getObjectMapper(); + private List resourceInfoList = new ArrayList<>(); + private ConnectionEventHandler eventHandler; + private final Map properties = new HashMap<>(); + private final ClientWrapper clientWrapper; + private final BigInteger chainId; + private final String stubConfigFilePath; + private long stubConfigFileLastModified; + + public Web3Connection(ClientWrapper clientWrapper, Web3StubConfig web3StubConfig) + throws IOException { + this.objectMapper.disable(SerializationFeature.FAIL_ON_EMPTY_BEANS); + this.clientWrapper = clientWrapper; + this.chainId = clientWrapper.ethChainId(); + this.stubConfigFilePath = web3StubConfig.getStubConfigPath(); + // init + refreshStubConfig(web3StubConfig); + + // refresh + ScheduledExecutorService executorService = + new ScheduledThreadPoolExecutor(1, new CustomizableThreadFactory("refreshStubConfig-")); + executorService.scheduleAtFixedRate( + () -> { + try { + PathMatchingResourcePatternResolver resolver = + new PathMatchingResourcePatternResolver(); + Resource resource = resolver.getResource(stubConfigFilePath); + long lastModified = resource.getFile().lastModified(); + if (Objects.equals(stubConfigFileLastModified, lastModified)) { + return; + } + Web3StubConfig newWeb3StubConfig = + new Toml().read(resource.getInputStream()).to(Web3StubConfig.class); + newWeb3StubConfig.setStubConfigPath(stubConfigFilePath); + // changed + refreshStubConfig(newWeb3StubConfig); + if (Objects.nonNull(eventHandler)) { + // refresh remote resource + eventHandler.onResourcesChange(resourceInfoList); + } + this.stubConfigFileLastModified = lastModified; + } catch (IOException e) { + logger.error("refreshStubConfig Exception:", e); + } + }, + 30000, + 30000, + TimeUnit.MILLISECONDS); + } + + @Override + public void asyncSend(Request request, Callback callback) { + // request type + int type = request.getType(); + if (type == Web3RequestType.CALL) { + // constantCall constantCallWithXa + handleAsyncCallRequest(request, callback); + } else if (type == Web3RequestType.SEND_TRANSACTION) { + // sendTransaction sendTransactionWithXa + handleAsyncTransactionRequest(request, callback); + } else if (type == Web3RequestType.GET_BLOCK_NUMBER) { + handleAsyncGetBlockNumberRequest(callback); + } else if (type == Web3RequestType.GET_BLOCK_BY_NUMBER) { + handleAsyncGetBlockRequest(request, callback); + } else if (type == Web3RequestType.GET_TRANSACTION) { + handleAsyncGetTransaction(request, callback); + } else { + logger.warn(" unrecognized request type, type: {}", request.getType()); + Response response = new Response(); + response.setErrorCode(Web3StatusCode.UnrecognizedRequestType); + response.setErrorMessage( + Web3StatusCode.getStatusMessage(Web3StatusCode.UnrecognizedRequestType) + + " ,type: " + + request.getType()); + callback.onResponse(response); + } + } + + @Override + public Map getProperties() { + return properties; + } + + @Override + public void setConnectionEventHandler(ConnectionEventHandler eventHandler) { + this.eventHandler = eventHandler; + } + + private void handleAsyncGetTransaction(Request request, Callback callback) { + Response response = new Response(); + response.setErrorCode(Web3StatusCode.Success); + response.setErrorMessage(Web3StatusCode.getStatusMessage(Web3StatusCode.Success)); + try { + String transactionHash = new String(request.getData(), StandardCharsets.UTF_8); + Transaction transaction = clientWrapper.ethGetTransactionByHash(transactionHash); + TransactionReceipt transactionReceipt = + clientWrapper.ethGetTransactionReceipt(transactionHash); + + // transaction or transactionReceipt is null + if (Objects.isNull(transaction) + || Objects.isNull(transaction.getHash()) + || Objects.isNull(transactionReceipt) + || Objects.isNull(transactionReceipt.getTransactionHash())) { + response.setErrorCode(Web3StatusCode.TransactionNotExist); + response.setErrorMessage("transaction not found, tx hash: " + transactionHash); + return; + } + + // transaction is revert + String receiptStatus = transactionReceipt.getStatus(); + String revertReason = transactionReceipt.getRevertReason(); + if (!Objects.equals(receiptStatus, RECEIPT_SUCCESS) && StringUtils.isBlank(revertReason)) { + if (clientWrapper instanceof ClientWrapperImpl) { + ClientWrapperImpl clientWrapperImpl = (ClientWrapperImpl) clientWrapper; + clientWrapperImpl.extractRevertReason(transactionReceipt, transaction.getInput()); + } + } + response.setData( + objectMapper.writeValueAsBytes(new TransactionPair(transaction, transactionReceipt))); + + if (logger.isDebugEnabled()) { + logger.debug( + "handleAsyncGetTransaction, tx hash: {}, transaction: {}, transactionReceipt: {}", + transactionHash, + transaction, + transactionReceipt); + } + } catch (Exception e) { + logger.error("handleAsyncGetTransaction Exception, e: ", e); + response.setErrorCode(Web3StatusCode.HandleGetTransactionFailed); + response.setErrorMessage(e.getMessage()); + } finally { + callback.onResponse(response); + } + } + + private void handleAsyncGetBlockRequest(Request request, Callback callback) { + Response response = new Response(); + response.setErrorCode(Web3StatusCode.Success); + response.setErrorMessage(Web3StatusCode.getStatusMessage(Web3StatusCode.Success)); + try { + BigInteger blockNumber = new BigInteger(request.getData()); + if (logger.isDebugEnabled()) { + logger.debug("handleAsyncGetBlockRequest,blockNumber: {}", blockNumber); + } + // from chain + EthBlock.Block block = clientWrapper.ethGetBlockByNumber(blockNumber); + + // block is null + if (Objects.isNull(block)) { + response.setErrorCode(Web3StatusCode.BlockNotExist); + response.setErrorMessage(Web3StatusCode.getStatusMessage(Web3StatusCode.BlockNotExist)); + return; + } + + response.setData(objectMapper.writeValueAsBytes(block)); + if (logger.isDebugEnabled()) { + logger.debug("handleAsyncGetBlockRequest,blockNumber: {}, block: {}", blockNumber, block); + } + } catch (Exception e) { + logger.error("handleAsyncGetBlockRequest Exception, e: ", e); + response.setErrorCode(Web3StatusCode.HandleGetBlockFailed); + response.setErrorMessage(e.getMessage()); + } finally { + callback.onResponse(response); + } + } + + private void handleAsyncGetBlockNumberRequest(Callback callback) { + Response response = new Response(); + response.setErrorCode(Web3StatusCode.Success); + response.setErrorMessage(Web3StatusCode.getStatusMessage(Web3StatusCode.Success)); + try { + BigInteger blockNumber = clientWrapper.ethBlockNumber(); + if (logger.isDebugEnabled()) { + logger.debug("handleAsyncGetBlockNumberRequest,blockNumber: {}", blockNumber); + } + + response.setData(blockNumber.toByteArray()); + } catch (Exception e) { + logger.error("handleGetBlockNumberRequest Exception, e: ", e); + response.setErrorCode(Web3StatusCode.HandleGetBlockNumberFailed); + response.setErrorMessage(e.getMessage()); + } finally { + callback.onResponse(response); + } + } + + private void handleAsyncCallRequest(Request request, Callback callback) { + Response response = new Response(); + response.setErrorCode(Web3StatusCode.Success); + response.setErrorMessage(Web3StatusCode.getStatusMessage(Web3StatusCode.Success)); + try { + TransactionParams transactionParams = + objectMapper.readValue(request.getData(), TransactionParams.class); + if (logger.isDebugEnabled()) { + logger.debug("handleAsyncCallRequest: {}", transactionParams); + } + String from = transactionParams.getFrom(); + String to = transactionParams.getTo(); + String data = transactionParams.getData(); + BigInteger nonce = clientWrapper.getNonce(from); + + // build Transaction + org.web3j.protocol.core.methods.request.Transaction transaction = + org.web3j.protocol.core.methods.request.Transaction.createEthCallTransaction( + from, to, data); + EthCall ethCall = clientWrapper.ethCall(transaction); + + // ethCall has error + if (ethCall.hasError()) { + response.setErrorCode(Web3StatusCode.CallNotSuccessStatus); + response.setErrorMessage(ethCall.getError().getMessage()); + return; + } + + response.setData(objectMapper.writeValueAsBytes(ethCall)); + } catch (Exception e) { + logger.error("handleAsyncCallRequest Exception:", e); + response.setErrorCode(Web3StatusCode.HandleCallRequestFailed); + response.setErrorMessage(e.getMessage()); + } finally { + callback.onResponse(response); + } + } + + private void handleAsyncTransactionRequest(Request request, Callback callback) { + Response response = new Response(); + response.setErrorCode(Web3StatusCode.Success); + response.setErrorMessage(Web3StatusCode.getStatusMessage(Web3StatusCode.Success)); + try { + TransactionParams transactionParams = + objectMapper.readValue(request.getData(), TransactionParams.class); + if (logger.isDebugEnabled()) { + logger.debug("handleAsyncTransactionRequest: {}", transactionParams); + } + + // send transaction + String signedTransactionData = transactionParams.getData(); + EthSendTransaction ethSendTransaction = + clientWrapper.ethSendRawTransaction(signedTransactionData); + + // ethSendTransaction has error + if (ethSendTransaction.hasError()) { + response.setErrorCode(Web3StatusCode.SendTransactionNotSuccessStatus); + response.setErrorMessage(ethSendTransaction.getError().getMessage()); + return; + } + + // get transactionReceipt + String transactionHash = ethSendTransaction.getTransactionHash(); + TransactionReceipt transactionReceipt = + clientWrapper.ethGetTransactionReceipt(transactionHash); + + // transactionReceipt is null + if (Objects.isNull(transactionReceipt)) { + response.setErrorCode(Web3StatusCode.TransactionReceiptNotExist); + response.setErrorMessage( + Web3StatusCode.getStatusMessage(Web3StatusCode.TransactionReceiptNotExist)); + return; + } + + // transaction is revert + String receiptStatus = transactionReceipt.getStatus(); + if (!Objects.equals(receiptStatus, RECEIPT_SUCCESS)) { + // decode revertReason + String revertReason = transactionReceipt.getRevertReason(); + if (StringUtils.isBlank(revertReason)) { + if (clientWrapper instanceof ClientWrapperImpl) { + ClientWrapperImpl clientWrapperImpl = (ClientWrapperImpl) clientWrapper; + RawTransaction originalRawTransaction = + TransactionDecoder.decode(signedTransactionData); + revertReason = + clientWrapperImpl.extractRevertReason( + transactionReceipt, originalRawTransaction.getData()); + } + } + response.setErrorCode(Web3StatusCode.SendTransactionNotSuccessStatus); + response.setErrorMessage(revertReason); + return; + } + + response.setData(objectMapper.writeValueAsBytes(transactionReceipt)); + } catch (Exception e) { + logger.error("handleAsyncTransactionRequest Exception:", e); + response.setErrorCode(Web3StatusCode.HandleSendTransactionFailed); + response.setErrorMessage(e.getMessage()); + } finally { + callback.onResponse(response); + } + } + + private synchronized void refreshStubConfig(Web3StubConfig web3StubConfig) throws IOException { + this.resourceInfoList = web3StubConfig.convertToResourceInfos(); + + addProperty(Web3Constant.WEB3_PROPERTY_CHAIN_ID, chainId.toString()); + addProperty(Web3Constant.WEB3_PROPERTY_STUB_TYPE, web3StubConfig.getCommon().getType()); + addProperty(Web3Constant.WEB3_PROPERTY_CHAIN_URL, web3StubConfig.getService().getUrl()); + List resources = web3StubConfig.getResources(); + if (!resources.isEmpty()) { + for (Web3StubConfig.Resource resource : resources) { + String name = resource.getName(); + // name->address + this.addProperty(name, resource.getAddress()); + // name+ABI->abi + this.addAbi(name, resource.getAbi()); + } + } + } + + public boolean hasProxyDeployed() { + return getProperties().containsKey(Web3Constant.WEB3_PROXY_NAME); + } + + public boolean hasHubDeployed() { + return getProperties().containsKey(Web3Constant.WEB3_HUB_NAME); + } + + public List getResourceInfoList() { + return resourceInfoList; + } + + public void addProperty(String key, String value) { + this.properties.put(key, value); + } + + public String getProperty(String key) { + return this.properties.get(key); + } + + public void addAbi(String key, String value) { + addProperty(key + Web3Constant.WEB3_PROPERTY_ABI_SUFFIX, value); + } + + public String getAbi(String key) { + return getProperty(key + Web3Constant.WEB3_PROPERTY_ABI_SUFFIX); + } + + public ClientWrapper getClientWrapper() { + return clientWrapper; + } + + public BigInteger getChainId() { + return chainId; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/Web3ConnectionFactory.java b/src/main/java/com/webank/wecross/stub/web3/Web3ConnectionFactory.java new file mode 100644 index 0000000..64865fa --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/Web3ConnectionFactory.java @@ -0,0 +1,26 @@ +package com.webank.wecross.stub.web3; + +import com.webank.wecross.stub.web3.client.ClientWrapper; +import com.webank.wecross.stub.web3.client.ClientWrapperFactory; +import com.webank.wecross.stub.web3.config.Web3StubConfig; +import com.webank.wecross.stub.web3.config.Web3StubConfigParser; +import java.io.IOException; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Web3ConnectionFactory { + private static final Logger logger = LoggerFactory.getLogger(Web3ConnectionFactory.class); + + public static Web3Connection build(String stubConfigPath, String configName) throws Exception { + Web3StubConfigParser web3StubConfigParser = + new Web3StubConfigParser(stubConfigPath, configName); + Web3StubConfig web3StubConfig = web3StubConfigParser.loadConfig(); + return build(web3StubConfig); + } + + public static Web3Connection build(Web3StubConfig web3StubConfig) throws IOException { + logger.info("web3StubConfig: {}", web3StubConfig); + ClientWrapper clientWrapper = ClientWrapperFactory.createClientWrapperInstance(web3StubConfig); + return new Web3Connection(clientWrapper, web3StubConfig); + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/Web3StubFactory.java b/src/main/java/com/webank/wecross/stub/web3/Web3StubFactory.java index 4e54558..b3b8972 100644 --- a/src/main/java/com/webank/wecross/stub/web3/Web3StubFactory.java +++ b/src/main/java/com/webank/wecross/stub/web3/Web3StubFactory.java @@ -1,9 +1,17 @@ package com.webank.wecross.stub.web3; +import static com.webank.wecross.stub.web3.common.Web3Constant.WEB3_STUB_TYPE; + +import com.webank.wecross.stub.Stub; import org.slf4j.Logger; import org.slf4j.LoggerFactory; -public class Web3StubFactory { - private final Logger logger = LoggerFactory.getLogger(Web3StubFactory.class); +@Stub(WEB3_STUB_TYPE) +public class Web3StubFactory extends Web3BaseStubFactory { + private static final Logger logger = LoggerFactory.getLogger(Web3StubFactory.class); + public static void main(String[] args) { + System.out.printf( + "This is %s Stub Plugin. Please copy this file to router/plugin/%n", WEB3_STUB_TYPE); + } } diff --git a/src/main/java/com/webank/wecross/stub/web3/account/Web3Account.java b/src/main/java/com/webank/wecross/stub/web3/account/Web3Account.java new file mode 100644 index 0000000..17dd966 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/account/Web3Account.java @@ -0,0 +1,70 @@ +package com.webank.wecross.stub.web3.account; + +import com.webank.wecross.stub.Account; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.web3j.crypto.Credentials; +import org.web3j.utils.Numeric; + +public class Web3Account implements Account { + private static final Logger logger = LoggerFactory.getLogger(Web3Account.class); + + private final String name; + private final String type; + private final String identity; + private int keyID; + private boolean isDefault; + + private final String publicKey; + private final Credentials credentials; + + public Web3Account(String name, String type, Credentials credentials) { + this.name = name; + this.type = type; + this.identity = credentials.getAddress(); + this.credentials = credentials; + this.publicKey = Numeric.toHexStringNoPrefix(credentials.getEcKeyPair().getPublicKey()); + logger.info(" name: {}, type: {}, publicKey: {}", name, type, publicKey); + } + + public Credentials getCredentials() { + return credentials; + } + + public String getPublicKey() { + return publicKey; + } + + public void setKeyID(int keyID) { + this.keyID = keyID; + } + + public void setDefault(boolean aDefault) { + isDefault = aDefault; + } + + @Override + public String getName() { + return name; + } + + @Override + public String getType() { + return type; + } + + @Override + public String getIdentity() { + return identity; + } + + @Override + public int getKeyID() { + return keyID; + } + + @Override + public boolean isDefault() { + return isDefault; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/account/Web3AccountFactory.java b/src/main/java/com/webank/wecross/stub/web3/account/Web3AccountFactory.java new file mode 100644 index 0000000..d836af6 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/account/Web3AccountFactory.java @@ -0,0 +1,108 @@ +package com.webank.wecross.stub.web3.account; + +import com.webank.wecross.stub.web3.common.Web3Constant; +import com.webank.wecross.stub.web3.config.Web3AccountConfig; +import com.webank.wecross.stub.web3.config.Web3AccountConfigParser; +import java.io.IOException; +import java.util.Map; +import java.util.Objects; +import org.apache.commons.lang3.StringUtils; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.core.io.Resource; +import org.springframework.core.io.support.PathMatchingResourcePatternResolver; +import org.springframework.core.io.support.ResourcePatternResolver; +import org.web3j.crypto.CipherException; +import org.web3j.crypto.Credentials; +import org.web3j.crypto.WalletUtils; + +public class Web3AccountFactory { + private static final Logger logger = LoggerFactory.getLogger(Web3AccountFactory.class); + + public static Web3Account build(Map properties) { + String username = (String) properties.get("username"); + Integer keyID = (Integer) properties.get("keyID"); + String type = (String) properties.get("type"); + Boolean isDefault = (Boolean) properties.get("isDefault"); + String secKey = (String) properties.get("secKey"); + String pubKey = (String) properties.get("pubKey"); + String address = (String) properties.get("ext0"); + + if (StringUtils.isBlank(username)) { + logger.error("username has not given"); + return null; + } + + if (keyID == null) { + logger.error("keyID has not given"); + return null; + } + + if (StringUtils.isBlank(type)) { + logger.error("type has not given"); + return null; + } + + if (isDefault == null) { + logger.error("isDefault has not given"); + return null; + } + + if (StringUtils.isBlank(secKey)) { + logger.error("secKey has not given"); + return null; + } + + if (StringUtils.isBlank(pubKey)) { + logger.error("pubKey has not given"); + return null; + } + + if (StringUtils.isBlank(address)) { + logger.error("address has not given in ext0"); + return null; + } + + try { + // build credentials from privateKey + Credentials credentials = Credentials.create(secKey); + Web3Account web3Account = new Web3Account(username, type, credentials); + + // check publicKey + if (!Objects.equals(web3Account.getPublicKey(), pubKey)) { + throw new Exception("Given pubKey is not belongs to the secKey of " + username); + } + + // check address + if (!Objects.equals(web3Account.getIdentity(), address)) { + throw new Exception("Given address is not belongs to the secKey of " + username); + } + return web3Account; + } catch (Exception e) { + logger.error("build account exception: {}", e.getMessage()); + return null; + } + } + + public Web3Account build(String name, String accountPath) throws IOException, CipherException { + Web3AccountConfigParser parser = + new Web3AccountConfigParser(accountPath, Web3Constant.ACCOUNT_TOML_NAME); + Web3AccountConfig web3AccountConfig = parser.loadConfig(); + Web3AccountConfig.Account account = web3AccountConfig.getAccount(); + String type = account.getType(); + String accountFile = account.getAccountFile(); + String password = account.getPassword(); + + ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); + Resource accountFileResource = resolver.getResource(accountFile); + + Credentials credentials; + + if (StringUtils.endsWith(accountFile, ".json")) { + credentials = WalletUtils.loadCredentials(password, accountFileResource.getFile()); + } else { + return null; + } + return new Web3Account(name, type, credentials); + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapper.java b/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapper.java new file mode 100644 index 0000000..45e3e59 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapper.java @@ -0,0 +1,34 @@ +package com.webank.wecross.stub.web3.client; + +import java.io.IOException; +import java.math.BigInteger; +import org.web3j.protocol.core.methods.response.EthBlock; +import org.web3j.protocol.core.methods.response.EthCall; +import org.web3j.protocol.core.methods.response.EthSendTransaction; +import org.web3j.protocol.core.methods.response.Transaction; +import org.web3j.protocol.core.methods.response.TransactionReceipt; + +/** Wrapper interface for JavaSDK */ +public interface ClientWrapper { + + EthBlock.Block ethGetBlockByNumber(BigInteger blockNumber) throws IOException; + + BigInteger ethBlockNumber() throws IOException; + + EthSendTransaction ethSendRawTransaction(String signedTransactionData) throws IOException; + + TransactionReceipt ethGetTransactionReceipt(String transactionHash) throws Exception; + + Transaction ethGetTransactionByHash(String transactionHash) throws IOException; + + EthCall ethCall(org.web3j.protocol.core.methods.request.Transaction transaction) + throws IOException; + + BigInteger getNonce(String address) throws IOException; + + BigInteger ethChainId() throws IOException; + + BigInteger ethGasPrice() throws IOException; + + BigInteger ethGasLimit() throws IOException; +} diff --git a/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperFactory.java b/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperFactory.java new file mode 100644 index 0000000..e05dd16 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperFactory.java @@ -0,0 +1,14 @@ +package com.webank.wecross.stub.web3.client; + +import com.webank.wecross.stub.web3.config.Web3StubConfig; +import org.web3j.protocol.Web3j; +import org.web3j.protocol.http.HttpService; + +public class ClientWrapperFactory { + + public static ClientWrapper createClientWrapperInstance(Web3StubConfig web3StubConfig) { + String url = web3StubConfig.getService().getUrl(); + Web3j web3j = Web3j.build(new HttpService(url)); + return new ClientWrapperImpl(web3j); + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperImpl.java b/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperImpl.java new file mode 100644 index 0000000..fc7cb72 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/client/ClientWrapperImpl.java @@ -0,0 +1,165 @@ +package com.webank.wecross.stub.web3.client; + +import com.webank.wecross.stub.web3.common.LRUCache; +import java.io.IOException; +import java.math.BigInteger; +import java.util.Objects; +import java.util.Optional; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.web3j.protocol.Web3j; +import org.web3j.protocol.core.DefaultBlockParameter; +import org.web3j.protocol.core.DefaultBlockParameterName; +import org.web3j.protocol.core.methods.response.EthBlock; +import org.web3j.protocol.core.methods.response.EthCall; +import org.web3j.protocol.core.methods.response.EthGetTransactionCount; +import org.web3j.protocol.core.methods.response.EthGetTransactionReceipt; +import org.web3j.protocol.core.methods.response.EthSendTransaction; +import org.web3j.protocol.core.methods.response.Transaction; +import org.web3j.protocol.core.methods.response.TransactionReceipt; +import org.web3j.utils.RevertReasonExtractor; + +public class ClientWrapperImpl implements ClientWrapper { + private static final Logger logger = LoggerFactory.getLogger(ClientWrapperImpl.class); + + private static final int SLEEP_DURATION = 2000; + private static final int ATTEMPTS = 40; + + private final Web3j web3j; + + private final LRUCache blockLRUCache = new LRUCache<>(100); + private final LRUCache transactionReceiptLRUCache = + new LRUCache<>(100); + private final LRUCache transactionLRUCache = new LRUCache<>(100); + + public ClientWrapperImpl(Web3j web3j) { + this.web3j = web3j; + } + + @Override + public EthBlock.Block ethGetBlockByNumber(BigInteger blockNumber) throws IOException { + EthBlock.Block block = blockLRUCache.get(blockNumber); + if (Objects.nonNull(block)) { + return block; + } + block = + web3j + .ethGetBlockByNumber(DefaultBlockParameter.valueOf(blockNumber), true) + .send() + .getBlock(); + if (Objects.nonNull(block)) { + blockLRUCache.put(blockNumber, block); + } + return block; + } + + @Override + public BigInteger ethBlockNumber() throws IOException { + return web3j.ethBlockNumber().send().getBlockNumber(); + } + + @Override + public EthSendTransaction ethSendRawTransaction(String signedTransactionData) throws IOException { + return web3j.ethSendRawTransaction(signedTransactionData).send(); + } + + @Override + public TransactionReceipt ethGetTransactionReceipt(String transactionHash) throws Exception { + TransactionReceipt transactionReceipt = transactionReceiptLRUCache.get(transactionHash); + if (Objects.nonNull(transactionReceipt)) { + return transactionReceipt; + } + transactionReceipt = waitForTransactionReceipt(transactionHash, SLEEP_DURATION, ATTEMPTS); + if (Objects.nonNull(transactionReceipt)) { + transactionReceiptLRUCache.put(transactionHash, transactionReceipt); + } + return transactionReceipt; + } + + @Override + public Transaction ethGetTransactionByHash(String transactionHash) throws IOException { + Transaction transaction = transactionLRUCache.get(transactionHash); + if (Objects.nonNull(transaction)) { + return transaction; + } + Optional optionalTransaction = + web3j.ethGetTransactionByHash(transactionHash).send().getTransaction(); + if (optionalTransaction.isPresent()) { + transaction = optionalTransaction.get(); + transactionLRUCache.put(transactionHash, transaction); + } + return transaction; + } + + @Override + public EthCall ethCall(org.web3j.protocol.core.methods.request.Transaction transaction) + throws IOException { + return web3j.ethCall(transaction, DefaultBlockParameterName.LATEST).send(); + } + + @Override + public BigInteger getNonce(String address) throws IOException { + EthGetTransactionCount ethGetTransactionCount = + web3j.ethGetTransactionCount(address, DefaultBlockParameterName.LATEST).send(); + return ethGetTransactionCount.getTransactionCount(); + } + + @Override + public BigInteger ethChainId() throws IOException { + return web3j.ethChainId().send().getChainId(); + } + + @Override + public BigInteger ethGasPrice() throws IOException { + return web3j.ethGasPrice().send().getGasPrice(); + } + + @Override + public BigInteger ethGasLimit() throws IOException { + return web3j.ethMaxPriorityFeePerGas().send().getMaxPriorityFeePerGas(); + } + + public String extractRevertReason(TransactionReceipt transactionReceipt, String data) + throws IOException { + String revertReason = + RevertReasonExtractor.extractRevertReason( + transactionReceipt, data, web3j, true, BigInteger.ZERO); + // refresh receipt + transactionReceiptLRUCache.put(transactionReceipt.getTransactionHash(), transactionReceipt); + return revertReason; + } + + private TransactionReceipt waitForTransactionReceipt( + String transactionHash, int sleepDuration, int attempts) throws Exception { + Optional transactionReceiptOptional = + getTransactionReceipt(transactionHash, sleepDuration, attempts); + + if (!transactionReceiptOptional.isPresent()) { + logger.error( + "Transaction receipt not generated after {} , attempts {}", sleepDuration, attempts); + return null; + } + return transactionReceiptOptional.get(); + } + + private Optional getTransactionReceipt( + String transactionHash, int sleepDuration, int attempts) throws Exception { + Optional receiptOptional = sendTransactionReceiptRequest(transactionHash); + for (int i = 0; i < attempts; i++) { + if (!receiptOptional.isPresent()) { + Thread.sleep(sleepDuration); + receiptOptional = sendTransactionReceiptRequest(transactionHash); + } else { + break; + } + } + return receiptOptional; + } + + private Optional sendTransactionReceiptRequest(String transactionHash) + throws Exception { + EthGetTransactionReceipt transactionReceipt = + web3j.ethGetTransactionReceipt(transactionHash).sendAsync().get(); + return transactionReceipt.getTransactionReceipt(); + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/LRUCache.java b/src/main/java/com/webank/wecross/stub/web3/common/LRUCache.java new file mode 100644 index 0000000..0fae316 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/LRUCache.java @@ -0,0 +1,18 @@ +package com.webank.wecross.stub.web3.common; + +import java.util.LinkedHashMap; +import java.util.Map; + +public class LRUCache extends LinkedHashMap { + private final int cacheSize; + + public LRUCache(int cacheSize) { + super(cacheSize, 0.75f, true); + this.cacheSize = cacheSize; + } + + @Override + protected boolean removeEldestEntry(Map.Entry eldest) { + return size() > cacheSize; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/ObjectMapperFactory.java b/src/main/java/com/webank/wecross/stub/web3/common/ObjectMapperFactory.java new file mode 100644 index 0000000..56de2cc --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/ObjectMapperFactory.java @@ -0,0 +1,30 @@ +package com.webank.wecross.stub.web3.common; + +import com.fasterxml.jackson.core.JsonParser; +import com.fasterxml.jackson.databind.DeserializationFeature; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.ObjectReader; + +public class ObjectMapperFactory { + private static final ObjectMapper DEFAULT_OBJECT_MAPPER = getObjectMapper(); + + static { + configureObjectMapper(DEFAULT_OBJECT_MAPPER); + } + + public static ObjectMapper getObjectMapper() { + return configureObjectMapper(new ObjectMapper()); + } + + public static ObjectReader getObjectReader() { + return DEFAULT_OBJECT_MAPPER.reader(); + } + + private static ObjectMapper configureObjectMapper(ObjectMapper objectMapper) { + + objectMapper.configure(JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES, true); + objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); + + return objectMapper; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/Web3Constant.java b/src/main/java/com/webank/wecross/stub/web3/common/Web3Constant.java new file mode 100644 index 0000000..3eed4a2 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/Web3Constant.java @@ -0,0 +1,18 @@ +package com.webank.wecross.stub.web3.common; + +import com.webank.wecross.stub.StubConstant; + +public interface Web3Constant { + + String STUB_TOML_NAME = "stub.toml"; + String ACCOUNT_TOML_NAME = "account.toml"; + String WEB3_STUB_TYPE = "WEB3"; + + String WEB3_PROXY_NAME = StubConstant.PROXY_NAME; + String WEB3_HUB_NAME = StubConstant.HUB_NAME; + + String WEB3_PROPERTY_ABI_SUFFIX = "ABI"; + String WEB3_PROPERTY_CHAIN_ID = "WEB3_PROPERTY_CHAIN_ID"; + String WEB3_PROPERTY_STUB_TYPE = "WEB3_PROPERTY_STUB_TYPE"; + String WEB3_PROPERTY_CHAIN_URL = "WEB3_PROPERTY_CHAIN_URL"; +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/Web3RequestType.java b/src/main/java/com/webank/wecross/stub/web3/common/Web3RequestType.java new file mode 100644 index 0000000..6241c77 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/Web3RequestType.java @@ -0,0 +1,9 @@ +package com.webank.wecross.stub.web3.common; + +public class Web3RequestType { + public static final int CALL = 1000; + public static final int SEND_TRANSACTION = 1001; + public static final int GET_BLOCK_NUMBER = 1002; + public static final int GET_BLOCK_BY_NUMBER = 1003; + public static final int GET_TRANSACTION = 1004; +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/Web3StatusCode.java b/src/main/java/com/webank/wecross/stub/web3/common/Web3StatusCode.java new file mode 100644 index 0000000..78ed486 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/Web3StatusCode.java @@ -0,0 +1,83 @@ +package com.webank.wecross.stub.web3.common; + +public class Web3StatusCode { + public static final int Success = 0; + + public static final int InvalidParameter = 2000; + public static final int UnrecognizedRequestType = 2001; + public static final int FetchBlockHeaderFailed = 2002; + public static final int InvalidEncodedBlockHeader = 2003; + public static final int TransactionProofVerifyFailed = 2004; + public static final int TransactionReceiptProofVerifyFailed = 2005; + + public static final int TransactionReceiptNotExist = 2010; + public static final int TransactionNotExist = 2011; + public static final int BlockNotExist = 2012; + public static final int TransactionProofNotExist = 2013; + public static final int TransactionReceiptProofNotExist = 2014; + + public static final int HandleSendTransactionFailed = 2021; + public static final int HandleCallRequestFailed = 2022; + public static final int HandleGetBlockNumberFailed = 2023; + public static final int HandleGetBlockFailed = 2024; + public static final int HandleGetTransactionFailed = 2025; + public static final int ListResourcesFailed = 2026; + public static final int RegisterContractFailed = 2027; + + public static final int CallNotSuccessStatus = 2030; + public static final int SendTransactionNotSuccessStatus = 2031; + + public static final int ABINotExist = 2040; + public static final int EncodeAbiFailed = 2041; + public static final int MethodNotExist = 2042; + + public static final int UnsupportedRPC = 2050; + public static final int UnclassifiedError = 2100; + + public static String getStatusMessage(int status) { + String message = ""; + switch (status) { + case Success: + message = "success"; + break; + case InvalidParameter: + message = "invalid parameter"; + break; + case UnrecognizedRequestType: + message = "unrecognized request type"; + break; + case TransactionReceiptNotExist: + message = "transaction receipt not exist"; + break; + case FetchBlockHeaderFailed: + message = "fetch block header from block header manager failed"; + break; + case InvalidEncodedBlockHeader: + message = "invalid encoded block header"; + break; + case TransactionProofVerifyFailed: + message = " transaction verify failed"; + break; + case TransactionReceiptProofVerifyFailed: + message = " transaction receipt verify failed"; + break; + case TransactionNotExist: + message = "transaction not exist"; + break; + case TransactionProofNotExist: + message = "transaction proof not exist"; + break; + case TransactionReceiptProofNotExist: + message = "transaction receipt proof not exist"; + break; + case BlockNotExist: + message = "block not exist"; + break; + default: + message = "unrecognized status: " + status; + break; + } + + return message; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/Web3StubException.java b/src/main/java/com/webank/wecross/stub/web3/common/Web3StubException.java new file mode 100644 index 0000000..9ca0778 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/Web3StubException.java @@ -0,0 +1,9 @@ +package com.webank.wecross.stub.web3.common; + +import com.webank.wecross.exception.WeCrossException; + +public class Web3StubException extends WeCrossException { + public Web3StubException(Integer errorCode, String message) { + super(errorCode, message); + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/common/Web3Toml.java b/src/main/java/com/webank/wecross/stub/web3/common/Web3Toml.java new file mode 100644 index 0000000..0de9954 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/common/Web3Toml.java @@ -0,0 +1,24 @@ +package com.webank.wecross.stub.web3.common; + +import com.moandjiezana.toml.Toml; +import java.io.IOException; +import org.springframework.core.io.Resource; +import org.springframework.core.io.support.PathMatchingResourcePatternResolver; + +public class Web3Toml { + private final String path; + + public Web3Toml(String path) { + this.path = path; + } + + public String getPath() { + return path; + } + + public Toml getToml() throws IOException { + PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); + Resource resource = resolver.getResource(getPath()); + return new Toml().read(resource.getInputStream()); + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/config/AbstractWeb3ConfigParser.java b/src/main/java/com/webank/wecross/stub/web3/config/AbstractWeb3ConfigParser.java new file mode 100644 index 0000000..71969f8 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/config/AbstractWeb3ConfigParser.java @@ -0,0 +1,31 @@ +package com.webank.wecross.stub.web3.config; + +import java.security.InvalidParameterException; +import java.util.Objects; + +public abstract class AbstractWeb3ConfigParser { + + public AbstractWeb3ConfigParser(String configPath) { + this.configPath = configPath; + } + + private final String configPath; + + public String getConfigPath() { + return configPath; + } + + public void requireItemNotNull(Object object, String item, String configFile) { + if (Objects.isNull(object)) { + throw new InvalidParameterException( + item + " item not found, please check config file: " + configFile); + } + } + + public void requireFieldNotNull(Object object, String item, String field, String configFile) { + if (Objects.isNull(object)) { + throw new InvalidParameterException( + "[" + item + "]:" + field + " field not found, please check config file: " + configFile); + } + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfig.java b/src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfig.java new file mode 100644 index 0000000..28b81e9 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfig.java @@ -0,0 +1,84 @@ +package com.webank.wecross.stub.web3.config; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Web3AccountConfig { + private static final Logger logger = LoggerFactory.getLogger(Web3AccountConfig.class); + + private Account account; + + private String accountConfigPath; + + public static class Account { + private String type; + private String accountFile; + private String password; + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } + + public String getAccountFile() { + return accountFile; + } + + public void setAccountFile(String accountFile) { + this.accountFile = accountFile; + } + + public String getPassword() { + return password; + } + + public void setPassword(String password) { + this.password = password; + } + + @Override + public String toString() { + return "Account{" + + "type='" + + type + + '\'' + + ", accountFile='" + + accountFile + + '\'' + + ", password='" + + password + + '\'' + + '}'; + } + } + + public Account getAccount() { + return account; + } + + public void setAccount(Account account) { + this.account = account; + } + + public String getAccountConfigPath() { + return accountConfigPath; + } + + public void setAccountConfigPath(String accountConfigPath) { + this.accountConfigPath = accountConfigPath; + } + + @Override + public String toString() { + return "Web3AccountConfig{" + + "account=" + + account + + ", accountConfigPath='" + + accountConfigPath + + '\'' + + '}'; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfigParser.java b/src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfigParser.java new file mode 100644 index 0000000..954555d --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/config/Web3AccountConfigParser.java @@ -0,0 +1,25 @@ +package com.webank.wecross.stub.web3.config; + +import com.moandjiezana.toml.Toml; +import com.webank.wecross.stub.web3.common.Web3Toml; +import java.io.File; +import java.io.IOException; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Web3AccountConfigParser extends AbstractWeb3ConfigParser { + + private static final Logger logger = LoggerFactory.getLogger(Web3AccountConfigParser.class); + + public Web3AccountConfigParser(String configPath, String configName) { + super(configPath + File.separator + configName); + } + + public Web3AccountConfig loadConfig() throws IOException { + Web3Toml web3Toml = new Web3Toml(getConfigPath()); + Toml toml = web3Toml.getToml(); + Web3AccountConfig web3AccountConfig = toml.to(Web3AccountConfig.class); + web3AccountConfig.setAccountConfigPath(getConfigPath()); + return web3AccountConfig; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfig.java b/src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfig.java new file mode 100644 index 0000000..4f4908f --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfig.java @@ -0,0 +1,176 @@ +package com.webank.wecross.stub.web3.config; + +import com.webank.wecross.stub.ResourceInfo; +import com.webank.wecross.stub.web3.common.Web3Constant; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Web3StubConfig { + private static final Logger logger = LoggerFactory.getLogger(Web3StubConfig.class); + + private Common common; + private Service service; + private List resources; + + private String stubConfigPath; + + public List convertToResourceInfos() { + List resourceInfos = new ArrayList<>(); + for (Resource resource : this.getResources()) { + ResourceInfo resourceInfo = new ResourceInfo(); + resourceInfo.setName(resource.getName()); + resourceInfo.setStubType(this.getCommon().getType()); + + Map properties = resourceInfo.getProperties(); + properties.put(resource.getName(), resource.getAddress()); + properties.put(resource.getName() + Web3Constant.WEB3_PROPERTY_ABI_SUFFIX, resource.getAbi()); + resourceInfos.add(resourceInfo); + } + return resourceInfos; + } + + public static class Common { + private String name; + private String type; + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } + + @Override + public String toString() { + return "Common{" + "name='" + name + '\'' + ", type='" + type + '\'' + '}'; + } + } + + public static class Service { + private String url; + + public String getUrl() { + return url; + } + + public void setUrl(String url) { + this.url = url; + } + } + + public static class Resource { + private String type; + private String name; + private String address; + private String abi; + + public String getType() { + return type; + } + + public void setType(String type) { + this.type = type; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public String getAddress() { + return address; + } + + public void setAddress(String address) { + this.address = address; + } + + public String getAbi() { + return abi; + } + + public void setAbi(String abi) { + this.abi = abi; + } + + @Override + public String toString() { + return "Resource{" + + "type='" + + type + + '\'' + + ", name='" + + name + + '\'' + + ", address='" + + address + + '\'' + + ", abi='" + + abi + + '\'' + + '}'; + } + } + + public Common getCommon() { + return common; + } + + public void setCommon(Common common) { + this.common = common; + } + + public Service getService() { + return service; + } + + public void setService(Service service) { + this.service = service; + } + + public List getResources() { + return resources; + } + + public void setResources(List resources) { + this.resources = resources; + } + + public String getStubConfigPath() { + return stubConfigPath; + } + + public void setStubConfigPath(String stubConfigPath) { + this.stubConfigPath = stubConfigPath; + } + + @Override + public String toString() { + return "Web3StubConfig{" + + "common=" + + common + + ", service=" + + service + + ", resources=" + + resources + + ", stubConfigPath='" + + stubConfigPath + + '\'' + + '}'; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfigParser.java b/src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfigParser.java new file mode 100644 index 0000000..fcac873 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/config/Web3StubConfigParser.java @@ -0,0 +1,25 @@ +package com.webank.wecross.stub.web3.config; + +import com.moandjiezana.toml.Toml; +import com.webank.wecross.stub.web3.common.Web3Toml; +import java.io.File; +import java.io.IOException; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public class Web3StubConfigParser extends AbstractWeb3ConfigParser { + + private static final Logger logger = LoggerFactory.getLogger(Web3StubConfigParser.class); + + public Web3StubConfigParser(String configPath, String configName) { + super(configPath + File.separator + configName); + } + + public Web3StubConfig loadConfig() throws IOException { + Web3Toml web3Toml = new Web3Toml(getConfigPath()); + Toml toml = web3Toml.getToml(); + Web3StubConfig web3StubConfig = toml.to(Web3StubConfig.class); + web3StubConfig.setStubConfigPath(getConfigPath()); + return web3StubConfig; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/protocol/request/TransactionParams.java b/src/main/java/com/webank/wecross/stub/web3/protocol/request/TransactionParams.java new file mode 100644 index 0000000..8fce4bc --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/protocol/request/TransactionParams.java @@ -0,0 +1,116 @@ +package com.webank.wecross.stub.web3.protocol.request; + +import com.webank.wecross.stub.TransactionRequest; + +public class TransactionParams { + private TransactionRequest transactionRequest; + private SUB_TYPE subType; + private String from; + private String to; + private String data; + private String abi; + + public TransactionParams() {} + + // SendTransaction + public TransactionParams( + TransactionRequest transactionRequest, SUB_TYPE subType, String data, String abi) { + this.transactionRequest = transactionRequest; + this.subType = subType; + this.data = data; + this.abi = abi; + } + + // Call + public TransactionParams( + TransactionRequest transactionRequest, + SUB_TYPE subType, + String from, + String to, + String data, + String abi) { + this.transactionRequest = transactionRequest; + this.subType = subType; + this.from = from; + this.to = to; + this.data = data; + this.abi = abi; + } + + public enum SUB_TYPE { + SEND_TX_BY_PROXY, + CALL_BY_PROXY, + SEND_TX, + CALL + } + + public TransactionRequest getTransactionRequest() { + return transactionRequest; + } + + public void setTransactionRequest(TransactionRequest transactionRequest) { + this.transactionRequest = transactionRequest; + } + + public String getData() { + return data; + } + + public void setData(String data) { + this.data = data; + } + + public String getFrom() { + return from; + } + + public void setFrom(String from) { + this.from = from; + } + + public String getTo() { + return to; + } + + public void setTo(String to) { + this.to = to; + } + + public String getAbi() { + return abi; + } + + public void setAbi(String abi) { + this.abi = abi; + } + + public SUB_TYPE getSubType() { + return subType; + } + + public void setSubType(SUB_TYPE subType) { + this.subType = subType; + } + + @Override + public String toString() { + return "TransactionParams{" + + "transactionRequest=" + + transactionRequest + + ", subType=" + + subType + + ", from='" + + from + + '\'' + + ", to='" + + to + + '\'' + + ", data='" + + data + + '\'' + + ", abi='" + + abi + + '\'' + + '}'; + } +} diff --git a/src/main/java/com/webank/wecross/stub/web3/protocol/response/TransactionPair.java b/src/main/java/com/webank/wecross/stub/web3/protocol/response/TransactionPair.java new file mode 100644 index 0000000..69ef734 --- /dev/null +++ b/src/main/java/com/webank/wecross/stub/web3/protocol/response/TransactionPair.java @@ -0,0 +1,42 @@ +package com.webank.wecross.stub.web3.protocol.response; + +import org.web3j.protocol.core.methods.response.Transaction; +import org.web3j.protocol.core.methods.response.TransactionReceipt; + +public class TransactionPair { + private Transaction transaction; + private TransactionReceipt transactionReceipt; + + public TransactionPair() {} + + public TransactionPair(Transaction transaction, TransactionReceipt transactionReceipt) { + this.transaction = transaction; + this.transactionReceipt = transactionReceipt; + } + + public TransactionReceipt getTransactionReceipt() { + return transactionReceipt; + } + + public void setTransactionReceipt(TransactionReceipt transactionReceipt) { + this.transactionReceipt = transactionReceipt; + } + + public Transaction getTransaction() { + return transaction; + } + + public void setTransaction(Transaction transaction) { + this.transaction = transaction; + } + + @Override + public String toString() { + return "TransactionPair{" + + "transactionReceipt=" + + transactionReceipt + + ", transaction=" + + transaction + + '}'; + } +} diff --git a/src/main/resources/stub.toml b/src/main/resources/stub.toml new file mode 100644 index 0000000..2ccebf0 --- /dev/null +++ b/src/main/resources/stub.toml @@ -0,0 +1,19 @@ +[common] + name = 'web3' # stub must be same with directory name + type = 'WEB3' # WEB3 + +[service] + url = 'http://localhost:8545' + +[[resources]] + name = 'WeCrossProxy' + type = 'WEB3_CONTRACT' + address = '0xdbF599778641083c9717Ec69e984D67d3309B811' + abi = '[{"constant":false,"inputs":[{"name":"n","type":"string"}],"name":"set","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"get","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[],"payable":false,"stateMutability":"nonpayable","type":"constructor"}]' + +[[resources]] + name = 'WeCrossHub' + type = 'WEB3_CONTRACT' + address = '0xdbF599778641083c9717Ec69e984D67d3309B811' + abi = '[{"constant":false,"inputs":[{"name":"n","type":"string"}],"name":"set","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"get","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"},{"inputs":[],"payable":false,"stateMutability":"nonpayable","type":"constructor"}]' +