Skip to content

Latest commit

 

History

History
522 lines (307 loc) · 14.6 KB

CHANGELOG.md

File metadata and controls

522 lines (307 loc) · 14.6 KB
Raw

@turnkey/http

2.16.0

Minor Changes

  • 4df8914: Version bump corresponding to mono release v2024.10.10. More detailed changelog to follow

2.15.0

Minor Changes

  • 9ebd062: Release OTP functionality

2.14.2

Patch Changes

2.14.1

Patch Changes

2.14.0

Minor Changes

  • 848f8d3: Add new helpers and update types and errors

    • getSignatureFromActivity returns the signature corresponding to a completed activity
    • getSignedTransactionFromActivity returns the signed transaction corresponding to a completed activity
    • assertActivityCompleted checks the state of an activity and throws an error if the activity either requires consensus or is otherwise not yet completed
    • TERMINAL_ACTIVITY_STATUSES is a const containing all terminal activity statuses. Useful for checking on an activity
    • TurnkeyActivityError now uses undefined instead of null
    • Export some additional types: TActivity, TActivityId, TActivityStatus, TActivityType

2.13.0

Minor Changes

  • 93dee46: Add create read write session v2 which allows for user targeting directly from stamp or optional userId in intent

2.12.3

Patch Changes

  • e2f2e0b: Added two new endpoints for deleting private keys and deleting wallets

2.12.2

Patch Changes

2.12.1

Patch Changes

  • f17a229: Update to oauth related endpoints to drop jwks uri from oauth providers

2.12.0

Minor Changes

  • Add Email Auth V2 - Optional invalidate exisiting Email Authentication API keys

2.11.0

Minor Changes

  • Update to use new endpoints. Including CREATE_READ_WRITE_SESSION which allows one shot passkey sessions (returns org information and a credential bundle) and CREATE_API_KEYS_V2 which allows a curve type to be passed (SECP256K1 or P256)

2.10.0

Minor Changes

  • 7a9ce7a: Sync 2024.3.16

2.9.1

Patch Changes

  • Update generated files to latest release: optional pagination options were added to list sub-organization and list wallet account endpoints.

2.9.0

Minor Changes

  • 83b62b5: Sync types for latest release

2.8.0

Minor Changes

  • 46a7d90: Update to v2024.2.1 API: add activities to initialize wallet import, import wallet, delete users, delete private key tags, delete user tags, and list sub-organizations

2.7.1

Patch Changes

  • Update to v2024.2.0 API types: mnemonicLength is now a number instead of a string

2.7.0

Minor Changes

2.6.2

Patch Changes

  • b45a9ac: Include package version in request headers
  • f9d636c: Export VERSION from turnkey/http

2.6.1

Patch Changes

  • 52e2389: Revert version export (#186 and #187)

2.6.0

Minor Changes

  • 0794f41: Add VERSION constant
  • 7a3c890: Add key export support

Patch Changes

  • 4517e3b: Update version string to include package name

2.5.1

Patch Changes

2.5.0

Minor Changes

  • 464ac0e: Update protos for latest release, which includes:

    • Support optional expirations for API keys, configurable via the expirationSeconds parameter.
    • Support Email Auth. Details to follow ⚡️

2.4.2

Patch Changes

2.4.1

Patch Changes

  • Fix universal files to stop using require. Use ES6 imports instead (#178)
  • Updated dependencies [f87ced8]

2.4.0

Minor Changes

  • Use rollup to build ESM and CommonJS, fix ESM support (#174)

Patch Changes

2.3.1

Patch Changes

2.3.0

Minor Changes

  • Sync protos from latest public endpoints

2.2.0

Minor Changes

  • Add ESM to package dist (#154)

Patch Changes

  • ed50a0f: simplify types

2.1.0

Minor Changes

  • bb6ea0b: Update generated files
    • new query endpoints to retrieve wallets (/public/v1/query/list_wallets)
    • new query endpoint to retrieve wallet accounts (/public/v1/query/list_wallet_accounts)

2.0.0

Major Changes

  • Synced protos from mono

Upgrade notes

  • signRawPayload and signTransaction now expect a signWith param instead of privateKeyId previously
  • signRawPayload and signTransaction have been updated to expect a new type: ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2 and ACTIVITY_TYPE_SIGN_TRANSACTION_V2, respectively
  • If you have policies authorizing ACTIVITY_TYPE_SIGN_RAW_PAYLOAD or ACTIVITY_TYPE_SIGN_TRANSACTION specifically, they will need to be updated to authorize ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2 and ACTIVITY_TYPE_SIGN_TRANSACTION_V2 (or better yet, update your policies to allow all signing actions categorically using policy resources and actions. See https://docs.turnkey.com/managing-policies/examples)
  • createSubOrganization now uses ACTIVITY_TYPE_CREATE_SUB_ORGANIZATION_V4 under the hood, which utilizes wallets. The shape of the request has been updated to include the following parameter, wallet. Here's an example:
{
  ...
  wallet: {
    walletName: "Default Wallet",
    accounts: [
      {
        curve: "CURVE_SECP256K1",
        pathFormat: "PATH_FORMAT_BIP32",
        path: "m/44'/60'/0'/0/0",
        addressFormat: "ADDRESS_FORMAT_ETHEREUM",
      },
    ],
  },
}

See https://docs.turnkey.com/concepts/sub-organizations for more details.

1.3.0

Minor Changes

  • Synced protos from mono
  • Adds base URL check during initialization (closes #124)
  • The following are new features additions, fresh out the oven. Still getting them ready for primetime! Refreshed examples to come soon™️. Stay tuned and reach out to the Turnkey team if you have any questions.
    • Wallets:
      • 🟢 ACTIVITY_TYPE_CREATE_WALLET (via /api/v1/submit/create_wallet): create a HD wallet
      • 🟢 ACTIVITY_TYPE_CREATE_WALLET_ACCOUNTS (via /api/v1/submit/create_wallet_accounts): create a wallet account (address)
      • 🟢 ACTIVITY_TYPE_SIGN_RAW_PAYLOAD_V2 (via /api/v1/submit/sign_raw_payload_v2): sign a payload with a specified private key or address
      • 🟢 ACTIVITY_TYPE_SIGN_TRANSACTION_V2 (via /api/v1/submit/sign_transaction_v2): sign a transaction with a specified private key or address
    • Organization features:
      • 🟢 ACTIVITY_TYPE_SET_ORGANIZATION_FEATURE (via /api/v1/submit/set_organization_feature): set an organization feature
      • 🟢 ACTIVITY_TYPE_REMOVE_ORGANIZATION_FEATURE (via /api/v1/submit/remove_organization_feature): remove an organization feature
      • Only one feature supported as of this time; additional documentation to follow.
    • Export private key:
      • 🟡 ACTIVITY_TYPE_EXPORT_PRIVATE_KEY (via /api/v1/submit/export_private_key): export a private key, encrypted to a target public key. We do not yet have CLI or front-end tooling to use this safely; stay tuned!
    • Email recovery:
      • 🟡 ACTIVITY_TYPE_INIT_USER_EMAIL_RECOVERY (via /api/v1/submit/init_user_email_recovery): initialize a new email recovery flow

Note:

  • 🟢: good to go!
  • 🟡: these endpoints are safe to use, but still experimental/unstable. Check back for updates and guidance.

Patch Changes

1.2.0

Minor Changes

  • The createSubOrganization request has been updated under the hood:

    • Calling .createSubOrganization on our HTTP client will trigger an activity of type CREATE_SUB_ORGANIZATION_V3 instead of CREATE_SUB_ORGANIZATION_V2 previously.
    • If there are any policies referencing CREATE_SUB_ORGANIZATION_V2 specifically, they will no longer work out of the box if creating sub-orgs via SDK. These policies will need to be updated to allow CREATE_SUB_ORGANIZATION_V3. See policy examples related to access control here for additional methods of constructing policies.
    • CREATE_SUB_ORGANIZATION_V3 supports everything CREATE_SUB_ORGANIZATION_V2 supports, with the addition of a privateKeys field to atomically create a sub-org with private keys. If no private keys are desired, simply provide an empty array.
    • NOTE: when reading createSubOrganization results, SDK users will now need to look at activity.result.createSubOrganizationResultV3 instead of the previously valid activity.result.createSubOrganizationResult.

1.1.1

Patch Changes

1.1.0

Minor Changes

New exports:

  • new TurnkeyClient. This is now the preferred interface to make Turnkey requests, because it supports both API keys and webauthn-signed requests. It also doesn't rely on global initialization
  • new method to poll requests: createActivityPoller

Deprecation notices:

  • deprecate TurnkeyApi (use TurnkeyClient instead), init, browserInit (no need for them anymore if you're using TurnkeyClient), and withAsyncPolling (use createActivityPoller instead)
  • deprecate SignedRequest in favor of TSignedRequest. Besides the more correct name, TSignedRequest differs in its stamp property. It now stores the stamper header name as well as value, so users do not have to hardcode Turnkey stamp header names (e.g. "X-Stamp-Webauthn").

Update our swagger and generated files to latest versions:

  • new endpoint to update users: /public/v1/submit/update_user
  • pagination limit option has been updated to string instead of number for consistency with other pagination options

Signing is now performed through Turnkey stampers. New dependencies:

1.0.1

Patch Changes

  • 8d1d0e8: Synced protos from mono

1.0.0

Major Changes

  • 46473ec: This breaking change updates generated code to be shorter and more intuitive to read:

    • generated fetchers do not include the HTTP method in their name. For example useGetGetActivity is now useGetActivity, and usePostSignTransaction is useSignTransaction.
    • input types follow the same convention (no HTTP method in the name): TPostCreatePrivateKeysInput is now TCreatePrivateKeysInput.
    • the "federated" request helpers introduced in 0.18.0 are now named "signed" requests to better reflect what they are. FederatedRequest is now SignedRequest, and generated types follow. For example: federatedPostCreatePrivateKeys is now signCreatePrivateKeys, federatedGetGetActivity is now signGetActivity, and so on.

    The name updates should be automatically suggested if you use VSCode since the new names are simply shorter versions of the old one.

Patch Changes

  • 38b424f: Sync public api types

0.18.1

Patch Changes

  • Synced protos from mono

0.18.0

Minor Changes

  • Add support for federated requests (an example is included under sdk/examples/with-federated-passkeys)
  • Routine re-sync protos from mono

0.17.1

Patch Changes

  • Re-sync protos from mono. No public-facing changes.

0.17.0

Minor Changes

  • Added support for ed25519
  • New endpoint to programmatically approve or reject activities (/submit/approve_activity, /submit/reject_activity)
  • New endpoint to programmatically create authenticators (/submit/create_authenticators)
  • New endpoints to update Private Key tags (/submit/update_private_key_tag)
  • New endpoints to update User tags (/submit/update_user_tag)
  • Simplified shape for AuthenticatorParams with a new AuthenticatorParamsV2. To take advantage of this new shape, use ACTIVITY_TYPE_CREATE_USERS_V2 and the new ACTIVITY_TYPE_CREATE_AUTHENTICATORS.

0.16.0

Minor Changes

  • Fix .postGetPrivateKey(...)'s underlying path, while adding @deprecated .postGetPrivateKeyBackwardsCompat(...) for backward compatibility

0.15.0

Minor Changes

  • Export a new helper for offline request signing: sealAndStampRequestBody(...).

0.14.0

Minor Changes

  • Updated the addressFormats enum field in /submit/create_private_keys

0.13.2

Patch Changes

  • New TurnkeyRequestError error class that contains rich error details

0.13.1

Patch Changes

  • Error messages now contain Turnkey-specific error details

0.13.0

Minor Changes

  • New /submit/create_api_only_users endpoint: TurnkeyApi.postCreateApiOnlyUsers(...)
  • Marked TurnkeyApi.postCreateUsers(...) as deprecated
  • Improved documentation on methods (via TSDoc)

0.12.0

Minor Changes

  • Error messages now contain Turnkey-specific error code and message

0.11.0

Minor Changes

  • New /submit/create_users endpoint: TurnkeyApi.postCreateUsers(...)

0.10.0

Minor Changes

  • No public-facing changes

0.9.0

Minor Changes

  • Improved support for React Native runtime (#37)

0.8.1

Patch Changes

  • Switched from undici to cross-fetch to improve bundler compatibility

0.8.0

Minor Changes

  • Added browser runtime support — @turnkey/http is now a universal (isomorphic) package
  • The API fetchers are now exported as namespace TurnkeyApi. PublicApiService has been marked as deprecated, but will remain functional until we hit v1.0.
  • Dropped support for Node.js v14; we recommend using Node v18+

0.7.0

Minor Changes

0.6.0

Minor Changes

  • Improved OpenAPI documentation

0.5.0

Minor Changes

  • Arbitrary message signing

0.4.0

Minor Changes

  • timestamp -> timestampMs

0.3.1

Patch Changes

  • Fix outdated artifact

0.3.0

Minor Changes

  • keyId -> privateKeyId everywhere

0.2.0

Minor Changes

  • Change parameter from keyId to privateKeyId
  • Bump API version to latest Beta

0.1.3

Patch Changes

  • Support runtime config for credentials

0.1.2

Patch Changes

  • Drop internal dev dependency

0.1.1

Patch Changes