Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README #88

Merged
merged 3 commits into from
Apr 9, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 80 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,88 @@
# Torus-utils-swift


## Introduction

Use this package to do threshold resolution of API calls to Torus nodes.
Since Torus nodes operate on a threshold assumption, we need to ensure that API calls also follow such an assumption.
This is to prevent malicious nodes from withholding shares, or deliberately slowing down the entire process.

This utility library allows for early exits in optimistic scenarios, while handling rejection of invalid inputs from nodes in malicious/offline scenarios.
The general approach is to evaluate predicates against a list of (potentially incomplete) results, and exit when the predicate passes.

## 🔗 Installation
You can install the SingleFactorAuth Swift using Swift Package Manager.

```
...
dependencies: [
...
.package(url: "https://github.com/torusresearch/torus-utils-swift", from: "8.0.1")
],
...
```

## Getting Started
Initialize the `TorusUtils` class by passing `TorusNetwork`, `enableOneKey`, and your `clientId`. `enableOneKey` if true, adds the nonce value to the key, to make it compaitible with v2 users. The package supports both legacy and sapphire networks.

```swift
let torus = TorusUtils(
enableOneKey: true,
network: .sapphire(.SAPPHIRE_DEVNET),
clientId: "YOUR_CLIENT_ID"
)
```


Use `getPublicAddress` function to retrive the public address of the user. To fetch the public address, we'll require node details as well, for that we'll use `NodeDetailManager`.

Use the `getNodeDetails` function to retrive the node details for specific `verifier` and `verifierId`. Here the `verifierId` would be the value for the verifier id. For instance, user's email.

```swift
do {
let fnd = NodeDetailManager(network: .sapphire(.SAPPHIRE_DEVNET))

let nodeDetails = try await fnd.getNodeDetails(verifier: verifer, verifierID: veriferID)

let publicAddressResponse = try await torus.getPublicAddress(
endpoints: nodeDetails.getTorusNodeEndpoints(),
torusNodePubs: nodeDetails.torusNodePub,
verifier: TORUS_TEST_VERIFIER,
verifierId: TORUS_TEST_EMAIL
)

print(publicAddressResponse.oAuthKeyData!.evmAddress)
} catch let error {
// Handle error
}
```

Use `retriveShares` function to login a user, and get the login data such as `sessionData`, `privKey`, `evmAddress`, `metaData` for user. Along with node detals, it also takes verifier, `verifierParams`, and `idToken`(JWT token).

```swift
// verifier_id takes the value, for instance email, sub, or custom.
let verifierParams = VerifierParams(verifier_id: "verifier_id_value")

do {
// Use nodeDetails from above step
let data = try await torus.retrieveShares(
endpoints: nodeDetails.getTorusNodeEndpoints(),
torusNodePubs: nodeDetails.getTorusNodePub(),
indexes: nodeDetails.getTorusIndexes(),
verifier: TORUS_TEST_VERIFIER,
verifierParams: verifierParams,
idToken: token
)

let privateKey = data.finalKeyData!.privKey
let evmAddress = data.finalKeyData!.evmAddress
} catch let error {
// Handle error
}
```

## Requirements
- iOS 13 or above is required

## 💬 Troubleshooting and Support

- Have a look at our [Community Portal](https://community.web3auth.io/) to see if anyone has any questions or issues you might be having. Feel free to reate new topics and we'll help you out as soon as possible.
- Checkout our [Troubleshooting Documentation Page](https://web3auth.io/docs/troubleshooting) to know the common issues and solutions.
- For Priority Support, please have a look at our [Pricing Page](https://web3auth.io/pricing.html) for the plan that suits your needs.
Loading