JavaScript Client
This Rust-to-WASM compiled library is a thin wrapper around the client portion of the Rebase Witness SDK, the source of which is found here. It makes several design choices that make usage in WASM easier.
$ npm i @rebase-xyz/rebase-client
import { Client } from "@rebase-xyz/rebase-client";
// const witnessUrl = ...
const statementUrl = `${witnessUrl}/statement`;
const instructionsUrl = `${witnessUrl}/instructions`;
const jwtUrl = `${witnessUrl}/witness_jwt`;
const ldUrl = `${witnessUrl}/witness_ld`;
export const client = new Client(instructionsUrl, statementUrl, jwtUrl, ldUrl);
const instructionsReq = {
type: "github" // or "email" or "twitter" or "reddit" or more!
};
let instructionsRes = await client.instructions(instructionsReq)
instructionRes = JSON.parse(instructionsRes);
// const statementReq = ...
let statementRes = await client.statement(statementReq);
statementRes = JSON.parse(statementRes);
// const proofReq = makeProofFromStatement(statmentRes);
// Get a JWT credential.
let proofRes = await client.jwt(proofReq);
proofRes = JSON.parse(proofRes);
let credential;
if (proofRes.jwt) {
credential = proofRes.jwt;
}
// Get a LD credential
let proofRes = await client.ld(proofReq);
proofRes = JSON.parse(proofRes);
if (proofRes.credential) {
credential = proofRes.credential;
}
The
Client
struct exposed by the library (and made available to JavaScript consumers) has an implementation that looks like:#[wasm_bindgen]
impl Client {
#[wasm_bindgen(constructor)]
pub fn new(
instructions: String,
statement: String,
jwt: Option<String>,
ld: Option<String>,
) -> Result<Client, String> {
// ...
}
pub fn instructions(&self, req: String) -> Promise {
// ...
}
pub fn statement(&self, req: String) -> Promise {
// ...
}
pub fn jwt(&self, req: String) -> Promise {
// ...
}
pub fn ld(&self, req: String) -> Promise {
// ...
}
}
Once the client is instantiated, the user simply has to pass in
req
s that conform to JSON stringified requests described in the SDK documentation, where the resulting Promise
contains a JSON stringified response described in the linked doc.Concrete usage of this library in JS is found here. The client's constructor accepts up to four URLs assumed to be pointed at a witness service created using the library found here. The first URL expected is for instructions retrieval, the second is for statement generation, the third is for JWT credential generation, and the fourth for LD credential generation.
The instructions and statement URLs are required and at least one of the two optional URLs must be provided. All of the following would be valid:
import { Client } from "@rebase-xyz/rebase-client";
const statementUrl = "https://example.com/statement";
const instructionsUrl = "https://example.com/instructions";
const jwtUrl = "https://example.com/witness/jwt";
const ldUrl = "https://example.com/witness/ld";
let client = new Client(instructionsUrl, statementUrl, jwtUrl);
client = new Client(instructionsUrl, statementUrl, jwtUrl, null);
client = new Client(instructionsUrl, statementUrl, null, ldUrl);
client = new Client(instructionsUrl, statementUrl, jwtUrl, ldUrl);
All of the following (and more!) would be invalid.
client = new Client();
client = new Client(null, null);
client = new Client(null, null, null, null);
client = new Client(null, statementUrl, jwtUrl, null);
client = new Client(instructionsUrl, null, jwtUrl, null);
client = new Client(null, null, jwtUrl);
client = new Client(null, statementUrl, jwtUrl, ldUrl);
client = new Client(instructionsUrl, null, jwtUrl, ldUrl);
client = new Client(instructionsUrl, statementUrl, null, null);
Once a valid client has been constructed, it can be used like so (where
req
is a JSON stringified valid request):let res = await client.statement(req);
This would produce a JSON stringified version of the
StatementRes
. Instructions requests work the same way using client.instructions
. The exact structure of the responses are detailed in the endpoints document.let jwtRes = await client.jwt(req);
let ldRes = await client.ld(req);
A corresponding
jwtUrl
or ldUrl
must be provided at config time to use jwt
and ld
methods. These would both produce a JSON stringified version of the WitnessJWTRes/WitnessLDRes described in the endpoints document.Once the credential is available to the front end, developers can then store the credential externally or present it to another service that is seeking the information attested to by the credential.
Last modified 5mo ago