Convert a V1 ETH vouch to a V2 WHUF vouch via Ethos Everywhere wallet
POST
/wallets/privy/vouches-v2/conversion/convert
using System.Net.Http.Headers;var clientHandler = new HttpClientHandler{ UseCookies = false,};var client = new HttpClient(clientHandler);var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert"), Headers = { { "cookie", "ethos-access-token=<ethos-access-token>" }, }, Content = new StringContent("{ \"v1VouchId\": 1, \"funding\": \"swap\", \"topUpAmount\": \"example\", \"vouchAmount\": \"example\", \"displayedMinimumBuyAmount\": \"example\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}package main
import ( "fmt" "strings" "net/http" "io")
func main() {
url := "https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert"
payload := strings.NewReader("{ \"v1VouchId\": 1, \"funding\": \"swap\", \"topUpAmount\": \"example\", \"vouchAmount\": \"example\", \"displayedMinimumBuyAmount\": \"example\" }")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("cookie", "ethos-access-token=<ethos-access-token>") req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{ \"v1VouchId\": 1, \"funding\": \"swap\", \"topUpAmount\": \"example\", \"vouchAmount\": \"example\", \"displayedMinimumBuyAmount\": \"example\" }");Request request = new Request.Builder() .url("https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert") .post(body) .addHeader("cookie", "ethos-access-token=<ethos-access-token>") .addHeader("Content-Type", "application/json") .build();
Response response = client.newCall(request).execute();import axios from 'axios';
const options = { method: 'POST', url: 'https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert', headers: { cookie: 'ethos-access-token=<ethos-access-token>', 'Content-Type': 'application/json' }, data: { v1VouchId: 1, funding: 'swap', topUpAmount: 'example', vouchAmount: 'example', displayedMinimumBuyAmount: 'example' }};
try { const { data } = await axios.request(options); console.log(data);} catch (error) { console.error(error);}const url = 'https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert';const options = { method: 'POST', headers: { cookie: 'ethos-access-token=<ethos-access-token>', 'Content-Type': 'application/json' }, body: '{"v1VouchId":1,"funding":"swap","topUpAmount":"example","vouchAmount":"example","displayedMinimumBuyAmount":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}use serde_json::json;use reqwest;
#[tokio::main]pub async fn main() { let url = "https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert";
let payload = json!({ "v1VouchId": 1, "funding": "swap", "topUpAmount": "example", "vouchAmount": "example", "displayedMinimumBuyAmount": "example" });
let mut headers = reqwest::header::HeaderMap::new(); headers.insert("cookie", "ethos-access-token=<ethos-access-token>".parse().unwrap()); headers.insert("Content-Type", "application/json".parse().unwrap());
let client = reqwest::Client::new(); let response = client.post(url) .headers(headers) .json(&payload) .send() .await;
let results = response.unwrap() .json::<serde_json::Value>() .await .unwrap();
dbg!(results);}curl --request POST \ --url https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convert \ --header 'Content-Type: application/json' \ --cookie ethos-access-token=<ethos-access-token> \ --data '{ "v1VouchId": 1, "funding": "swap", "topUpAmount": "example", "vouchAmount": "example", "displayedMinimumBuyAmount": "example" }'wget --quiet \ --method POST \ --header 'cookie: ethos-access-token=<ethos-access-token>' \ --header 'Content-Type: application/json' \ --body-data '{ "v1VouchId": 1, "funding": "swap", "topUpAmount": "example", "vouchAmount": "example", "displayedMinimumBuyAmount": "example" }' \ --output-document \ - https://api.ethos.network/api/v2/wallets/privy/vouches-v2/conversion/convertUnvouches the V1 ETH vouch, optionally swaps the refund to WHUF, and creates the V2 vouch for the same target under one wallet lock. Echo re-quotes with a drift guard before dispatching the run. Restricted to vouches authored by the caller’s Ethos Everywhere wallet. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
v1VouchId
required
integer
funding
required
string
topUpAmount
string
vouchAmount
string
displayedMinimumBuyAmount
string | null
Responses
Section titled “Responses”Successful response
Media typeapplication/json
One of:
object
ok
required
boolean
v1VouchId
required
number
refundedWei
required
string
whufReceived
required
string
unvouchTxHash
string
swapTxHashes
required
Array<string>
vouchV2TxHash
required
string
object
ok
required
boolean
stage
required
string
code
required
string
holding
required
string
refundedWei
string
whufReceived
string
unvouchTxHash
string
swapTxHashes
Array<string>
vouchV2TxHash
string
Example
{ "ok": true}Invalid input data
Media typeapplication/json
Invalid input data error (400)
The error information
object
message
required
The error message
string
code
required
The error code
string
issues
An array of issues that were responsible for the error
Array<object>
object
message
required
string
Example
{ "code": "BAD_REQUEST", "message": "Invalid input data", "issues": []}Authorization not provided
Media typeapplication/json
Authorization not provided error (401)
The error information
object
message
required
The error message
string
code
required
The error code
string
issues
An array of issues that were responsible for the error
Array<object>
object
message
required
string
Example
{ "code": "UNAUTHORIZED", "message": "Authorization not provided", "issues": []}Insufficient access
Media typeapplication/json
Insufficient access error (403)
The error information
object
message
required
The error message
string
code
required
The error code
string
issues
An array of issues that were responsible for the error
Array<object>
object
message
required
string
Example
{ "code": "FORBIDDEN", "message": "Insufficient access", "issues": []}Internal server error
Media typeapplication/json
Internal server error error (500)
The error information
object
message
required
The error message
string
code
required
The error code
string
issues
An array of issues that were responsible for the error
Array<object>
object
message
required
string
Example
{ "code": "INTERNAL_SERVER_ERROR", "message": "Internal server error", "issues": []}