# Bucket

The `bucket` interface is used to query bucket information associated with an account.

```rust
/// Asynchronously retrieves the `BucketInfo` associated with a given account and bucket name.
///
/// # Parameters
/// - `account`: A valid account identifier string for which the bucket information needs to be queried.
/// - `bucket_name`: A string slice that holds the name of the bucket.
/// - `block_hash`: An optional `H256` hash representing the block hash to verify the bucket against.
///
/// # Returns
/// A `Result` which is:
/// - `Ok(Some(BucketInfo))` if the bucket is found and successfully retrieved.
/// - `Ok(None)` if the bucket is not found for the given account.
/// - `Err(Box<dyn std::error::Error>)` if there is an error during retrieval.
///
pub async fn bucket(
    account: &str,
    bucket_name: &str,
    block_hash: Option<H256>,
) -> Result<Option<BucketInfo>, Box<dyn std::error::Error>> 
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.cess.network/developer/cess-sdk/sdk-rust/chain/file_bank/bucket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.