org.stellar.sdk

Class SorobanDataBuilder

java.lang.Object

org.stellar.sdk.SorobanDataBuilder

public class SorobanDataBuilder
extends java.lang.Object

Supports building SorobanTransactionData structures with various items set to specific values.

This is recommended for when you are building ExtendFootprintTTLOperation and RestoreFootprintOperation operations to avoid (re)building the entire data structure from scratch.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SorobanDataBuilder.Resources Represents the resource metrics of the Soroban data.

Constructor Summary

Constructors

Constructor and Description
SorobanDataBuilder() Creates a new builder with an empty SorobanTransactionData.
SorobanDataBuilder(SorobanTransactionData sorobanData) Creates a new builder from a SorobanTransactionData.
SorobanDataBuilder(java.lang.String sorobanData) Creates a new builder from a base64 representation of SorobanTransactionData.

Method Summary

Modifier and Type	Method and Description
SorobanTransactionData	build()
SorobanDataBuilder	setReadOnly(java.util.Collection<LedgerKey> readOnly) Sets the read-only portion of the storage access footprint to be a certain set of ledger keys.
SorobanDataBuilder	setReadWrite(java.util.Collection<LedgerKey> readWrite) Sets the read-write portion of the storage access footprint to be a certain set of ledger keys.
SorobanDataBuilder	setResourceFee(long fee) Sets the "resource" fee portion of the Soroban data.
SorobanDataBuilder	setResources(SorobanDataBuilder.Resources resources) Sets up the resource metrics.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SorobanDataBuilder

public SorobanDataBuilder()

Creates a new builder with an empty SorobanTransactionData.

SorobanDataBuilder

public SorobanDataBuilder(java.lang.String sorobanData)

Creates a new builder from a base64 representation of SorobanTransactionData.

Parameters:

sorobanData - base64 representation of SorobanTransactionData

SorobanDataBuilder

public SorobanDataBuilder(SorobanTransactionData sorobanData)

Creates a new builder from a SorobanTransactionData.

Parameters:

sorobanData - SorobanTransactionData.

Method Detail

setResourceFee

public SorobanDataBuilder setResourceFee(long fee)

Sets the "resource" fee portion of the Soroban data.

Parameters:

fee - the resource fee to set (int64)

Returns:

this builder instance

setResources

public SorobanDataBuilder setResources(SorobanDataBuilder.Resources resources)

Sets up the resource metrics.

You should almost NEVER need this, as its often generated/provided to you by transaction simulation/preflight from a Soroban RPC server.

Parameters:

resources - the resource metrics to set

Returns:

this builder instance

setReadOnly

public SorobanDataBuilder setReadOnly(@Nullable
                                      java.util.Collection<LedgerKey> readOnly)

Sets the read-only portion of the storage access footprint to be a certain set of ledger keys.

Passing null will leave that portion of the footprint untouched. If you want to clear a portion of the footprint, pass an empty collection.

Parameters:

readOnly - the set of ledger keys to set in the read-only portion of the transaction's sorobanData

Returns:

this builder instance

setReadWrite

public SorobanDataBuilder setReadWrite(@Nullable
                                       java.util.Collection<LedgerKey> readWrite)

Sets the read-write portion of the storage access footprint to be a certain set of ledger keys.

Passing null will leave that portion of the footprint untouched. If you want to clear a portion of the footprint, pass an empty collection.

Parameters:

readWrite - the set of ledger keys to set in the read-write portion of the transaction's sorobanData

Returns:

this builder instance

build

public SorobanTransactionData build()

Returns:

the copy of the final SorobanTransactionData.