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

# Canary Protocol

Canary is a protocol built from first principles to bring real-world data on-chain in a secure, performant, and verifiable way. It eliminates unnecessary trust assumptions while maintaining the speed, flexibility, and transparency modern decentralised systems require. 

### **Canary is built on 4 core principles:**

#### **Source to Chain**

Data should always come directly from the original source — never from validators or third parties that could alter it. Canary ensures information flows from the source to the blockchain with complete cryptographic integrity.

\
**Performance**

Data delivery should be instant. Canary is designed for sub-millisecond publishing, enabling real-time updates without compromising security or throughput.

\
**Flexibility**

Developers should be able to bring any data — on-chain or off-chain — directly into smart contracts without limitations. Canary supports full programmability and integration with diverse data sources, making complex use cases simple.

\
**Trust but Verify**

Every data point published through Canary is verifiable by anyone. Just like Bitcoin miners produce blocks that anyone can audit, Canary brings data that is independently verifiable for authenticity and correctness.These principles make Canary the foundation for the next generation of on-chain data — secure, efficient, and universally verifiable.

Canary Nest Oracle can be integrated in either a push oracle fashion or a pull oracle fashion. The updates happen on Canary Nest in less than 1ms and can be propagated through the on-chain contracts or consumed directly with a websocket API as a pull oracle. 

## Quick links

{% content-ref url="/pages/xAkngdm6A5vNPa2S2AQi" %}
[Vision: Canary – The Leading Institutional Oracle for RWAs](/canary/overview/vision-canary-the-leading-institutional-oracle-for-rwas.md)
{% endcontent-ref %}

{% content-ref url="/pages/Wx4pkWlPArEyb02AfG1L" %}
[Integating Canary Nest Oracle (PUSH Based)](/canary/product-guides/integating-canary-nest-oracle-push-based.md)
{% endcontent-ref %}

## Get Started

We've put together some helpful guides for you to get setup with our product quickly and easily.

{% content-ref url="/pages/eGDLcXOxQN8RICk9lyWF" %}
[Deep Dive Nest Oracle](/canary/product-guides/deep-dive-nest-oracle.md)
{% endcontent-ref %}

{% content-ref url="/pages/qR5MpJDt8q2Z82rEts7y" %}
[RISE Testnet Deployment](/canary/product-guides/rise-testnet-deployment.md)
{% endcontent-ref %}

{% content-ref url="/pages/bE26Lyqs06svCsYVvKnb" %}
[Canary Products](/canary/overview/canary-products.md)
{% endcontent-ref %}