Vouch logovouch Documentation
Examples

Twitter/X

A step-by-step guide on how to integrate your application with vouch

vouch uses a simple redirect-based flow, similar to OAuth authentication. Your application redirects users to the vouch platform with specific parameters. Users complete verification on their device, and vouch returns a cryptographic proof via webhook and a final user redirect.

In this guide, you'll learn how to:

  1. Configure necessary query parameters
  2. Redirect users to the vouch verification platform
  3. Handle the response

Step 1: Configure query parameters

The following table shows all of the query parameters needed to construct the vouch verification URL. These parameters tell vouch which datasource to use, where to send the proof, and how to handle the user after verification.

Query ParamDescriptionValue
requestIdUnique identifier for the requesta96b2411-3e0d-48f7-b938-15f0b26c50a8
customerIdUUID of the selected customer app1be03be8-5014-413c-835a-feddf4020da2
datasourceIdUUID of the selected datasource: Proof of X followership1cb27231-a559-4f19-8929-463ed90446dd
inputsBase64 encoded datasource params: {"twitter_username":"zkmarek"}eyJ0d2l0dGVyX3VzZXJuYW1lIjoiemttYXJlayJ9
redirectBackUrlURL to redirect the user back to your apphttp://localhost:3000/examples/integration?requestId=a96b2411-3e0d-48f7-b938-15f0b26c50a8
webhookUrlPOST URL to send the WebProofhttps://docs.getvouch.io/api/web-proof/a96b2411-3e0d-48f7-b938-15f0b26c50a8

Step 2: Redirect users to vouch

To trigger web proof generation, redirect the user to the vouch application at app.getvouch.io. The inputs parameter must be base64url encoded.

import { Vouch } from '@getvouch/sdk';

const vouch = new Vouch();

// Base64url encode function
const toBase64 = (str) => {
  return btoa(str)
    .replace(/=/g, "")
    .replace(/\+/g, "-")
    .replace(/\//g, "_");
};

// For datasources with inputs base64 encoding is needed: 
// when no inputs, use: const inputs = "{}";
const inputs = JSON.stringify({ twitter_username: "zkmarek" });

const verificationUrl = vouch.getStartUrl({
  requestId: crypto.randomUUID(),
  datasourceId: "1cb27231-a559-4f19-8929-463ed90446dd", // X - Following data source
  customerId: "1be03be8-5014-413c-835a-feddf4020da2",   // Your unique customer ID
  inputs: toBase64(inputs), // Base64 encoded inputs (optional, depending on data source)  
  redirectBackUrl: `https://docs.getvouch.io/examples/integration`, // Return destination
  webhookUrl: `https://docs.getvouch.io/api/web-proof` // Proof delivery endpoint (optional)
});

// Redirect the user to vouch
window.location.href = verificationUrl;

This code opens the vouch application in a new tab with all of the parameters from Step 1. The user will complete the verification process and be redirected back to your application.

Step 3: Understanding the webhook payload

When user verification is complete, vouch sends a POST request to your webhookUrl with the following structure:

{
  "decodedTranscript": {
    "recv": "HTTP/1.1 200 OK\r\nDate: Tue, 17 Jun 2025 14:40:30 GMT\r\nContent-Type: application/json; charset=utf-8\r\nTransfer-Encoding: chunked\r\nConnection: *****\r\nperf: **********\r\nvary: ******\r\nvary: ***************\r\npragma: ********\r\nexpires: Tue, 31 Mar 1981 05:00:00 GMT\r\nCache-Control: **************************************************************\r\nlast-modified: *****************************\r\nx-frame-options: **********\r\nx-transaction-id: ****************\r\nx-xss-protection: *\r\nx-rate-limit-limit: ***\r\nx-rate-limit-reset: **********\r\ncontent-disposition: ******************************\r\nx-tfe-preserve-body: ****\r\nx-content-type-options: *******\r\nx-rate-limit-remaining: ***\r\nx-twitter-response-tags: ****************\r\nstrict-transport-security: ************************************\r\nx-response-time: ***\r\nx-connection-hash: ****************************************************************\r\ncf-cache-status: *******\r\nSet-Cookie: *******************************************************************************************************************************************************************************************************************************************************************************\r\nServer: ****************\r\nCF-RAY: ********************\r\n\r\n967\r\n{\"data\":{\"user\":{\"result\":{\"__typename\":\"User\",\"id\":\"VXNlcjoxNjYxMjQ5MA==\",\"rest_id\":\"16612490\",\"affiliates_highlighted_label\":{},\"avatar\":{\"image_url\":\"https://pbs.twimg.com/profile_images/692445308668682240/cEqpfN66_normal.jpg\"},\"core\":{\"created_at\":\"Mon Oct 06 11:22:46 +0000 2008\",\"name\":\"zkMarek ⛛\",\"screen_name\":\"zkMarek\"},\"dm_permissions\":{\"can_dm\":true},\"has_graduated_access\":true,\"is_blue_verified\":true,\"legacy\":{\"default_profile\":true,\"default_profile_image\":false,\"description\":\"Founder at @vlayer_xyz\\n\\nFormer founder at:\\n\\ Ethworks (acquired by @Archblock_)\\n\\@elpassion (acquired by @Daftcode_pl)\\n\\https://t.co/2AgPSjRN7T\",\"entities\":{\"description\":{\"urls\":[{\"display_url\":\"getwaffle.io\",\"expanded_url\":\"http://getwaffle.io\",\"url\":\"https://t.co/2AgPSjRN7T\",\"indices\":[122,145]}]},\"url\":{\"urls\":[{\"display_url\":\"youtube.com/@zkmarek\",\"expanded_url\":\"https://youtube.com/@zkmarek\",\"url\":\"https://t.co/H873DW6VMi\",\"indices\":[0,23]}]}},\"fast_followers_count\":0,\"favourites_count\":8136,\"followers_count\":7446,\"friends_count\":611,\"has_custom_timelines\":false,\"is_translator\":false,\"listed_count\":178,\"media_count\":298,\"normal_followers_count\":7446,\"pinned_tweet_ids_str\":[],\"possibly_sensitive\":false,\"profile_banner_url\":\"https://pbs.twimg.com/profile_banners/16612490/1709143486\",\"profile_interstitial_type\":\"\",\"statuses_count\":4863,\"translator_type\":\"none\",\"url\":\"https://t.co/H873DW6VMi\",\"want_retweets\":true,\"withheld_in_countries\":[]},\"location\":{\"location\":\"Warsaw\"},\"media_permissions\":{\"can_media_tag\":true},\"parody_commentary_fan_label\":\"None\",\"profile_image_shape\":\"Circle\",\"privacy\":{\"protected\":false},\"relationship_perspectives\":{\"followed_by\":true,\"following\":true},\"tipjar_settings\":{},\"verification\":{\"verified\":false},\"legacy_extended_profile\":{},\"is_profile_translatable\":false,\"has_hidden_subscriptions_on_profile\":false,\"verification_info\":{\"is_identity_verified\":false,\"reason\":{\"description\":{\"text\":\"This account is verified. Learn more\",\"entities\":[{\"from_index\":26,\"to_index\":36,\"ref\":{\"url\":\"https://help.twitter.com/managing-your-account/about-twitter-verified-accounts\",\"url_type\":\"ExternalUrl\"}}]},\"verified_since_msec\":\"1726790080188\"}},\"highlights_info\":{\"can_highlight_tweets\":true,\"highlighted_tweets\":\"0\"},\"user_seed_tweet_count\":0,\"premium_gifting_eligible\":false,\"business_account\":{},\"creator_subscriptions_count\":0}}}}\r\n0\r\n\r\n",
    "sent": "GET https://x.com/i/api/graphql/jUKA--0QkqGIFhmfRZdWrQ/UserByScreenName?variables=%7B%22screen_name%22%3A%22zkmarek%22%7D&features=%7B%22responsive_web_grok_bio_auto_translation_is_enabled%22%3Afalse%2C%22hidden_profile_subscriptions_enabled%22%3Atrue%2C%22payments_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22subscriptions_verification_info_is_identity_verified_enabled%22%3Atrue%2C%22subscriptions_verification_info_verified_since_enabled%22%3Atrue%2C%22highlights_tweets_tab_ui_enabled%22%3Atrue%2C%22responsive_web_twitter_article_notes_tab_enabled%22%3Atrue%2C%22subscriptions_feature_can_gift_premium%22%3Atrue%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%7D&fieldToggles=%7B%22withAuxiliaryUserLabels%22%3Atrue%7D HTTP/1.1\r\nconnection: *****\r\nsec-ch-ua-platform: *******\r\nx-twitter-auth-type: *************\r\ncontent-type: application/json\r\nx-twitter-client-language: **\r\nx-twitter-active-user: ***\r\ncookie: **********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************\r\nuser-agent: *********************************************************************************************************************\r\nauthorization: ***************************************************************************************************************\r\naccept: */*\r\naccept-encoding: ********\r\nx-csrf-token: ****************************************************************************************************************************************************************\r\nsec-ch-ua: *****************************************************************\r\nx-client-transaction-id: **********************************************************************************************\r\nhost: *****\r\nx-xp-forwarded-for: **********************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************\r\nsec-ch-ua-mobile: **\r\n\r\n"
  },
  "presentationJson": {
    "data": "014000000000000000608f34e34d59c1f464b88fe4175380bc097c6419d46d942fdab48330906a410d34ed0cd8e8dc7a02788df99692dbb3fc4ad8691394a20a88c9db2577e9198c99b65555efcb4229bc69e447c5c014c97e000000000220000000000000007566ef19de5fbfb21c9ab5e71523d1ebb1c7d8f3f4874c4edd5885727fd903390000000001210000000000000002d4cbba990b0c2eb1dd45b29c7d26075299f1ea39317f35140e6ef71e703beda7010000005b7e51680000000000000000730c00005a0e00000200000000000000410000000000000004db06b657a3af2d97d8a82ab42d39a1d44cf75a5b823f6639e58f7d18625e1c3a6e349cac54f054bf04352dcc2edaa6542675b8f418abb63e96026c2df8bfd02503000000022000000000000000a623a18f7689d62751c20595553bda0ea30cddb9b12aeb98914c4da82c89aea90000000000000000010000000000000004000000000000000220000000000000007d07f84d8733445c60701fc0070582ea2334bd650c069aae49d11bd4641d84b3099a609cd03aa16fd6287101aad96a0b58d3225066ecc275aa3e56cb689de00de1a3c9d18de686bffb44c77fa3a728460205000000000000000000000000000000010500000000000000782e636f6d0200000000000000bd03000000000000308203b93082033fa003020102021205752ccb1425da02aa894151628ec57f25c8300a06082a8648ce3d0403033032310b300906035504061302555331163014060355040a130d4c6574277320456e6372797074310b3009060355040313024535301e170d3235303530313137323832325a170d3235303733303137323832315a3010310e300c06035504031305782e636f6d3059301306072a8648ce3d020106082a8648ce3d0301070342000458ddd1ee35f280bd652bc26ec7913de9b3cc0abc7662b134dba4d35b4d4f8e21a7a454804ffa04c3551f56aae6527bc7f0774e93211c5917ac55dff3584c52ada382025530820251300e0603551d0f0101ff040403020780301d0603551d250416301406082b0601050507030106082b06010505070302300c0603551d130101ff04023000301d0603551d0e04160414ae402f62a91de06d30f89c661f2722d93a32d761301f0603551d230418301680149f2b5fcf3c214f9d04b7ed2b2cc4c6708bd2d70d305506082b0601050507010104493047302106082b060105050730018615687474703a2f2f65352e6f2e6c656e63722e6f7267302206082b060105050730028616687474703a2f2f65352e692e6c656e63722e6f72672f30300603551d110429302782072a2e782e636f6d821563646e2e73796e6469636174696f6e2e782e636f6d8205782e636f6d30130603551d20040c300a3008060667810c010201302d0603551d1f042630243022a020a01e861c687474703a2f2f65352e632e6c656e63722e6f72672f37332e63726c30820103060a2b06010401d6790204020481f40481f100ef007500ccfb0f6a85710965fe959b53cee9b27c22e9855c0d978db6a97e54c0fe4c0db0000001968d19fabf000004030046304402206201e7a7ed9e413ee79cbe662eb1670215df38aa6912d7252d5d16c8fe6f54ae02201812600a6923fa0a5b05bc980bd9521d1f5a2191a40af4c35509202181fc1ed7007600af181a28d68ca3e0a98a4c9c67ab09f8bbbc22baaebcb138a3a19dd3f9b6030d000001968d19fe7b0000040300473045022100ff6c24adad230e4521b8f315426bbe581a034fb58fa2e58b62e58a577e5f5c9e022047c814e57fa404c8c53a4d9f1709c28a05fd676ae00d7f6dee1997357041bc63300a06082a8648ce3d0403030368003065023046a93e7c6a32fd37392f2f47ad1b3b0e5a3cae2e8a1ccaf65ee92700291df4a3097ab2c847d81a6e2194a7aa41294e2b023100f1270b2bc3628c155b65b60e9a263572c2efe29c6ee61fd021d9be8328b5517d7b6591c7953eb4aba767da0732c7c4835b04000000000000308204573082023fa003020102021100838f6c63ceb1398c6206628315c9fdde300d06092a864886f70d01010b0500304f310b300906035504061302555331293027060355040a1320496e7465726e65742053656375726974792052657365617263682047726f7570311530130603550403130c4953524720526f6f74205831301e170d3234303331333030303030305a170d3237303331323233353935395a3032310b300906035504061302555331163014060355040a130d4c6574277320456e6372797074310b30090603550403130245353076301006072a8648ce3d020106052b81040022036200040d0b3a8a6b618eb6efdc5f58e7c6424554ab63f66661480a2e5975b481023750b73f1679dc98eca1289772201c2ccfd57c52204e54785b84146bc090ae85ecc051413c5a877f064dd4fe60d1fa6c2de17d951088a208540f991a4ce6ea0aacd8a381f83081f5300e0603551d0f0101ff040403020186301d0603551d250416301406082b0601050507030206082b0601050507030130120603551d130101ff040830060101ff020100301d0603551d0e041604149f2b5fcf3c214f9d04b7ed2b2cc4c6708bd2d70d301f0603551d2304183016801479b459e67bb6e5e40173800888c81a58f6e99b6e303206082b0601050507010104263024302206082b060105050730028616687474703a2f2f78312e692e6c656e63722e6f72672f30130603551d20040c300a3008060667810c01020130270603551d1f0420301e301ca01aa0188616687474703a2f2f78312e632e6c656e63722e6f72672f300d06092a864886f70d01010b050003820201001f729d34454241daa4d0b2b2b8d2264ca751258d42daec364896a3ba1aa4c863d8f02fb3cecb9f67e9a09e19ead40d8a550392ca43849d46f1d5ccbadfbac1022871f7bafe6dcc1b64ceac4c321a12b891fcf2e4e8b2acf417b4ba857180e2837291bdb2f0f7dc9f86f4b71fbf52bd96e0e6493806e9734520de6f7c8e60b3f94c3f2a2310c748ccaf5b95c976ff5bcac4ef16182723bec4359c9fcfc2df0b41905f385c955cff2e6c0a7f6aeddd73810a586f4c3b9cdcc75a93f7e3574467555b11af98115101a8dc88c7d7304d59b869a4dff18e92800ced992366695eca890fd4b1b399f25c51df6cede7aed7ff7f7a0e5795777fe791ad62300cf82e031b98bb79a36a726d85fb2c5820fb7a71b6ed6153490867c75aa1c44381584ad532167bfcb23caa53cca981968d27d69571648808b388135fd0bffee82ac9d909627ddbac14e91a86d4e60f18e8b5cee00184bc3ad5cb8f5434f6f27412fdeeb3f797095ead1e2b505c689e9f259b266e34600f9a779af11fe6f75033b30212f534b476ecc762399871c9a000476fc2950605a9fe571719689669e3b207b44ff8e7c3b6f8b63ac6a9c57895eef355b3b7cc96b4636358e829aaa69b272706f02ad780046edc8bb157ce4bae81f1aa647855f6358e173c4615e194827bc5473eb76b111936c082c6dd3fc41a648890261550c4a78e625d5500fd17a35affece65c27030000004700000000000000304502202286d4ab518a4c34d24c12da1e6b1d19e80d2b0d416874dbbe30c303d65f0908022100bb999dde7a947ee9c133b240ffe2aec20aa70197e32a601a3cc2f69b3356246b00000000b1cbebfb0337dcf24e9e5d0fd6eadd757efd031a2b28555755482d3b7eb53a8968517e5bf4d9aa5cdd5bf74127defc7695b81725cc8dacb7444f574e4752440100000000410000000000000004db06b657a3af2d97d8a82ab42d39a1d44cf75a5b823f6639e58f7d18625e1c3a6e349cac54f054bf04352dcc2edaa6542675b8f418abb63e96026c2df8bfd025771d657359d294f0bb5291df25b7040a0153050000000000004745542068747470733a2f2f782e636f6d2f692f6170692f6772617068716c2f6a554b412d2d30516b71474946686d66525a645772512f55736572427953637265656e4e616d653f7661726961626c65733d25374225323273637265656e5f6e616d652532322533412532327a6b6d6172656b2532322537442666656174757265733d253742253232726573706f6e736976655f7765625f67726f6b5f62696f5f6175746f5f7472616e736c6174696f6e5f69735f656e61626c656425323225334166616c736525324325323268696464656e5f70726f66696c655f737562736372697074696f6e735f656e61626c6564253232253341747275652532432532327061796d656e74735f656e61626c656425323225334166616c736525324325323270726f66696c655f6c6162656c5f696d70726f76656d656e74735f7063665f6c6162656c5f696e5f706f73745f656e61626c656425323225334174727565253243253232727765625f7469706a61725f636f6e73756d7074696f6e5f656e61626c65642532322533417472756525324325323276657269666965645f70686f6e655f6c6162656c5f656e61626c656425323225334166616c7365253243253232737562736372697074696f6e735f766572696669636174696f6e5f696e666f5f69735f6964656e746974795f76657269666965645f656e61626c656425323225334174727565253243253232737562736372697074696f6e735f766572696669636174696f6e5f696e666f5f76657269666965645f73696e63655f656e61626c656425323225334174727565253243253232686967686c69676874735f7477656574735f7461625f75695f656e61626c656425323225334174727565253243253232726573706f6e736976655f7765625f747769747465725f61727469636c655f6e6f7465735f7461625f656e61626c656425323225334174727565253243253232737562736372697074696f6e735f666561747572655f63616e5f676966745f7072656d69756d2532322533417472756525324325323263726561746f725f737562736372697074696f6e735f74776565745f707265766965775f6170695f656e61626c656425323225334174727565253243253232726573706f6e736976655f7765625f6772617068716c5f736b69705f757365725f70726f66696c655f696d6167655f657874656e73696f6e735f656e61626c656425323225334166616c7365253243253232726573706f6e736976655f7765625f6772617068716c5f74696d656c696e655f6e617669676174696f6e5f656e61626c656425323225334174727565253744266669656c64546f67676c65733d25374225323277697468417578696c69617279557365724c6162656c732532322533417472756525374420485454502f312e310d0a636f6e6e656374696f6e3a200d0a7365632d63682d75612d706c6174666f726d3a200d0a782d747769747465722d617574682d747970653a200d0a636f6e74656e742d747970653a206170706c69636174696f6e2f6a736f6e0d0a782d747769747465722d636c69656e742d6c616e67756167653a200d0a782d747769747465722d6163746976652d757365723a200d0a636f6f6b69653a200d0a757365722d6167656e743a200d0a617574686f72697a6174696f6e3a200d0a6163636570743a202a2f2a0d0a6163636570742d656e636f64696e673a200d0a782d637372662d746f6b656e3a200d0a7365632d63682d75613a200d0a782d636c69656e742d7472616e73616374696f6e2d69643a200d0a686f73743a200d0a782d78702d666f727761726465642d666f723a200d0a7365632d63682d75612d6d6f62696c653a200d0a0d0ace0b000000000000485454502f312e3120323030204f4b0d0a446174653a205475652c203137204a756e20323032352031343a34303a333020474d540d0a436f6e74656e742d547970653a206170706c69636174696f6e2f6a736f6e3b20636861727365743d7574662d380d0a5472616e736665722d456e636f64696e673a206368756e6b65640d0a436f6e6e656374696f6e3a200d0a706572663a200d0a766172793a200d0a766172793a200d0a707261676d613a200d0a657870697265733a205475652c203331204d617220313938312030353a30303a303020474d540d0a43616368652d436f6e74726f6c3a200d0a6c6173742d6d6f6469666965643a200d0a782d6672616d652d6f7074696f6e733a200d0a782d7472616e73616374696f6e2d69643a200d0a782d7873732d70726f74656374696f6e3a200d0a782d726174652d6c696d69742d6c696d69743a200d0a782d726174652d6c696d69742d72657365743a200d0a636f6e74656e742d646973706f736974696f6e3a200d0a782d7466652d70726573657276652d626f64793a200d0a782d636f6e74656e742d747970652d6f7074696f6e733a200d0a782d726174652d6c696d69742d72656d61696e696e673a200d0a782d747769747465722d726573706f6e73652d746167733a200d0a7374726963742d7472616e73706f72742d73656375726974793a200d0a782d726573706f6e73652d74696d653a200d0a782d636f6e6e656374696f6e2d686173683a200d0a63662d63616368652d7374617475733a200d0a5365742d436f6f6b69653a200d0a5365727665723a200d0a43462d5241593a200d0a0d0a3936370d0a7b2264617461223a7b2275736572223a7b22726573756c74223a7b225f5f747970656e616d65223a2255736572222c226964223a2256584e6c636a6f784e6a59784d6a51354d413d3d222c22726573745f6964223a223136363132343930222c22616666696c69617465735f686967686c6967687465645f6c6162656c223a7b7d2c22617661746172223a7b22696d6167655f75726c223a2268747470733a2f2f7062732e7477696d672e636f6d2f70726f66696c655f696d616765732f3639323434353330383636383638323234302f63457170664e36365f6e6f726d616c2e6a7067227d2c22636f7265223a7b22637265617465645f6174223a224d6f6e204f63742030362031313a32323a3436202b303030302032303038222c226e616d65223a227a6b4d6172656b20e29b9b222c2273637265656e5f6e616d65223a227a6b4d6172656b227d2c22646d5f7065726d697373696f6e73223a7b2263616e5f646d223a747275657d2c226861735f6772616475617465645f616363657373223a747275652c2269735f626c75655f7665726966696564223a747275652c226c6567616379223a7b2264656661756c745f70726f66696c65223a747275652c2264656661756c745f70726f66696c655f696d616765223a66616c73652c226465736372697074696f6e223a22466f756e6465722061742040766c617965725f78797a5c6e5c6e466f726d657220666f756e6465722061743a5c6e5c75443833445c754443343920457468776f726b7320286163717569726564206279204041726368626c6f636b5f295c6e5c75443833445c75444334392040656c70617373696f6e20286163717569726564206279204044616674636f64655f706c295c6e5c75443833445c75444334392068747470733a2f2f742e636f2f32416750536a524e3754222c22656e746974696573223a7b226465736372697074696f6e223a7b2275726c73223a5b7b22646973706c61795f75726c223a22676574776166666c652e696f222c22657870616e6465645f75726c223a22687474703a2f2f676574776166666c652e696f222c2275726c223a2268747470733a2f2f742e636f2f32416750536a524e3754222c22696e6469636573223a5b3132322c3134355d7d5d7d2c2275726c223a7b2275726c73223a5b7b22646973706c61795f75726c223a22796f75747562652e636f6d2f407a6b6d6172656b222c22657870616e6465645f75726c223a2268747470733a2f2f796f75747562652e636f6d2f407a6b6d6172656b222c2275726c223a2268747470733a2f2f742e636f2f48383733445736564d69222c22696e6469636573223a5b302c32335d7d5d7d7d2c22666173745f666f6c6c6f776572735f636f756e74223a302c226661766f7572697465735f636f756e74223a383133362c22666f6c6c6f776572735f636f756e74223a373434362c22667269656e64735f636f756e74223a3631312c226861735f637573746f6d5f74696d656c696e6573223a66616c73652c2269735f7472616e736c61746f72223a66616c73652c226c69737465645f636f756e74223a3137382c226d656469615f636f756e74223a3239382c226e6f726d616c5f666f6c6c6f776572735f636f756e74223a373434362c2270696e6e65645f74776565745f6964735f737472223a5b5d2c22706f737369626c795f73656e736974697665223a66616c73652c2270726f66696c655f62616e6e65725f75726c223a2268747470733a2f2f7062732e7477696d672e636f6d2f70726f66696c655f62616e6e6572732f31363631323439302f31373039313433343836222c2270726f66696c655f696e7465727374697469616c5f74797065223a22222c2273746174757365735f636f756e74223a343836332c227472616e736c61746f725f74797065223a226e6f6e65222c2275726c223a2268747470733a2f2f742e636f2f48383733445736564d69222c2277616e745f7265747765657473223a747275652c227769746868656c645f696e5f636f756e7472696573223a5b5d7d2c226c6f636174696f6e223a7b226c6f636174696f6e223a22576172736177227d2c226d656469615f7065726d697373696f6e73223a7b2263616e5f6d656469615f746167223a747275657d2c227061726f64795f636f6d6d656e746172795f66616e5f6c6162656c223a224e6f6e65222c2270726f66696c655f696d6167655f7368617065223a22436972636c65222c2270726976616379223a7b2270726f746563746564223a66616c73657d2c2272656c6174696f6e736869705f706572737065637469766573223a7b22666f6c6c6f7765645f6279223a747275652c22666f6c6c6f77696e67223a747275657d2c227469706a61725f73657474696e6773223a7b7d2c22766572696669636174696f6e223a7b227665726966696564223a66616c73657d2c226c65676163795f657874656e6465645f70726f66696c65223a7b7d2c2269735f70726f66696c655f7472616e736c617461626c65223a66616c73652c226861735f68696464656e5f737562736372697074696f6e735f6f6e5f70726f66696c65223a66616c73652c22766572696669636174696f6e5f696e666f223a7b2269735f6964656e746974795f7665726966696564223a66616c73652c22726561736f6e223a7b226465736372697074696f6e223a7b2274657874223a2254686973206163636f756e742069732076657269666965642e204c6561726e206d6f7265222c22656e746974696573223a5b7b2266726f6d5f696e646578223a32362c22746f5f696e646578223a33362c22726566223a7b2275726c223a2268747470733a2f2f68656c702e747769747465722e636f6d2f6d616e6167696e672d796f75722d6163636f756e742f61626f75742d747769747465722d76657269666965642d6163636f756e7473222c2275726c5f74797065223a2245787465726e616c55726c227d7d5d7d2c2276657269666965645f73696e63655f6d736563223a2231373236373930303830313838227d7d2c22686967686c69676874735f696e666f223a7b2263616e5f686967686c696768745f747765657473223a747275652c22686967686c6967687465645f747765657473223a2230227d2c22757365725f736565645f74776565745f636f756e74223a302c227072656d69756d5f67696674696e675f656c696769626c65223a66616c73652c22627573696e6573735f6163636f756e74223a7b7d2c2263726561746f725f737562736372697074696f6e735f636f756e74223a307d7d7d7d0d0a300d0a0d0a1000000000000000000000000000000019040000000000001e0400000000000034040000000000003b0400000000000052040000000000005f040000000000009c040000000000009e04000000000000b704000000000000ba04000000000000c4040000000000009207000000000000a007000000000000150800000000000026080000000000009508000000000000b508000000000000bd08000000000000cd080000000000006d090000000000007a09000000000000bb09000000000000d609000000000000340a0000000000003c0a000000000000410a000000000000570a000000000000590c0000000000006d0c0000000000006f0c000000000000730c000000000000190000000000000000000000000000008d0000000000000092000000000000009a00000000000000a400000000000000ac00000000000000b200000000000000ba00000000000000c900000000000000d300000000000000db00000000000000140100000000000052010000000000006301000000000000800100000000000093010000000000009d01000000000000b101000000000000c101000000000000d501000000000000d601000000000000ec01000000000000ef0100000000000005020000000000000f02000000000000260200000000000044020000000000005b020000000000005f02000000000000790200000000000080020000000000009a020000000000009d02000000000000b802000000000000c802000000000000e50200000000000009030000000000001c030000000000001f030000000000003403000000000000740300000000000087030000000000008e030000000000009c03000000000000ab04000000000000b504000000000000c504000000000000cf04000000000000e3040000000000005a0e000000000000730c0000000000005a0e00000000000001022900000000000000000000000000000029000000000000000c00000000000000000000000100000000000000410a000000000000570a0000000000002bc330432ffa0d352e2cbd0c6988bfbb030000000000000001000000010000000000000080020000000000009a02000000000000c7f7e5a992c5b2b3a4c30a8448f1612e1a00000000000000010000000100000000000000ab04000000000000b50400000000000074442dc0c0f7fef38e17173fd07b3adf1300000000000000010000000100000000000000db0000000000000014010000000000008227bb3e699fc3bfe459fb44991318292500000000000000010000000100000000000000c504000000000000cf04000000000000d29d627e8ca485bdd731780edb306a2b05000000000000000000000001000000000000001e040000000000003404000000000000866584b55afcab82b6cbba3f721889aa190000000000000000000000010000000000000015080000000000002608000000000000b54021992bba3c624e3ff18820d2a8470800000000000000010000000100000000000000e3040000000000005a0e0000000000004ec758d7d82b76589ee311a330fb3cdd2600000000000000000000000100000000000000590c0000000000006d0c000000000000daf9a9373bb43005cb9370ad55e5ac5d1d00000000000000000000000100000000000000340a0000000000003c0a000000000000bac1bde9389b46356fe69a25b20a9049040000000000000001000000010000000000000074030000000000008703000000000000b426532e923faf3c5fa3d1fa27c51b55240000000000000001000000010000000000000092000000000000009a000000000000007a3800adba18997c863e7f11e9c7c4de0200000000000000000000000100000000000000bd08000000000000cd08000000000000db6986c852a712b0f23797e07c644ceb17000000000000000100000001000000000000009d02000000000000b8020000000000004d1d5254590382c4cf2c540d9d22215311000000000000000000000001000000000000000000000000000000190400000000000038e31ad3a9d3a45dd0eab8db232d9b8400000000000000000000000001000000000000006f0c000000000000730c000000000000d0d5c9b3e1083418c09f8def079b9fe30f000000000000000000000001000000000000006d090000000000007a0900000000000035bdb45ec3d4129e6a3c03925de348571e00000000000000010000000100000000000000b200000000000000ba0000000000000060c1ace87fb8e7b2e5d2770a6190249b140000000000000001000000010000000000000000000000000000008d00000000000000a57d08fb7a76c02365609d17ffe7d8062300000000000000010000000100000000000000d601000000000000ec010000000000000b109bfb508af3523f9ef9ca8a60c4170a00000000000000010000000100000000000000ef010000000000000502000000000000ffdac508c8586497b2c71d4c178f2e7215000000000000000100000001000000000000005201000000000000630100000000000013fc54341f0610c19228c9742944608f1800000000000000010000000100000000000000a400000000000000ac00000000000000493e012fbaac220f61a008c19952525a1b000000000000000000000001000000000000009207000000000000a0070000000000000ef5930cec9758eaa395baeb7740d5792000000000000000010000000100000000000000c802000000000000e5020000000000006391ad22bb7587145593fcd1788eea0b12000000000000000000000001000000000000009508000000000000b5080000000000001b332f1e5f69673eb09dae79ed762d701f000000000000000100000001000000000000008e030000000000009c0300000000000046859f16733d616306317c0f90179851160000000000000001000000010000000000000044020000000000005b0200000000000030c6243a516b1cb42ae926b87fdafd1a0e00000000000000000000000100000000000000ba04000000000000c4040000000000007722ba0a733e412d00b4c2a53d81db480100000000000000010000000100000000000000c101000000000000d501000000000000eeed8df5a1f726c9060cae8d8a76efcf0d000000000000000100000001000000000000005f020000000000007902000000000000fd8f4b3b4785d11b360016847834dd0227000000000000000100000001000000000000009d01000000000000b1010000000000003fab6a1579b9fc5b33c0c1f91a9a6d951000000000000000010000000100000000000000800100000000000093010000000000009498435f9fc430ad81ac38e0a2e5afd5070000000000000001000000010000000000000009030000000000001c03000000000000461d3babab236549a8aeb3522b160f450b00000000000000000000000100000000000000bb09000000000000d609000000000000dcca83ffc87a6f35ef3e6af5379d623509000000000000000100000001000000000000000f020000000000002602000000000000ab53583da5fff6262104330db09b7cf022000000000000000000000001000000000000009e04000000000000b704000000000000f5323914ee28a8cb284328d93de6685e21000000000000000100000001000000000000001f030000000000003403000000000000c48034e358a7811bb6ae9f95cdef83130600000000000000010000000100000000000000c900000000000000d3000000000000008d1130fb5e3bfe84ce7f59334ed183f928000000000000000000000001000000000000003b040000000000005204000000000000dbc98f724403998a9e5693ea31178ef01c000000000000000000000001000000000000005f040000000000009c0400000000000076688ba45d6b2808dc7e374077ab0de40000000000000000",
    "meta": {
      "notaryUrl": "https://test-notary.vlayer.xyz",
      "websocketProxyUrl": "wss://test-wsproxy.vlayer.xyz?token=x.com"
    },
    "version": "0.1.0-alpha.11"
  },
  "outputs": {
    "Followee": "zkMarek",
    "Is following": true
  }
}

Payload structure

  • decodedTranscript: Contains the HTTP request/response that proves the verification

    • recv: The HTTP response received from X/Twitter
    • sent: The HTTP request sent to X/Twitter's API

  • presentationJson: Cryptographic proof data for independent verification

    • data: Hex-encoded proof data
    • meta: Metadata about the notary service and verification process

  • outputs: The final extracted and verified data results from the notarized HTTP request

Step 4: Test the verification flow

Try the button below to see the complete vouch verification flow in action.

Prerequisite

To run the following example, install the vlayer extension.

Proof of Address

A step-by-step guide on how to verify physical addresses in your application with vouch.

Available data sources

Next Page