oscaBlend API

Base URL: https://backend.oscastack.com

This API allows external services to interact with the oscaBlend system to create and track anonymized Ethereum transactions.

---

POST /api/blend/transaction

Create a new blending transaction.

Request

Endpoint: https://backend.oscastack.com/api/blend/transaction Method: POST Content-Type: application/json

Body Parameters

Name	Type	Required	Description
amount	number	Yes	The amount of ETH to be blended
recipient	string	Yes	A valid Ethereum address to receive ETH

Example Request

{
  "amount": 1,
  "recipient": ""
}

Successful Response

{
  "address": "",
  "amount": 1,
  "deadline": 1717459200,
  "fromType": "ETH",
  "id": "",
  "recipient": "",
  "status": "PENDING",
  "toType": "ETH"
}

Error Responses

• 400 - Parameters missing

• 400 - "amount" is required

• 400 - "recipient" is required

• 400 - "amount" is not a number

• 400 - "recipient" is not a valid address

---

GET /api/blend/status/:id

Retrieve the current status of a specific blend transaction.

Request

Endpoint: https://backend.oscastack.com/api/blend/status/:id Method: GET

URL Parameters

Name	Type	Required	Description
id	string	Yes	The unique ID of the blend session

Example Request

GET https://backend.oscastack.com/api/blend/status/ca262721-f442-4e97-bf8a-65b8d6109a9a

Successful Response

{
  "address": "",
  "amount": 1,
  "deadline": 1717459200,
  "fromType": "ETH",
  "id": "ca262721-f442-4e97-bf8a-65b8d6109a9a",
  "recipient": "",
  "status": "FINISHED",
  "toType": "ETH"
}

Error Responses

• 404 - Transaction does not exist

---

Status Values

Status	Description
WAIT_FOR_DEPOSIT	The transaction has been initiated
TIMEOUT	The blending process was timed out
FINISHED	The blending process is completed
FAILED	An error occurred during processing

---

Notes

• All blending operations are executed using internal Ethereum wallets managed by oscaBlend.

• Each transaction ensures privacy by using separate on-chain accounts for deposit and withdrawal.