Hello

I want to use lib65816 in my project, and i am a bit confused on how to use it correctly. Is there any guide or documentation written for it?

Is that Sam Falvo's? He only rarely drops by these days.
https://github.com/sam-falvo/lib65816

I did something minimal with that, once - doesn't make me an expert! Looks like Daryl (8bit) tried it too:
viewtopic.php?f=8&t=4275&p=47961&hilit=run65816#p47961

Or maybe you've found this one
https://github.com/FrancescoRigoni/Lib65816
which is new to me... it's more recent but I'm not sure if it's still active.

Yes, it is Sam Falvo's one. I am just confused a bit about how to use it correctly. Like for example what does the mask parameter do in IRQ call and clear functions? Afaik 65816 has only one irq vector so idk what the mask means in this case. Also how do i provide it with data? Does it have its own internal memory or any events i can use to tie it up into my code?

Did you find this post and the one after? Might be helpful. There's going to be some puzzling-out needed, I suspect. It's late for me, now, but I could look tomorrow, see if I can help at all.
viewtopic.php?p=23982#p23982

Just had a quick look. It looks like Sam anticipated some sort of system-on-chip setup where there are up to a word's worth of IRQ sources. Looks like just using a mask of 1 would be the normal expected story.

Thank you for help i will try to figure it out, i think ill be able to piece stuff together from the posts youve linked. Have a good night!