Quick Reference

Installation

# Run Graftcode Gateway
gg.exe --runtime <your_runtime> --modules <your_backend_library>

# Install a Graft (command from Graftcode Vision)
npm install @graft/nuget-EnergyPrice --registry=http://grft.dev/<project-id>__graftcode

Basic Usage

import { EnergyService } from "@graft/nuget-EnergyPrice";

const energy = new EnergyService();

const price = await energy.getCurrentPrice("DE");

Configuration

GraftConfig (code)

import { GraftConfig } from "@graft/nuget-EnergyPrice";

GraftConfig.host = "tcp://energy-service:9000";

Graft Connection String

GraftConfig.setConfig("name=@graft/nuget-EnergyPrice;runtime=netcore;host=ws://localhost:8004/ws");

Environment Variables

Configuration can also be supplied via environment variables or config files, applied per Graft or globally. See Configuring a Graft for details.

Integration Scenarios

Frontend <-> Backend

import { BackendService } from "@graft/nuget-Backend";

const backend = new BackendService();
const data = await backend.getData();

AI <-> Backend (MCP)

Services hosted on Graftcode Gateway can be exposed as MCP tools for AI clients without rewriting APIs. See MCP Hosting and AI Tools.

Monolith <-> Microservice

Switching between in-memory and remote execution is a configuration change, not a code change. Point GraftConfig.host at a remote Gateway or leave it unset for in-memory execution.

Error Handling

try {
  const result = await service.method(params);
} catch (error) {
  // Exceptions from the target runtime are propagated
  // as strongly typed errors in the calling language
}

Testing

Unit Test

const service = new EnergyService();
const price = await service.getCurrentPrice("DE");
expect(price).toBeDefined();

Mock Service

jest.mock("@graft/nuget-EnergyPrice", () => ({
  EnergyService: jest.fn().mockImplementation(() => ({
    getCurrentPrice: jest.fn().mockResolvedValue(0.32),
  })),
}));

Common Commands

# Start Graftcode Gateway
gg.exe --runtime <your_runtime> --modules <your_backend_library>

Troubleshooting

Issue	Solution
Gateway won't start	Check port availability and runtime path
Connection failed	Verify `GraftConfig.host` value
Type errors	Regenerate Graft package
Method not found	Check that the method is public