Adding a connector

Partner-PR flow for adding a new vendor adapter at packages/connectors/<slug>/. Trust tiers, 8-gate CI matrix, scaffolding, contract tests.

Extending Glide with a new vendor connector is a five-step partner-PR flow. The full source of truth is CONTRIBUTING.md; this page summarizes the connector-specific path.

Trust tiers

Tier	When
community	Any first PR. Off by default; requires GLIDE_ALLOW_COMMUNITY_CONNECTORS=true + a red admin banner. Open contribution; no signed agreement required.
verified	Reviewed against the Verified-tier checklist + accepted Trusted Partner Agreement. Ships enabled with per-tenant opt-in. Tier promotion is a separate PR.
core	Glide-maintained reference implementations. Tier promotion requires CODEOWNERS approval.

Five-step flow

1. Open a New connector issue first

   Use the new-connector issue template so we can flag any compliance / regulatory concerns before you write code. Include vendor name, slug, capabilities, regions, regulatory posture, and rationale.

2. Read the _base/ interfaces

   Capability contracts live at packages/connectors/_base/src/capabilities/. Pick the subset your vendor implements:

   • orchestration — fiat ↔ crypto conversion.
   • kyc — identity verification.
   • card — card issuance.
   • screening — sanctions / AML lookup.
   • chain-receipt — on-chain confirmation reads.
   • balance — multi-chain balance reads.
   • auth — token verification.
   • banking — direct bank-rail (ACH / wire / SWIFT).
   • qr-gateway — QR-code merchant payments.
   • And 5 more (oauth-authorization-server, attestation, merkle-anchor, timelock-module, recovery).
3. Scaffold the package

   packages/connectors/<slug>/
   ├── package.json
   ├── tsconfig.json
   ├── eslint.config.mjs
   ├── icon.svg
   ├── README.md
   ├── COMPLIANCE.md
   ├── DISCLAIMER.md (required if vendor ToS is unclear on adapter redistribution)
   ├── src/
   │   ├── manifest.ts        // ConnectorManifest (Zod-validated)
   │   ├── credentials.ts     // Zod schema for env keys
   │   ├── legacy.ts          // adapter implementation
   │   └── __tests__/
   │       └── contract.test.ts
   

   Or use the CLI:

   glide partner submit ./my-connector --type=connector
   
4. Write the contract test

   Extend ContractTestSuite from @repo/connectors-base:

   import { ContractTestSuite } from '@repo/connectors-base';
   import { manifest } from '../manifest';
   import { MyVendorAdapter } from '../legacy';
   
   class MyVendorSuite extends ContractTestSuite {
     readonly manifest = manifest;
     readonly runtime = {
       orchestration: new MyVendorAdapter(),
     };
   }
   

   The test asserts manifest validity + capability presence + egress-host invariant (every host the connector touches must appear in manifest.egressHosts).

5. Submit the PR

   All eight CI gates must pass:

   1. DCO sign-off check.
   2. Signed-commits check (Verified tier and above).
   3. Manifest schema validation.
   4. Contract-test runner.
   5. License scan (.github/workflows/license-scan.yml).
   6. Supply-chain scan (.github/workflows/supply-chain-scan.yml).
   7. Egress-host lint (.github/workflows/egress-host-lint.yml).
   8. Compliance review (counsel sign-off for verified-tier promotions).

   See License compatibility for the matrix.

Review SLA

• Community-tier: 5 business days.
• Verified-tier promotion: 10 business days (includes Trusted Partner Agreement review).

Reading list

• Connector catalog — every connector currently in the repo.
• License compatibility — accept / warn / block matrix.
• Threat model — T7 (malicious connector PR).