Update unsafe suffix documentation
This commit is contained in:
parent
2b834013cb
commit
fc3ac27205
|
@ -26,7 +26,7 @@ The SDK is broken down into several logical components, implemented as Gradle mo
|
|||
Before diving into some of the module specifics, it is helpful to provide some context on the data model representations as data flows between the different modules of this repository. There are multiple data representations, including:
|
||||
|
||||
1. Network — The wire representation for calls to and from the Lightwalletd server. These are generated by `protoc` at compile time. These are not generally a public API.
|
||||
2. Unsafe — The representation provided as the public API from `lightwallet-client-lib`. These values are not necessarily validated, hence the smurf naming with the suffix `Unsafe`. These are not generally a public API.
|
||||
2. Unsafe — The representation provided as the output from `lightwallet-client-lib`. These values are not necessarily validated, hence the smurf naming with the suffix `Unsafe`. These are not generally a public API for clients of the SDK.
|
||||
3. SDK — Objects exposed as a public API for clients of the SDK.
|
||||
|
||||
# lightwallet-client-lib
|
||||
|
|
|
@ -2,6 +2,11 @@ package co.electriccoin.lightwallet.client.model
|
|||
|
||||
import cash.z.wallet.sdk.internal.rpc.Service
|
||||
|
||||
/**
|
||||
* A lightwalletd endpoint information, which has come from the Light Wallet server.
|
||||
*
|
||||
* It is marked as "unsafe" because it is not guaranteed to be valid.
|
||||
*/
|
||||
data class LightWalletEndpointInfoUnsafe(
|
||||
val chainName: String,
|
||||
val consensusBranchId: String,
|
||||
|
|
|
@ -2,6 +2,11 @@ package co.electriccoin.lightwallet.client.model
|
|||
|
||||
import cash.z.wallet.sdk.internal.rpc.Service.RawTransaction
|
||||
|
||||
/**
|
||||
* RawTransaction contains the complete transaction data, which has come from the Light Wallet server.
|
||||
*
|
||||
* It is marked as "unsafe" because it is not guaranteed to be valid.
|
||||
*/
|
||||
class RawTransactionUnsafe(val height: BlockHeightUnsafe, val data: ByteArray) {
|
||||
companion object {
|
||||
fun new(rawTransaction: RawTransaction) = RawTransactionUnsafe(
|
||||
|
|
|
@ -2,6 +2,13 @@ package co.electriccoin.lightwallet.client.model
|
|||
|
||||
import cash.z.wallet.sdk.internal.rpc.Service
|
||||
|
||||
/**
|
||||
* A SendResponse encodes an error code and a string. It is currently used only by SendTransaction(). If error code
|
||||
* is zero, the operation was successful; if non-zero, it and the message specify the failure. It has come from the
|
||||
* Light Wallet server.
|
||||
*
|
||||
* It is marked as "unsafe" because it is not guaranteed to be valid.
|
||||
*/
|
||||
data class SendResponseUnsafe(
|
||||
val code: Int,
|
||||
val message: String
|
||||
|
|
Loading…
Reference in New Issue