> ## Documentation Index
> Fetch the complete documentation index at: https://glide-9da73dea.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`](https://github.com/darshanbathija/axtior-neobank/blob/main/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](https://github.com/darshanbathija/axtior-neobank/issues/new?template=new-connector.yml) 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:

```bash theme={null}
glide partner submit ./my-connector --type=connector
```

**4. Write the contract test**

Extend `ContractTestSuite` from `@repo/connectors-base`:

```ts theme={null}
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](https://glide-9da73dea.mintlify.site/oss/security/license-compatibility.md) 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](https://glide-9da73dea.mintlify.site/oss/connectors/index.md) — every connector currently in the repo.
* [License compatibility](https://glide-9da73dea.mintlify.site/oss/security/license-compatibility.md) — accept / warn / block matrix.
* [Threat model](https://glide-9da73dea.mintlify.site/oss/security/threat-model.md) — T7 (malicious connector PR).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.