Merge pull request Merit-Systems#295 from Virtual-Protocol/feat/virtuals-facilitator

feat: add virtuals facilitator

Author: shafu0x

apps/scan/public/virtuals.png

@@ -110,6 +110,7 @@ This package includes pre-configured integrations for the following X402 facilit
 | **xEcho**      | BASE          | No        | No                             |
 | **CodeNut**    | BASE          | No        | No                             |
 | **Ultravioleta DAO** | BASE, SOLANA | ✅ Yes    | No                             |
+| **Virtuals**   | BASE          | No        | No                             |
 
 ### Import Individual Facilitators
 
@@ -128,6 +129,7 @@ import {
   xecho,
   codenut,
   ultravioletadao,
+  virtuals
 } from 'facilitators';
 
 // Facilitators requiring setup

packages/facilitators/README.md

@@ -14,3 +14,4 @@ export { questflow, questflowFacilitator } from './questflow';
 export { xecho, xechoFacilitator } from './xecho';
 export { codenut, codenutFacilitator } from './codenut';
 export { ultravioletadao, ultravioletadaoFacilitator } from './ultravioletadao';
+export { virtuals, virtualsFacilitator } from './virtuals';

packages/facilitators/src/facilitators/index.ts

@@ -0,0 +1,28 @@
+import { Network } from '../types';
+import { USDC_BASE_TOKEN } from '../constants';
+
+import type { Facilitator, FacilitatorConfig } from '../types';
+
+export const virtuals: FacilitatorConfig = {
+  url: 'https://acpx.virtuals.io/',
+};
+
+export const virtualsFacilitator = {
+  id: 'virtuals',
+  metadata: {
+    name: 'Virtual Protocol',
+    image: '/virtuals.png',
+    docsUrl: 'https://app.virtuals.io',
+    color: '#15886D',
+  },
+  config: virtuals,
+  addresses: {
+    [Network.BASE]: [
+      {
+        address: '0x80735b3f7808e2e229ace880dbe85e80115631ca',
+        tokens: [USDC_BASE_TOKEN],
+        dateOfFirstTransaction: new Date('2025-11-05'),
+      },
+    ],
+  },
+} as const satisfies Facilitator;

packages/facilitators/src/facilitators/virtuals.ts

@@ -14,6 +14,7 @@ import {
   xechoFacilitator,
   codenutFacilitator,
   ultravioletadaoFacilitator,
+  virtualsFacilitator,
 } from '../facilitators';
 
 import { validateUniqueFacilitators } from './validate';
@@ -36,6 +37,7 @@ const FACILITATORS = validateUniqueFacilitators([
   xechoFacilitator,
   codenutFacilitator,
   ultravioletadaoFacilitator,
+  virtualsFacilitator,
 ]);
 
 export const allFacilitators: Facilitator[] =