-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Feature: Mesh API Implementation (#1021)
## Summary This PR implements the [Mesh API](https://docs.cdp.coinbase.com/mesh/docs/welcome) for Radix. ## Details ## Data API Endpoint | Status -- | -- - /network/list | Done - /network/status | Done - /network/options | Done - /block | Done - /block/transaction | Done, `Withdraw` and `Deposit` operations only - /account/balance | Done, no historical balance lookup - /mempool | Done - /mempool/transaction | Done, no operation estimation ## Construction API All endpoints have been implemented and only single signer/sender is supported. Endpoint | Status -- | -- - /construction/derive | Done - /construction/preprocess | Done - /construction/metadata | Done - /construction/payloads | Done, `Withdraw` and `Deposit` operations only - /construction/combine | Done - /construction/parse | Done - /construction/hash | Done - /construction/submit | Done ## Testing We've added the `mesh-cli` test suites to CI.
- Loading branch information
Showing
275 changed files
with
26,450 additions
and
323 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
107 changes: 107 additions & 0 deletions
107
core-rust-bridge/src/main/java/com/radixdlt/api/MeshApiServer.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,107 @@ | ||
| /* Copyright 2021 Radix Publishing Ltd incorporated in Jersey (Channel Islands). | ||
| * | ||
| * Licensed under the Radix License, Version 1.0 (the "License"); you may not use this | ||
| * file except in compliance with the License. You may obtain a copy of the License at: | ||
| * | ||
| * radixfoundation.org/licenses/LICENSE-v1 | ||
| * | ||
| * The Licensor hereby grants permission for the Canonical version of the Work to be | ||
| * published, distributed and used under or by reference to the Licensor’s trademark | ||
| * Radix ® and use of any unregistered trade names, logos or get-up. | ||
| * | ||
| * The Licensor provides the Work (and each Contributor provides its Contributions) on an | ||
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, | ||
| * including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, | ||
| * MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. | ||
| * | ||
| * Whilst the Work is capable of being deployed, used and adopted (instantiated) to create | ||
| * a distributed ledger it is your responsibility to test and validate the code, together | ||
| * with all logic and performance of that code under all foreseeable scenarios. | ||
| * | ||
| * The Licensor does not make or purport to make and hereby excludes liability for all | ||
| * and any representation, warranty or undertaking in any form whatsoever, whether express | ||
| * or implied, to any entity or person, including any representation, warranty or | ||
| * undertaking, as to the functionality security use, value or other characteristics of | ||
| * any distributed ledger nor in respect the functioning or value of any tokens which may | ||
| * be created stored or transferred using the Work. The Licensor does not warrant that the | ||
| * Work or any use of the Work complies with any law or regulation in any territory where | ||
| * it may be implemented or used or that it will be appropriate for any specific purpose. | ||
| * | ||
| * Neither the licensor nor any current or former employees, officers, directors, partners, | ||
| * trustees, representatives, agents, advisors, contractors, or volunteers of the Licensor | ||
| * shall be liable for any direct or indirect, special, incidental, consequential or other | ||
| * losses of any kind, in tort, contract or otherwise (including but not limited to loss | ||
| * of revenue, income or profits, or loss of use or data, or loss of reputation, or loss | ||
| * of any economic or other opportunity of whatsoever nature or howsoever arising), arising | ||
| * out of or in connection with (without limitation of any use, misuse, of any ledger system | ||
| * or use made or its functionality or any performance or operation of any code or protocol | ||
| * caused by bugs or programming or logic errors or otherwise); | ||
| * | ||
| * A. any offer, purchase, holding, use, sale, exchange or transmission of any | ||
| * cryptographic keys, tokens or assets created, exchanged, stored or arising from any | ||
| * interaction with the Work; | ||
| * | ||
| * B. any failure in a transmission or loss of any token or assets keys or other digital | ||
| * artefacts due to errors in transmission; | ||
| * | ||
| * C. bugs, hacks, logic errors or faults in the Work or any communication; | ||
| * | ||
| * D. system software or apparatus including but not limited to losses caused by errors | ||
| * in holding or transmitting tokens by any third-party; | ||
| * | ||
| * E. breaches or failure of security including hacker attacks, loss or disclosure of | ||
| * password, loss of private key, unauthorised use or misuse of such passwords or keys; | ||
| * | ||
| * F. any losses including loss of anticipated savings or other benefits resulting from | ||
| * use of the Work or any changes to the Work (however implemented). | ||
| * | ||
| * You are solely responsible for; testing, validating and evaluation of all operation | ||
| * logic, functionality, security and appropriateness of using the Work for any commercial | ||
| * or non-commercial purpose and for any reproduction or redistribution by You of the | ||
| * Work. You assume all risks associated with Your use of the Work and the exercise of | ||
| * permissions under this License. | ||
| */ | ||
|
|
||
| package com.radixdlt.api; | ||
|
|
||
| import com.google.common.reflect.TypeToken; | ||
| import com.radixdlt.environment.MeshApiServerConfig; | ||
| import com.radixdlt.environment.NodeRustEnvironment; | ||
| import com.radixdlt.sbor.NodeSborCodecs; | ||
|
|
||
| public final class MeshApiServer { | ||
|
|
||
| static { | ||
| System.loadLibrary("corerust"); | ||
| } | ||
|
|
||
| /** A pointer to the owned Rust structure. */ | ||
| @SuppressWarnings("unused") | ||
| private final long rustMeshApiServerPointer = 0; | ||
|
|
||
| public static MeshApiServer create( | ||
| NodeRustEnvironment nodeRustEnvironment, MeshApiServerConfig config) { | ||
| return new MeshApiServer(nodeRustEnvironment, config); | ||
| } | ||
|
|
||
| MeshApiServer(NodeRustEnvironment nodeRustEnvironment, MeshApiServerConfig config) { | ||
| final var encodedConfig = | ||
| NodeSborCodecs.encode(config, NodeSborCodecs.resolveCodec(new TypeToken<>() {})); | ||
| init(nodeRustEnvironment, this, encodedConfig); | ||
| } | ||
|
|
||
| public void start() { | ||
| start(this); | ||
| } | ||
|
|
||
| public void stop() { | ||
| stop(this); | ||
| } | ||
|
|
||
| private static native void init( | ||
| NodeRustEnvironment nodeRustEnvironment, MeshApiServer meshApiServer, byte[] config); | ||
|
|
||
| private static native void start(MeshApiServer meshApiServer); | ||
|
|
||
| private static native void stop(MeshApiServer meshApiServer); | ||
| } |
96 changes: 96 additions & 0 deletions
96
core-rust-bridge/src/main/java/com/radixdlt/api/MeshApiServerModule.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,96 @@ | ||
| /* Copyright 2021 Radix Publishing Ltd incorporated in Jersey (Channel Islands). | ||
| * | ||
| * Licensed under the Radix License, Version 1.0 (the "License"); you may not use this | ||
| * file except in compliance with the License. You may obtain a copy of the License at: | ||
| * | ||
| * radixfoundation.org/licenses/LICENSE-v1 | ||
| * | ||
| * The Licensor hereby grants permission for the Canonical version of the Work to be | ||
| * published, distributed and used under or by reference to the Licensor’s trademark | ||
| * Radix ® and use of any unregistered trade names, logos or get-up. | ||
| * | ||
| * The Licensor provides the Work (and each Contributor provides its Contributions) on an | ||
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, | ||
| * including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, | ||
| * MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. | ||
| * | ||
| * Whilst the Work is capable of being deployed, used and adopted (instantiated) to create | ||
| * a distributed ledger it is your responsibility to test and validate the code, together | ||
| * with all logic and performance of that code under all foreseeable scenarios. | ||
| * | ||
| * The Licensor does not make or purport to make and hereby excludes liability for all | ||
| * and any representation, warranty or undertaking in any form whatsoever, whether express | ||
| * or implied, to any entity or person, including any representation, warranty or | ||
| * undertaking, as to the functionality security use, value or other characteristics of | ||
| * any distributed ledger nor in respect the functioning or value of any tokens which may | ||
| * be created stored or transferred using the Work. The Licensor does not warrant that the | ||
| * Work or any use of the Work complies with any law or regulation in any territory where | ||
| * it may be implemented or used or that it will be appropriate for any specific purpose. | ||
| * | ||
| * Neither the licensor nor any current or former employees, officers, directors, partners, | ||
| * trustees, representatives, agents, advisors, contractors, or volunteers of the Licensor | ||
| * shall be liable for any direct or indirect, special, incidental, consequential or other | ||
| * losses of any kind, in tort, contract or otherwise (including but not limited to loss | ||
| * of revenue, income or profits, or loss of use or data, or loss of reputation, or loss | ||
| * of any economic or other opportunity of whatsoever nature or howsoever arising), arising | ||
| * out of or in connection with (without limitation of any use, misuse, of any ledger system | ||
| * or use made or its functionality or any performance or operation of any code or protocol | ||
| * caused by bugs or programming or logic errors or otherwise); | ||
| * | ||
| * A. any offer, purchase, holding, use, sale, exchange or transmission of any | ||
| * cryptographic keys, tokens or assets created, exchanged, stored or arising from any | ||
| * interaction with the Work; | ||
| * | ||
| * B. any failure in a transmission or loss of any token or assets keys or other digital | ||
| * artefacts due to errors in transmission; | ||
| * | ||
| * C. bugs, hacks, logic errors or faults in the Work or any communication; | ||
| * | ||
| * D. system software or apparatus including but not limited to losses caused by errors | ||
| * in holding or transmitting tokens by any third-party; | ||
| * | ||
| * E. breaches or failure of security including hacker attacks, loss or disclosure of | ||
| * password, loss of private key, unauthorised use or misuse of such passwords or keys; | ||
| * | ||
| * F. any losses including loss of anticipated savings or other benefits resulting from | ||
| * use of the Work or any changes to the Work (however implemented). | ||
| * | ||
| * You are solely responsible for; testing, validating and evaluation of all operation | ||
| * logic, functionality, security and appropriateness of using the Work for any commercial | ||
| * or non-commercial purpose and for any reproduction or redistribution by You of the | ||
| * Work. You assume all risks associated with Your use of the Work and the exercise of | ||
| * permissions under this License. | ||
| */ | ||
|
|
||
| package com.radixdlt.api; | ||
|
|
||
| import com.google.inject.AbstractModule; | ||
| import com.google.inject.Provides; | ||
| import com.google.inject.Singleton; | ||
| import com.google.inject.multibindings.ProvidesIntoSet; | ||
| import com.radixdlt.environment.MeshApiServerConfig; | ||
| import com.radixdlt.environment.NodeAutoCloseable; | ||
| import com.radixdlt.environment.NodeRustEnvironment; | ||
| import com.radixdlt.utils.UInt32; | ||
|
|
||
| public final class MeshApiServerModule extends AbstractModule { | ||
|
|
||
| private final MeshApiServerConfig config; | ||
|
|
||
| public MeshApiServerModule(String apiBindAddress, int apiPort, String nodeDisplayVersion) { | ||
| this.config = | ||
| new MeshApiServerConfig( | ||
| apiBindAddress, UInt32.fromNonNegativeInt(apiPort), nodeDisplayVersion); | ||
| } | ||
|
|
||
| @Provides | ||
| @Singleton | ||
| private MeshApiServer meshApiServer(NodeRustEnvironment nodeRustEnvironment) { | ||
| return MeshApiServer.create(nodeRustEnvironment, config); | ||
| } | ||
|
|
||
| @ProvidesIntoSet | ||
| NodeAutoCloseable closeable(MeshApiServer meshApiServer) { | ||
| return meshApiServer::stop; | ||
| } | ||
| } |
77 changes: 77 additions & 0 deletions
77
core-rust-bridge/src/main/java/com/radixdlt/environment/MeshApiServerConfig.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,77 @@ | ||
| /* Copyright 2021 Radix Publishing Ltd incorporated in Jersey (Channel Islands). | ||
| * | ||
| * Licensed under the Radix License, Version 1.0 (the "License"); you may not use this | ||
| * file except in compliance with the License. You may obtain a copy of the License at: | ||
| * | ||
| * radixfoundation.org/licenses/LICENSE-v1 | ||
| * | ||
| * The Licensor hereby grants permission for the Canonical version of the Work to be | ||
| * published, distributed and used under or by reference to the Licensor’s trademark | ||
| * Radix ® and use of any unregistered trade names, logos or get-up. | ||
| * | ||
| * The Licensor provides the Work (and each Contributor provides its Contributions) on an | ||
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, | ||
| * including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, | ||
| * MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. | ||
| * | ||
| * Whilst the Work is capable of being deployed, used and adopted (instantiated) to create | ||
| * a distributed ledger it is your responsibility to test and validate the code, together | ||
| * with all logic and performance of that code under all foreseeable scenarios. | ||
| * | ||
| * The Licensor does not make or purport to make and hereby excludes liability for all | ||
| * and any representation, warranty or undertaking in any form whatsoever, whether express | ||
| * or implied, to any entity or person, including any representation, warranty or | ||
| * undertaking, as to the functionality security use, value or other characteristics of | ||
| * any distributed ledger nor in respect the functioning or value of any tokens which may | ||
| * be created stored or transferred using the Work. The Licensor does not warrant that the | ||
| * Work or any use of the Work complies with any law or regulation in any territory where | ||
| * it may be implemented or used or that it will be appropriate for any specific purpose. | ||
| * | ||
| * Neither the licensor nor any current or former employees, officers, directors, partners, | ||
| * trustees, representatives, agents, advisors, contractors, or volunteers of the Licensor | ||
| * shall be liable for any direct or indirect, special, incidental, consequential or other | ||
| * losses of any kind, in tort, contract or otherwise (including but not limited to loss | ||
| * of revenue, income or profits, or loss of use or data, or loss of reputation, or loss | ||
| * of any economic or other opportunity of whatsoever nature or howsoever arising), arising | ||
| * out of or in connection with (without limitation of any use, misuse, of any ledger system | ||
| * or use made or its functionality or any performance or operation of any code or protocol | ||
| * caused by bugs or programming or logic errors or otherwise); | ||
| * | ||
| * A. any offer, purchase, holding, use, sale, exchange or transmission of any | ||
| * cryptographic keys, tokens or assets created, exchanged, stored or arising from any | ||
| * interaction with the Work; | ||
| * | ||
| * B. any failure in a transmission or loss of any token or assets keys or other digital | ||
| * artefacts due to errors in transmission; | ||
| * | ||
| * C. bugs, hacks, logic errors or faults in the Work or any communication; | ||
| * | ||
| * D. system software or apparatus including but not limited to losses caused by errors | ||
| * in holding or transmitting tokens by any third-party; | ||
| * | ||
| * E. breaches or failure of security including hacker attacks, loss or disclosure of | ||
| * password, loss of private key, unauthorised use or misuse of such passwords or keys; | ||
| * | ||
| * F. any losses including loss of anticipated savings or other benefits resulting from | ||
| * use of the Work or any changes to the Work (however implemented). | ||
| * | ||
| * You are solely responsible for; testing, validating and evaluation of all operation | ||
| * logic, functionality, security and appropriateness of using the Work for any commercial | ||
| * or non-commercial purpose and for any reproduction or redistribution by You of the | ||
| * Work. You assume all risks associated with Your use of the Work and the exercise of | ||
| * permissions under this License. | ||
| */ | ||
|
|
||
| package com.radixdlt.environment; | ||
|
|
||
| import com.radixdlt.sbor.codec.CodecMap; | ||
| import com.radixdlt.sbor.codec.StructCodec; | ||
| import com.radixdlt.utils.UInt32; | ||
|
|
||
| public record MeshApiServerConfig(String bindInterface, UInt32 port, String nodeDisplayVersion) { | ||
| public static void registerCodec(CodecMap codecMap) { | ||
| codecMap.register( | ||
| MeshApiServerConfig.class, | ||
| codecs -> StructCodec.fromRecordComponents(MeshApiServerConfig.class, codecs)); | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.