Docs
FAQs

FAQs

What is Vertex?
Vertex is Web of Trust as a Service built on top of the nostr social graph. It provides reputation scores to offer personalized discovery and recommendations, as well as protection against impersonations and spam.
How can I integrate Vertex into my app?

We provide DVMs that make doing social graph analysis as simple as publishing an event. Check out our services and hit our relay at:

wss://relay.vertexlab.io

If you need help, don’t hesitate to ask Pip.

How does Vertex work?
Vertex continuously processes profile events from the nostr network and applies ranking algorithms like Pagerank to determine reputation scores.
How often do you update the reputational scores?
Thanks to our advanced algorithms, we calculate the scores in real-time using the latest available data from a wide array of relays.
Can I use Vertex to filter out spam?
Yes, our services can help you prioritize reputable users, power-up discovery and filter out low-quality content. Learn how here
Can I choose the algorithm?

Yes, you simply need to specify it in the sort param of the request. We currently support followerCount, globalPagerank, and personalizedPagerank.

To learn more, check out our algorithms.

What do you mean by “global”
On nostr there is no global state. However, our crawler gathers profile data from multiple relays to provide the most comprehensive view of the network. To maintain data quality and prevent spam attacks, we implement systems that filter out low-quality profiles and mitigate abuse.
Do I always need to connect to get a result?
DVMs return signed nostr events that can be cached by clients, shared between them, kept locally for offline usage and so on.
Is Vertex open source?

Yes, we have proudly open sourced all of our code here on our Github.

We are committed to open standards, and that’s why our services are structured as NIP-90 Data Vending Machines.

Is Vertex trustless?

All Vertex responses are cryptographically signed. However, there is no trustless way to know that a response is legitimate except by running our code on the same data.

We are currently building client-side validation schemes so your users will be able to verify independently.

Does Vertex store any personal data?
Vertex only processes publicly available data from the Nostr network. We respect user privacy and will honor any legitimate requests for content removal.

How many credits do I have left?

Connect to our relay at wss://relay.vertexlab.io and authenticate using NIP-42.

Then request kind:22243 to get your credit balance.

{
    "kind": 22243,
    "tags": [
        ["credits", "9847"],
        ["lastRequest", "1746466043"]
    ],
    // ...
}
Do you have any other questions?
Just ask Pip
Algorithms