Nighttime Peanut Migrations

    @elastosfoundation/did-js-sdk
    TypeScript icon, indicating that this package has built-in type declarations

    2.2.9 • Public • Published

    Elastos DID Typescript SDK

    SDK development workflow

    • From the SDK folder: npm run dev (this enables hot reload when SDK files change)
    • Or npm run build without hot reload.

    Writing tests

    Note: the tests/ folder contains its own package.json and node_modules, and depends on the "external library" @elastosfoundation/did-js-sdk.

    • Open the tests/ folder as root in a different instance of vscode, this is the only way for now to let vscode display typescript types and issues correctly.
    • npm link .. (every time after calling npm install or npm update) from the tests/ folder. This command uses the local version of the DID SDK, that is just in the folder above tests.
    • Run one or several tests using one of the options below.

    Running tests

    Start the simulated DID chain once:

    • From the tests/ folder:
    • npm run simchain

    Several independant options:

    • In vscode, Menu -> Run -> Start debugging

    Or:

    • From the command line (SDK or tests/ folders):
    • npm run test:node

    Or:

    • Using jest runner:
    • Click run or debug directly from the code, above test descriptions.

    Performance issue

    We are still optimizing tests migrated from the Java implementation. Running all tests on an up-to-date CPU can take several hours. The main source of this problem has been located in the BigNumber operations of the Elliptic library and the key operations of the hdkey-secp256r1 library. Since there shouldn't be huge impacts on the runtime code, the selected solution has been to develop an automated CI to automatically run tests remotely. Here are some metrics and graphics to show latency sources:

    Profiling metrics showing 'mul' method latency

    Metrics Source profile data

    Latency from deriveChild hdkey-secp256r1

    Metrics

    Call hierarchy:

    • TestData.getUser1Document
    • TestData.generateKeyPair
    • HDKey.deriveWithPath - derive(hdkey-secp256r1)
      • deriveChild(hdkey-secp256r1)

    Latency from jmulAdd of Elliptic

    Metrics

    Call hierarchy:

    • DIDDocument.isValid
    • DIDDocument.isGenuine
    • DIDDocument.verifyDigest - EcdsaSigner.verify
      • verify(Elliptic)
      • jmulAdd(Elliptic)
      • _wnafMulAdd(Elliptic)

    The DID Adapter

    A DIDAdapter is required to publish transactions to the DID chain. Different environments require different adapters such as:

    From the browser

    Easy way, for mobile or web app developers

    Using the Elastos Essentials Connector that provides a DID Adapter over Wallet connect (to let the wallet app sign transactions):

    Pseudo code:

    let didAdapter = new EssentialsConnector.DIDAdapter();
    DIDBackend.initialize(didAdapter);
    
    // In the connectivity SDK
    class EssentialsConnector.DIDAdapter {
        createdIdTransaction(payload) {
            let web3provider = new WalletConnectWeb3Provider();
            ler web3 = new Web3(web3provider);
            web3.methods.publishDID(payload);
        }
    }
    

    Tests:

    DID SDK tests use a custom adapter with a hardcoded wallet to automate transactions signing and publishing:

    class LocalDIDAdapter {
        createdIdTransaction() {
            let acc = {...privatekey-walletwithtestnetfundsinside...};
            acc.sign();
            publishUsingLocalWeb3Instance();
        }
    }
    
    let didAdapter = new DIDSDK.Tests.LocalDIDAdapter();
    DIDBackend.initialize(didAdapter);
    ```
    
    #### Custom way:
    
    

    class MyDIDAdapter extends DID.DefaultDIDAdapter { createdIdTransaction(payload) { // DO custom RPC call } }

    let didAdapter = new MyDIDAdapter(); DIDBackend.initialize(didAdapter);

    
    ## How to publish to npmjs.com
    
    ### Publishing account (NPM)
    
    - Be a member of organization: @elastosfoundation
    
    ### Useful commands
    
    - `npm adduser` (once)
    - `npm login` (once)
    - Increase version number in package.json
    - `npm publish --access=public`
    

    Keywords

    none

    Install

    npm i @elastosfoundation/did-js-sdk

    DownloadsWeekly Downloads

    279

    Version

    2.2.9

    License

    MIT

    Unpacked Size

    3.03 MB

    Total Files

    87

    Last publish

    Collaborators

    • benjaminpiette
    • raozhiming
    • kpachhai
    • kuit
    • trinity-tech