Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hevn Inc Wallet API

The Wallet API from Hevn Inc — 14 operation(s) for wallet.

Hevn Inc Wallet API is one of 31 APIs that Hevn Inc publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Wallet. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 14 operations across 14 paths, and defines 21 schemas. It is described by OpenAPI 3.1.0, at version 0.1.2.

Requests are made against a single base URL, https://api.hevn.finance.

14 operations 14 paths 21 schemas 1 DELETE4 GET9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.2
Base URL
https://api.hevn.finance/api/v1
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Hevn Inc Wallet API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer). An API key is passed in the header as x-api-key (ApiKeyAuth).

  • ApiKeyAuth — Alternative HEVN API key header. The CLI defaults to Authorization Bearer unless configured with HEVNAPIKEYHEADER=X-Api-Key.

Paths & Operations 14

Across 14 paths, the API surfaces 14 operations — 1 DELETE, 4 GET, 9 POST. Each is listed below with its method, path, parameters, and response codes.

Wallet 14
GET
/api/v1/wallet/address_by_email
Resolve smart wallet address by email
address_by_email_api_v1_wallet_address_by_email_get 2 params → 200422
POST
/api/v1/wallet
Create wallet
create_wallet_api_v1_wallet_post 4 params body → 201422
POST
/api/v1/wallet/import
Import external wallet
import_wallet_api_v1_wallet_import_post 1 param body → 201422
GET
/api/v1/wallet/imported
List imported wallets
list_imported_wallets_api_v1_wallet_imported_get 1 param → 200422
DELETE
/api/v1/wallet/imported/{wallet_id}
Remove imported wallet
delete_imported_wallet_api_v1_wallet_imported__wallet_id__delete 2 params → 204422
POST
/api/v1/wallet/deploy_safe_msig
Deploy Safe 2/2 multisig with passkey + backend EOA
deploy_safe_msig_api_v1_wallet_deploy_safe_msig_post 1 param body → 200422
POST
/api/v1/wallet/paymaster_raw
Push a fully-built UserOperation through EntryPoint.handleOps from the backend EOA
paymaster_raw_api_v1_wallet_paymaster_raw_post 3 params body → 200422
POST
/api/v1/wallet/execute_transaction
Execute transaction
execute_transaction_api_v1_wallet_execute_transaction_post body → 200422
POST
/api/v1/wallet/login
Sign login message
login_api_v1_wallet_login_post 4 params body → 200422
POST
/api/v1/wallet/paymaster
Paymaster
paymaster_api_v1_wallet_paymaster_post 3 params → 200422
GET
/api/v1/wallet/permissions
Get Permissions
get_permissions_api_v1_wallet_permissions_get 1 param → 200422
GET
/api/v1/wallet/passkeys
List user passkeys
list_passkeys_api_v1_wallet_passkeys_get 1 param → 200422
POST
/api/v1/wallet/account_owner
Add account owner extension
account_owner_api_v1_wallet_account_owner_post 2 params body → 200422
POST
/api/v1/wallet/rpc/{chain_id}
Proxy
proxy_api_v1_wallet_rpc__chain_id__post 1 param → 200422

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are SpendPermissionResponse (14 properties), UserOperationV06 (11 properties), PasskeyResponse (10 properties), PaymasterRawResponse (10 properties). Each schema is shown below with its type and property counts.

AccountOwnerResponse
object
Response for /accountowner. If sessionkey is set → OTP required (first step). If transactionhash is set → execution done (second step).
2 properties
ValidationError
object
3 properties 3 required
DeploySafeMsigRequest
object
Request to deploy a 2/2 Safe multisig with passkey + backend EOA owners. x/y are the P-256 public key coordinates of the passkey. Each may be provided as a 0x-…
2 properties 2 required
HTTPValidationError
object
1 property
OneClickChain
string
1click chain codes.
WalletCreateResponse
object
Response after creating a wallet.
4 properties 2 required
WalletCreateRequest
object
Response after creating a wallet.
4 properties 3 required
DeploySafeMsigResponse
object
Response for /wallet/deploysafemsig.
4 properties 3 required
AccountOwnerRequest
object
Request for /accountowner — addextension with OTP confirmation.
3 properties 3 required
PasskeyResponse
object
Response for a single passkey.
10 properties 4 required
PaymasterRawRequest
object
A fully-built ERC-4337 v0.6 UserOperation to push through EntryPoint.handleOps directly from the backend EOA. The backend acts as the bundler itself: it ABI-en…
1 property 1 required
TransactionResponse
object
Response after executing a transaction.
3 properties 1 required
ImportWalletRequest
object
Request to import an external EVM wallet.
6 properties 1 required
UserOperationV06
object
ERC-4337 v0.6 UserOperation in the JSON-RPC ethsendUserOperation shape — camelCase keys (via the CamelModel alias generator), 0x-hex string values for every nu…
11 properties 8 required
SignLoginRequest
object
Request to sign a login message.
2 properties 2 required
OnchainWalletResponse
object
Imported onchain wallet.
9 properties 7 required
PasskeyType
string
Passkey authenticator transport type.
PaymasterRawResponse
object
Response for /wallet/paymasterraw. The backend EOA submitted EntryPoint.handleOps([userOp], beneficiary) on Base mainnet and waited for the receipt. All fields…
10 properties 10 required
PermissionsResponse
object
List of active spend permissions.
1 property 1 required
SpendPermissionResponse
object
Spend permission for a smart wallet.
14 properties 11 required
TransactionRequest
object
Request to execute a signed transaction on wallet contract.
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hevn-inc-wallet-api-openapi.yml Raw ↑

Other APIs Hevn Inc publishes across the network.

Hevn Inc 2FA API
Hevn Inc Activity API
Hevn Inc apps API
Hevn Inc apps-transfer API
Hevn Inc auth API
Hevn Inc B2B API
Hevn Inc Balance API
Hevn Inc Banks API
Hevn Inc Cards API
Hevn Inc Chat API
Hevn Inc contracts API
Hevn Inc Devices API