-
Notifications
You must be signed in to change notification settings - Fork 8
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Participating in the ASMap deployment process and building your own ASMap #16
Comments
I'll definitely read this. |
Hey, @fjahr, thank you for submitting an issue for TABConf 2023! As we get closer to the conference, we will review all the issues, and the chosen ones will be added to the TABConf 2023 schedule: https://github.com/orgs/TABConf/projects/1. I don't expect us to add any issues to the schedule until a month or two before the conference but keep an eye on this in case someone asks questions. Also, please feel free to update the issue description if you'd like to add anything else as we get closer to the conf. |
Hey @fjahr, congratulations, this issue has been accepted for TABConf 2023! It's been added to the official GitHub Project schedule. |
Hey @fjahr , We have added a day, time slot, and length to this issue. Please acknowledge by commenting 'ack'. This will confirm your workshop for TABConf 2023! |
ACK |
We are about a week away from the start of the conference. I'm sending this to all accepted upcoming workshop. Please review and ensure you have a clear, up to date, high level, agenda on this GitHub issue. Please buffer in time to help with unexpected problems and questions. TABConf workshops should aim to involve high levels participation. If you're planning to conduct a live demo, please consider that attendees will require clear instructions on how to prepare for following along, (all steps for setup should be double checked) and any presentation should be structured accordingly. |
Here is the latest version of the agenda and notes for preparation. While we do have several hands-on elements in the workshop, it is also fine if you join without having gone through the preparation steps or even without a laptop. If you have used your laptop for development before, we should able to go through the setup steps in a few minutes together (though we are at the mercy of the conference WIFI :p ). We will also discuss each of the steps as a group, so you should still get a lot out of the participation without a machine to follow along. I am looking forward to seeing you in ATL next week! Agenda
PreparationPlease note that the tools have not been tested on Windows machines and I am unsure if Mandatory1. Get Kartograf
Install python dependencies
2. Install RPKI clientThis tool is used heavily by Kartograf. Be aware that it may not be available for older OS versions. Linux/BSD
macOS
3. Get asmap-toolFor the compression of the asmap file we need the asmap tool from sipa. To get the latest version we also need to switch the branch
4. Get demo filesThis is the raw input data that we will validate as an example. To save us some time, the data is truncated, so don't use the resulting ASMap file for any production nodes!
Now the large source file is stored using Git LFS. Unless you have it set up already you will also need to go through the following additional steps while being in the repo to download the actual file content.
As a final step, unzip the contents of the included
BonusesIf you have more time available and want to be even better prepared, feel free to dive into any of the following suggestions. 1. Refresh your ASMap memoryThis write-up by Gleb in the Bitmex blog is partly outdated but still gives a really nice high-level summary of why we want to use ASMap. If you currently have no idea what ASMap even is or why it's interesting, it would be great if you give this a read (5 min). https://blog.bitmex.com/call-to-action-testing-and-improving-asmap/ 2. Check out ASMap Health Check branch of Bitcoin CoreThis is still an unmerged PR. Assuming you have already checked out Bitcoin Core, installed dependencies etc. If that is not the case please follow the INSTALL readme first.
Ideally, you can build this branch too, to have it ready. To test that it works, run bitcoind with 3. More reading materials
4. Build your own ASMap file with KatografFollow the instructions in the README on how to build an actual ASMap file based on real data. Beware that this is a multistep process that takes many hours and there is currently no convenient way to pause the process, so I would suggest letting this run over night if you want to try. Questions/FeedbackLet me know if you have questions or feedback on this document. I.e. if the setup didn't work for you or if you would like to discuss specific topics that are currently not on the agenda, comment on this issue or ping me on |
Hey @fjahr , I am closing this issue since you have completed the workshop. Thank you for all of the effort you put into it! |
Description
Disclaimer: the process described in the links below are still up for discussion, so details may change.
What is this workshop about? Provide as many details as possible.
We will dive deep into the nuances of internet routing and how this leads us to the insight that using an ASMap file is a good practice for anyone running a node. Then we will discuss how an ASMap file is constructed under the hood, what data sources can be used and what attack vectors exist. We will then practice creating our own ASMap file for use in our personal nodes and review each others ASMap files using publicly available tooling.
What would an attendee learn from this workshop?
Is there anything attendees should read up on before they attend this talk?
They should be familiar with the basic idea of the ASMap feature: https://blog.bitmex.com/call-to-action-testing-and-improving-asmap/ and the more they read the relevant links below, the better, but it's not a prerequisite for successful participation.
If my related talk is accepted it would also be sufficient to just listen to that.
Is there anything attendees should set up before the workshop?
Relevant Links
About the Speaker
I have been contributing to Bitcoin Core since 2019. Among other things I have developed the CoinstatsIndex. In 2022, I have spent some time building a better understanding of the larger internet routing infrastructure. This was necessary to understand and evaluate the potential data sources for ASMap files and create a proposal for ASMap in the Bitcoin Core release process. This effort had been pending since 2020 when the feature was merged as an option. I am also an organizer of the Bitdevs Socratic Seminar in Berlin .
Social Links
Github: https://github.com/fjahr
Twitter: https://twitter.com/fjahr
Website: https://fjahr.com/
Workshop Details
Length of workshop
~2 hours
Preferred Day/Time Slot
No preference
The text was updated successfully, but these errors were encountered: