feat: AssembleTx query

bin/fuel-core/src/cli/run.rs

@@ -607,6 +607,7 @@ impl Command {
                     coins_to_spend: graphql.costs.coins_to_spend,
                     get_peers: graphql.costs.get_peers,
                     estimate_predicates: graphql.costs.estimate_predicates,
+                    assemble_tx: graphql.costs.assemble_tx,
                     dry_run: graphql.costs.dry_run,
                     storage_read_replay: graphql.costs.storage_read_replay,
                     submit: graphql.costs.submit,

bin/fuel-core/src/cli/run/graphql.rs

@@ -131,6 +131,14 @@ pub struct QueryCosts {
     )]
     pub dry_run: usize,
 
+    /// Query costs for assembling the transaction.
+    #[clap(
+        long = "query-cost-assemble-tx",
+        default_value = DEFAULT_QUERY_COSTS.assemble_tx.to_string(),
+        env
+    )]
+    pub assemble_tx: usize,
+
     /// Query costs for generating execution trace for a block.
     #[clap(
         long = "query-cost-storage-read-replay",

crates/client/assets/schema.sdl

@@ -1,5 +1,15 @@
+input Account @oneOf {
+	address: Address
+	predicate: Predicate
+}
+
 scalar Address
 
+type AssembleTransactionResult {
+	transaction: Transaction!
+	status: DryRunTransactionStatus!
+}
+
 scalar AssetId
 
 type AssetInfoDetails {
@@ -128,6 +138,18 @@ type ChangeOutput {
 	assetId: AssetId!
 }
 
+input ChangePolicy @oneOf {
+	"""
+	Adds `Output::Change` to the transaction if it is not already present.
+	Sending remaining assets to the provided address.
+	"""
+	change: Address
+	"""
+	Destroys the remaining assets by the transaction for provided address.
+	"""
+	destroy: Boolean
+}
+
 type Coin {
 	utxoId: UtxoId!
 	owner: Address!
@@ -865,6 +887,12 @@ type Policies {
 	maxFee: U64
 }
 
+input Predicate {
+	predicateAddress: Address!
+	predicate: [Int!]!
+	predicateData: [Int!]!
+}
+
 type PredicateParameters {
 	version: PredicateParametersVersion!
 	maxPredicateLength: U64!
@@ -935,6 +963,60 @@ type Query {
 	transactions(first: Int, after: String, last: Int, before: String): TransactionConnection!
 	transactionsByOwner(owner: Address!, first: Int, after: String, last: Int, before: String): TransactionConnection!
 	"""
+	Assembles the transaction based on the provided requirements.
+	The return transaction contains:
+	- Input coins to cover `required_balances`
+	- Input coins to cover the fee of the transaction based on the gas price from `block_horizon`
+	- `Change` or `Destroy` outputs for all assets from the inputs
+	- `Variable` outputs in the case they are required during the execution
+	- `Contract` inputs and outputs in the case they are required during the execution
+	- Reserved witness slots for signed coins filled with `64` zeroes
+	- Set script gas limit(unless `script` is empty)
+	- Estimated predicates, if `estimate_predicates == true`
+
+	Returns an error if:
+	- The number of required balances exceeds the maximum number of inputs allowed.
+	- The fee address index is out of bounds.
+	- The same asset has multiple change policies(either the receiver of
+	the change is different, or one of the policies states about the destruction
+	of the token while the other does not). The `Change` output from the transaction
+	also count as a `ChangePolicy`.
+	- The number of excluded coin IDs exceeds the maximum number of inputs allowed.
+	- Required assets have multiple entries.
+	- If accounts don't have sufficient amounts to cover the transaction requirements in assets.
+	- If a constructed transaction breaks the rules defined by consensus parameters.
+	"""
+	assembleTx(
+		"""
+		The original transaction that contains application level logic only
+		"""
+		tx: HexString!,
+		"""
+		Number of blocks into the future to estimate the gas price for
+		"""
+		blockHorizon: U32!,
+		"""
+		The list of required balances for the transaction to include as inputs. The list should be created based on the application-required assets. The base asset requirement should not require assets to cover the transaction fee, which will be calculated and added automatically at the end of the assembly process.
+		"""
+		requiredBalances: [RequiredBalance!]!,
+		"""
+		The index from the `required_balances` list that points to the address who pays fee for the transaction. If you only want to cover the fee of transaction, you can set the required balance to 0, set base asset and point to this required address.
+		"""
+		feeAddressIndex: U8!,
+		"""
+		The list of resources to exclude from the selection for the inputs
+		"""
+		excludeInput: ExcludeInput,
+		"""
+		Perform the estimation of the predicates before cover fee of the transaction
+		"""
+		estimatePredicates: Boolean,
+		"""
+		During the phase of the fee calculation, adds `reserve_gas` to the total gas used by the transaction and fetch assets to cover the fee.
+		"""
+		reserveGas: U64
+	): AssembleTransactionResult!
+	"""
 	Estimate the predicate gas for the provided transaction
 	"""
 	estimatePredicates(tx: HexString!): Transaction!
@@ -987,7 +1069,7 @@ type Query {
 		"""
 		The excluded coins from the selection.
 		"""
-		excludedIds: ExcludeInput
+		excludeInput: ExcludeInput
 	): [[CoinType!]!]!
 	daCompressedBlock(
 		"""
@@ -1095,6 +1177,13 @@ scalar RelayedTransactionId
 
 union RelayedTransactionStatus = RelayedTransactionFailed
 
+input RequiredBalance {
+	assetId: AssetId!
+	amount: U64!
+	account: Account!
+	changePolicy: ChangePolicy!
+}
+
 enum ReturnType {
 	RETURN
 	RETURN_DATA
@@ -1140,11 +1229,11 @@ input SpendQueryElementInput {
 	"""
 	Target amount for the query.
 	"""
-	amount: U64!
+	amount: U128!
 	"""
 	The maximum number of currencies for selection.
 	"""
-	max: U32
+	max: U16
 }
 
 type SqueezedOutStatus {
@@ -1333,6 +1422,8 @@ scalar U32
 
 scalar U64
 
+scalar U8
+
 union UpgradePurpose = ConsensusParametersPurpose | StateTransitionPurpose
 
 type UploadedBytecode {
@@ -1359,6 +1450,7 @@ type VariableOutput {
 }
 
 directive @include(if: Boolean!) on FIELD | FRAGMENT_SPREAD | INLINE_FRAGMENT
+directive @oneOf on INPUT_OBJECT
 directive @skip(if: Boolean!) on FIELD | FRAGMENT_SPREAD | INLINE_FRAGMENT
 schema {
 	query: Query