Bedrock

Foundational library which powers World App's crypto wallet.

🧱 Local Development & Contributing

Review our CONTRIBUTING guide. Including details on how to run this project locally.

🚀 Releasing

Releases are managed through release-plz. To trigger a release go to the open PR with the release tag, review the changes and merge. This will trigger the process to bump the release and generate all foreign bindings.

🐦‍🔥 Swift Bindings

Bedrock ships with foreign bindings for native Swift. All details can be found in the /swift folder.

🧬 Kotlin Bindings

Bedrock ships with foreign bindings for native Kotlin. All details can be found in the /kotlin folder.

🌍 Global Configuration

Bedrock provides a global configuration system for managing environment settings across your application.

Initialization

Install the logger first, then initialize the global configuration once at app startup, before any other Bedrock call.

Swift:

@_exported import Bedrock

// The directory your `FileSystem` implementation used to resolve relative paths against.
let dataDirectory = try fileSystem.applicationSupportDirectory().path

try Bedrock.setConfig(environment: .staging, os: .ios, dataDirectory: dataDirectory)

Kotlin:

// The directory your `FileSystem` implementation used to resolve relative paths against.
val dataDirectory = File(context.filesDir, "oxide").absolutePath

uniffi.bedrock.setConfig(BedrockEnvironment.STAGING, Os.ANDROID, dataDirectory)

🛠️ Error Handling & Logging Tooling

Each module should implement its own error enum. See tooling_tests for example references.

#[bedrock_error] Macro

Automatically enhances error enums with UniFFI compatibility and anyhow integration:

#[bedrock_error]
pub enum MyError {
    #[error("Authentication failed with code: {code}")]
    AuthenticationFailed { code: u32 },
    #[error("Network timeout after {seconds} seconds")]
    NetworkTimeout { seconds: u32 },
    // Generic variant added automatically for anyhow integration
}

Features:

• Auto-derives Debug, thiserror::Error, uniffi::Error
• Adds Generic { message: String } variant automatically
• Adds FileSystem(FileSystemError) variant automatically for filesystem operations
• Implements From<anyhow::Error> for seamless error conversion
• Implements From<FileSystemError> for automatic filesystem error conversion
• Provides helper methods like from_anyhow_result() and from_anyhow_result_with_prefix()

This means filesystem operations automatically work with your error types:

pub fn load_config(&self) -> Result<String, MyError> {
    // FileSystemError automatically converts to MyError::FileSystem
    let data = _bedrock_fs.read_file("config.json")?;
    Ok(String::from_utf8_lossy(&data).to_string())
}

#[bedrock_export] Macro

Wraps #[uniffi::export] with automatic logging context and scoped filesystem injection:

#[bedrock_export]
impl MyStruct {
    pub fn some_method(&self) -> String {
        // LogContext automatically set to "MyStruct"
        info!("This will be prefixed with [Bedrock][MyStruct]");

        // Scoped filesystem available as _bedrock_fs with automatic path prefixing
        // Files will be prefixed with snake_case version of struct name: "my_struct/"
        _bedrock_fs.write_file("data.txt", b"content").ok();

        "result".to_string()
    }
}

Features:

• Automatically injects LogContext::new("StructName") at the start of every public method
• Works with any impl block for structs or traits
• Maintains all original #[uniffi::export] functionality