Object Types

The Fordefi REST API provides endpoints for accessing the following core objects.

Organization

This resource collection represents the account (or workspace) on Fordefi that contains all your vaults, users, policies, and more. There can be one or more user in an organization. A user can be a member in more than one organization. An organization contains a user directory and a set of managed Vaults.

Learn more

Vaults

This resource collection manages funds. A vault has a single public address but is multi-chain, meaning you can use it across all chains that are compatible with the address and are supported by Fordefi. For example, a single EVM vault can be used on all the EVM chains supported by Fordefi.

Learn more

Vault Groups

This resource collection represents vault groups.

Learn more

Assets

This resource collection represents assets: a native currency or a token. A vault can have multiple assets across multiple chains, all under the same vault address.

Learn more

Transactions

This resource collection represents transactions. A transaction is any object that can be signed cryptographically (with a private key).

In general, it can be one of the following types:

  • EVM Transaction: A native currency transfer or a smart contract call on an EVM-based chain.
  • EVM Message: In which a message is signed for off-chain use on an EVM-based chain.
  • EVM Revoke Allowances: In which you create a transaction request for revoking an ERC-20 allowance.
  • Solana Transaction: A native currency transfer on a Solana-based chain.
  • Cosmos Raw Transaction: A general Cosmos transaction can be used for any transaction on any of the supported Cosmos chains.
  • Black Box Signature: In which a payload is signed for use, external to the Fordefi platform.

Learn more

Users

This resource collection represents users. There are different types of users in the Fordefi platform:

  • Person: A human user of the platform.
  • API User: An API client key that is trying to interact with the platform.
  • API Signer: Used to auto-sign transactions. See Sign Transactions with the API Signer.

In addition, there are three possible user roles, which define the permissions that the user is given: admins, traders, or viewers.

Learn more

User Groups

This resource collection represents user groups.

Learn more

End Users

This resource collection represents end users. End users are the users of a third-party app that embeds cryptographic technology provided by Fordefi.

Learn more

Authorization Tokens

This resource collection represents authorization tokens that allow end users to authenticate with Fordefi.

Learn more

Keysets

This resource collection represents keysets. A keyset is a high-level object that includes the three different key types: EdDSA, ECDSA, and ECDSA-Stark.

Learn more

Blockchains

This resource collection represents blockchains.

Learn more

Webhooks

This resource collection represents webhooks. Webhooks are used to notify your application of events that have occurred in the Fordefi platform.

Learn more

Address Book

This resource collection represents an address book. Address Book is an object that represents a saved blockchain address and its alias.

Learn more