/siwf

Sign-In With Frequency Protocol and Library

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Sign In With Frequency Documentation & Tools

📗 Table of Contents

📖 Sign In With Frequency V2

Sign In With Frequency (SIWF) is the developer documentation and toolset to integrate with Frequency Access, an easy to use custodial social wallet for users on Frequency.

Looking for SIWF v1 resources? Go to the v1 branch.

🚀 Quick Resources

(back to top)

💻 Prerequisites

Using Sign In With Frequency requires:

  • Frequency Provider setup
  • Frequency Node RPC access

(back to top)

🛠 Libraries

These libraries can help make integrating with SIWF easier, but are not required.

TypeScript/JavaScript

The NPM package @projectlibertylabs/siwf offers both CommonJS and ESM exports.

Install

  • NPM: npm i @projectlibertylabs/siwf
  • Yarn: yarn add @projectlibertylabs/siwf

Documentation

See Markdown/GitHub Docs or Live Docs.

(back to top)

⚙️ Development

Documentation

Documentation is written in CommonMark Markdown and converted to HTML via mdBook.

Prerequisites

Local Development

  • Build the signed-request-generator: follow the "Development" and "Build" steps in [tools/signed-request-generator/README.md].
  • Copy the new Generator to the docs directory: rm -Rf docs/src/Generator && cp -a tools/signed-request-generator/build docs/src/Generator
  • cd ../../docs
  • Serve the HTML locally and watch for changes: mdbook serve or mdbook serve -p <port, default 3000>
  • For style edits see: docs/css/overrides.css
  • For changes to the custom preprocessor see: docs/preprocessors/README.md

Deployment

The documentation is deployed to GitHub Pages automatically on merge to main branch.

Library: TypeScript/JavaScript

Library is published on merge to main with a development tag 0.0.0-[SHA:6]. Releases are made via GitHub Releases with tags in the style: vX.Y.Z.

🤝 Contributing

Contributions, issues, and feature requests are welcome!

(back to top)

📝 License

This project is Apache 2.0 licensed.

(back to top)