wwWallet core documentation
    Preparing search index...

    wwWallet core documentation

    wwWallet core

    wwWallet core is a set of packages to suppport the implementation of issuers / wallets / verifiers required logic to manage authorization grants up to verifiable credentials in a secure and privacy preserving way.

    • node v22+
    • browser TBD
    pnpm install
    pnpm build

    Server static configuration can be edited given the example config.yml file.

    pnpm run start:client
    

    Or with Docker:

    docker compose up
    

    This server exposes a token endpoint implementing client credentials, those are checked against the clients registered in the configuration. Requesting the server using cURL, you obtain an access token (or an error) following the OAuth 2.0 specification.

    curl -X POST http://localhost:5000/token \
    --data '{"client_id": "CLIENT123", "client_secret": "321TNEILC", "scope": "client:scope", "grant_type": "client_credentials"}' \
    -H 'Content-Type: application/json'
    {"access_token":"eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2Q0JDLUhTNTEyIn0..BkXrAwHsE0Br1nxUkvezLw.Bq3JWgmHgZfI-RVK_NVu79PJqB0cqqqO9GBc5uMmMLekxmEEnGe1wetR6jAHFSjSVFVUZ2SNXBoe49eeucHfYPOrdKg-j-v1AVx8EKvl4CUhX6F_Z09d_ZYJ1Yw_d3Cnd9rND1nCbv0DLi56w8h6VN7GBDLfAwikCB6RHAHJNMwfinLo6LHqnY1fBde1dPkh.YH3pGiwkHRaNmG14tGdimjWmR66ixHsZ1QTjmUz0_24","expires_in":60,"token_type":"bearer"}
    pnpm test
    

    In order to perform load tests, here k6 is used to simulate user requests.

    k6 run scripts/loadtest.oid4vci.k6.js
    

    Or with Docker:

    docker compose up k6 --no-log-prefix
    

    A reference documentation can be generated from command line which would be accessible at docs/index.html. The master branch doccumentation is available at https://sirosfoundation.github.io/wwwallet-core/

    pnpm run documentation:start
    
    pnpm --filter [PACKAGE NAME] [COMMAND ...]
    # Example:
    # pnpm --filter @wwwallet/server-core add -D vitest

    Please read ./.changeset/README.md For information about changelog and versioning.

    pnpm run dependency-tree
    

    Generated dependency trees are available here

    The source code is released under a BSD-2 clause license