> For the complete documentation index, see [llms.txt](https://fifo-docs.gitbook.io/colibri/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fifo-docs.gitbook.io/colibri/colibri-core/plugins.md).

# Core Plugins

Core plugins are built into [`@colibri/core`](/colibri/colibri-core/overview.md) and extend Colibri's internal pipelines without requiring a separate plugin package.

Use core plugins when you want to customize the behavior of built-in steps such as `simulate-transaction` while keeping the standard pipeline flow.

## Available Core Plugins

| Plugin                                                                            | Target                 | Description                                                                              |
| --------------------------------------------------------------------------------- | ---------------------- | ---------------------------------------------------------------------------------------- |
| [Contract Error Matcher](/colibri/colibri-core/plugins/contract-error-matcher.md) | `simulate-transaction` | Converts recognized contract simulation errors into known, human-readable Colibri errors |

## Using Core Plugins

Attach a core plugin with the callable pipeline's `use(...)` method:

```ts
import {
  createContractErrorMatcherPlugin,
  createInvokeContractPipeline,
  NetworkConfig,
} from "@colibri/core";

const invokeContract = createInvokeContractPipeline({
  networkConfig: NetworkConfig.TestNet(),
});

invokeContract.use(
  createContractErrorMatcherPlugin({
    1: {
      message: "Unauthorized",
      details: "The caller is not authorized to run this operation.",
    },
  }),
);
```

Some core plugins also have higher-level client helpers. For contract error matching, call `contract.loadContractErrorsFromWasm(...)` to derive the mapping from a loaded contract spec or WASM, or pass plugins intentionally through [`ContractConfig.plugins`](/colibri/colibri-core/contract/plugins.md#known-contract-errors).

## Related Pages

* [Contract Error Matcher](/colibri/colibri-core/plugins/contract-error-matcher.md)
* [Contract](/colibri/colibri-core/contract.md)
* [SimulateTransaction](/colibri/colibri-core/processes/simulate-transaction.md)
* [Pipelines](/colibri/colibri-core/pipelines.md)