WalletKit enables mobile applications to use [World ID](https://world.org/world-id).
Part of the [World ID SDK](https://docs.world.org/world-id).
WalletKit can be used as a Rust crate, or directly as a Swift or Android package. WalletKit includes foreign bindings for direct usage in Swift/Kotlin through [UniFFI](https://github.com/mozilla/uniffi-rs).
## Installation
**To use WalletKit in another Rust project:**
```bash
cargo install --git https://github.com/worldcoin/walletkit
# // TODO: installation through crates.io is pending
# cargo install walletkit
```
**To use WalletKit in an iOS app:**
WalletKit is distributed through a separate repo specifically for Swift bindings. This repo contains all the binaries required and is a mirror of `@worldcoin/walletkit`.
1. Navigate to File > Swift Packages > Add Package Dependency in Xcode.
2. Enter the WalletKit repo URL (note this is **not** the same repo): `https://github.com/worldcoin/walletkit-swift`
**To use WalletKit in an Android app:**
WalletKit's bindings for Kotlin are distributed through GitHub packages.
1. Update `build.gradle` (App Level)
```kotlin
dependencies {
/// ...
implementation "org.world:walletkit:VERSION"
}
```
Replace `VERSION` with the desired WalletKit version.
2. Sync Gradle.
## Overview
WalletKit is broken down into separate crates, offering the following functionality.
- `walletkit-core` - Enables basic usage of a World ID to generate ZKPs using different credentials.
### World ID Secret
- Each World ID requires a secret. The secret is used in ZKPs to prove ownership over a World ID.
- Each host app is responsible for generating, storing and backing up a World ID secret.
- A World ID secret is a 32-byte secret generated with a cryptographically secure random function.
- The World ID secret **must** never be exposed to third-parties and **must not** leave the holder's device.
//TODO: Additional guidelines for secret generation and storage.
## Getting Started
WalletKit is generally centered around a World ID. The most basic usage requires initializing a `WorldId`.
A World ID can then be used to generate [Zero-Knowledge Proofs](https://docs.world.org/world-id/further-reading/zero-knowledge-proofs).
A ZKP is analogous to _presenting_ a credential.
```rust
use walletkit::{proof::ProofContext, CredentialType, Environment, world_id::WorldId};
async fn example() {
let world_id = WorldId::new(b"not_a_real_secret", &Environment::Staging);
let context = ProofContext::new("app_ce4cb73cb75fc3b73b71ffb4de178410", Some("my_action".to_string()), None, CredentialType::Orb);
let proof = world_id.generate_proof(&context).await.unwrap();
dbg!(proof.to_json()); // the JSON output can be passed to the Developer Portal, World ID contracts, etc. for verification
}
```