Create new index for tracking Asset metadata

CHANGELOG.md

@@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ## [Unreleased]
 
 ### Added
+- [2445](https://github.com/FuelLabs/fuel-core/pull/2445): Added GQL endpoint for querying asset details.
 - [2442](https://github.com/FuelLabs/fuel-core/pull/2442): Add uninitialized task for V1 gas price service
 - [2154](https://github.com/FuelLabs/fuel-core/pull/2154): Added `Unknown` variant to `ConsensusParameters` graphql queries
 - [2154](https://github.com/FuelLabs/fuel-core/pull/2154): Added `Unknown` variant to `Block` graphql queries

crates/client/assets/schema.sdl

@@ -2,6 +2,12 @@ scalar Address
 
 scalar AssetId
 
+type AssetInfoDetails {
+	contractId: ContractId!
+	subId: SubId!
+	totalSupply: U128!
+}
+
 type Balance {
 	owner: Address!
 	amount: U64!
@@ -853,6 +859,12 @@ type ProgramState {
 }
 
 type Query {
+	assetDetails(
+		"""
+		ID of the Asset
+		"""
+		id: AssetId!
+	): AssetInfoDetails!
 	"""
 	Read register value by index.
 	"""
@@ -1121,6 +1133,8 @@ type StateTransitionPurpose {
 }
 
 
+scalar SubId
+
 type SubmittedStatus {
 	time: Tai64Timestamp!
 }

crates/client/src/client.rs

@@ -16,6 +16,7 @@ use crate::client::{
         TransactionId,
     },
     types::{
+        asset::AssetDetail,
         gas_price::LatestGasPrice,
         message::MessageStatus,
         primitives::{
@@ -78,6 +79,7 @@ use pagination::{
     PaginationRequest,
 };
 use schema::{
+    assets::AssetInfoArg,
     balance::BalanceArgs,
     blob::BlobByIdArgs,
     block::BlockByIdArgs,
@@ -1191,6 +1193,14 @@ impl FuelClient {
             .transpose()?;
         Ok(status)
     }
+
+    pub async fn asset_info(&self, asset_id: &AssetId) -> io::Result<AssetDetail> {
+        let query = schema::assets::AssetInfoQuery::build(AssetInfoArg {
+            id: (*asset_id).into(),
+        });
+        let asset_info = self.query(query).await?.asset_details.into();
+        Ok(asset_info)
+    }
 }
 
 #[cfg(any(test, feature = "test-helpers"))]

crates/client/src/client/schema.rs

@@ -26,6 +26,7 @@ use crate::client::pagination::{
 };
 pub use primitives::*;
 
+pub mod assets;
 pub mod balance;
 pub mod blob;
 pub mod block;

crates/client/src/client/schema/assets.rs

@@ -0,0 +1,31 @@
+use crate::client::schema::{
+    schema,
+    AssetId,
+    ContractId,
+    SubId,
+    U128,
+};
+
+#[derive(cynic::QueryVariables, Debug)]
+pub struct AssetInfoArg {
+    pub id: AssetId,
+}
+
+#[derive(cynic::QueryFragment, Clone, Debug)]
+#[cynic(
+    schema_path = "./assets/schema.sdl",
+    graphql_type = "Query",
+    variables = "AssetInfoArg"
+)]
+pub struct AssetInfoQuery {
+    #[arguments(id: $id)]
+    pub asset_details: AssetInfoDetails,
+}
+
+#[derive(cynic::QueryFragment, Clone, Debug)]
+#[cynic(schema_path = "./assets/schema.sdl")]
+pub struct AssetInfoDetails {
+    pub sub_id: SubId,
+    pub contract_id: ContractId,
+    pub total_supply: U128,
+}

crates/client/src/client/schema/primitives.rs

@@ -111,6 +111,7 @@ fuel_type_scalar!(BlockId, Bytes32);
 fuel_type_scalar!(AssetId, AssetId);
 fuel_type_scalar!(BlobId, BlobId);
 fuel_type_scalar!(ContractId, ContractId);
+fuel_type_scalar!(SubId, Bytes32);
 fuel_type_scalar!(Salt, Salt);
 fuel_type_scalar!(TransactionId, Bytes32);
 fuel_type_scalar!(RelayedTransactionId, Bytes32);

crates/client/src/client/types.rs

@@ -7,6 +7,7 @@ pub mod contract;
 pub mod gas_costs;
 pub mod upgrades;
 
+pub mod asset;
 pub mod gas_price;
 pub mod merkle_proof;
 pub mod message;

crates/client/src/client/types/asset.rs

@@ -0,0 +1,24 @@
+use crate::client::schema;
+use fuel_core_types::{
+    fuel_tx::Bytes32,
+    fuel_types::ContractId,
+};
+
+#[derive(Clone, Copy, Debug, PartialEq)]
+pub struct AssetDetail {
+    pub contract_id: ContractId,
+    pub sub_id: Bytes32,
+    pub total_supply: u128,
+}
+
+// GraphQL Translation
+
+impl From<schema::assets::AssetInfoDetails> for AssetDetail {
+    fn from(value: schema::assets::AssetInfoDetails) -> Self {
+        AssetDetail {
+            contract_id: value.contract_id.into(),
+            sub_id: value.sub_id.into(),
+            total_supply: value.total_supply.into(),
+        }
+    }
+}

crates/fuel-core/src/database/database_description.rs

@@ -83,6 +83,7 @@ pub trait DatabaseDescription: 'static + Copy + Debug + Send + Sync {
 pub enum IndexationKind {
     Balances,
     CoinsToSpend,
+    AssetMetadata,
 }
 
 impl IndexationKind {

crates/fuel-core/src/graphql_api/database.rs

@@ -92,6 +92,8 @@ pub struct ReadDatabase {
     balances_indexation_enabled: bool,
     /// The flag that indicates whether the CoinsToSpend indexation is enabled.
     coins_to_spend_indexation_enabled: bool,
+    /// The flag that indicates whether the AssetMetadata indexation is enabled.
+    asset_metadata_indexation_enabled: bool,
 }
 
 impl ReadDatabase {
@@ -111,6 +113,8 @@ impl ReadDatabase {
         let balances_indexation_enabled = off_chain.balances_indexation_enabled()?;
         let coins_to_spend_indexation_enabled =
             off_chain.coins_to_spend_indexation_enabled()?;
+        let asset_metadata_indexation_enabled =
+            off_chain.asset_metadata_indexation_enabled()?;
 
         Ok(Self {
             batch_size,
@@ -119,6 +123,7 @@ impl ReadDatabase {
             off_chain: Box::new(ArcWrapper::new(off_chain)),
             balances_indexation_enabled,
             coins_to_spend_indexation_enabled,
+            asset_metadata_indexation_enabled,
         })
     }
 
@@ -134,6 +139,7 @@ impl ReadDatabase {
             off_chain: self.off_chain.latest_view()?,
             balances_indexation_enabled: self.balances_indexation_enabled,
             coins_to_spend_indexation_enabled: self.coins_to_spend_indexation_enabled,
+            asset_metadata_indexation_enabled: self.asset_metadata_indexation_enabled,
         })
     }
 
@@ -151,6 +157,7 @@ pub struct ReadView {
     pub(crate) off_chain: OffChainView,
     pub(crate) balances_indexation_enabled: bool,
     pub(crate) coins_to_spend_indexation_enabled: bool,
+    pub(crate) asset_metadata_indexation_enabled: bool,
 }
 
 impl ReadView {

crates/fuel-core/src/graphql_api/indexation.rs

@@ -1,3 +1,4 @@
+pub(crate) mod asset_metadata;
 pub(crate) mod balances;
 pub(crate) mod coins_to_spend;
 pub(crate) mod error;