Keep vanetza-idf in obu-firmware, so a plain clone builds the firmware

obu-firmware builds against the vanetza-idf C-ITS library, which until now
came from the colleague's microbu-esp32c5 tree beside the repository and was
not tracked here, so a clone of this repository could not build the firmware
it ships. The library alone is now part of obu-firmware, as
obu-firmware/external/vanetza-idf: their external/vanetza-idf at commit
cf4b99f, unchanged (9775 files; see its PROVENANCE.md). CMake takes it from
there by default; -DVANETZA_IDF_DIR still points the build elsewhere.

The rest of the colleague's tree (their own VAM firmware, PKI tooling,
station-link Python tools, the V2X2MAP bridge) stays out of this repository
and gitignored; nothing is pushed to their repository. NOTES.md, docs/06,
TODO.md and the pcap verifier's usage line point at the new location.

obu-firmware/external/vanetza-idf/tools/pki/credential_storage.hpp

@@ -0,0 +1,78 @@
+#pragma once
+
+#include "keys.hpp"
+#include <boost/optional/optional.hpp>
+#include <boost/range/any_range.hpp>
+#include <string>
+
+namespace vanetza
+{
+namespace pki
+{
+
+/// \brief Lazy, single-pass view over canonical-hex credential names.
+using CredentialNameRange =
+    boost::any_range<std::string, boost::single_pass_traversal_tag, std::string, std::ptrdiff_t>;
+
+class CredentialStorage
+{
+public:
+    virtual ~CredentialStorage() = default;
+    virtual void store(const PublicKey&, const PrivateKey&) = 0;
+    virtual boost::optional<PrivateKey> fetch(const PublicKey&) = 0;
+    virtual bool discard(const PublicKey&) = 0;
+
+    /// \brief Lazy iteration over the canonical-hex name of every stored credential.
+    virtual CredentialNameRange list() const = 0;
+
+    /// \brief Discard a credential by its canonical-hex name; returns true iff one was removed.
+    virtual bool discard(const std::string& canonical_hex) = 0;
+
+    /// \brief Existence check by canonical-hex name; cheap, no key parsing.
+    virtual bool contains(const std::string& canonical_hex) const = 0;
+};
+
+/**
+ * \brief RAII handle that discards a credential on destruction unless commit() was called.
+ *
+ * Use to bind a freshly generated key to the lifetime of a protocol step:
+ * store now, drop the key if anything throws before the step succeeds.
+ */
+class ScopedCredential
+{
+public:
+    ScopedCredential(CredentialStorage& storage, PublicKey pub) : m_storage(&storage), m_public_key(std::move(pub))
+    {
+    }
+
+    ScopedCredential(CredentialStorage& storage, PublicKey pub, const PrivateKey& priv) : ScopedCredential(storage, pub)
+    {
+        m_storage->store(m_public_key, priv);
+    }
+
+    ~ScopedCredential()
+    {
+        if (m_storage) {
+            m_storage->discard(m_public_key);
+        }
+    }
+
+    // no copy
+    ScopedCredential(const ScopedCredential&) = delete;
+    ScopedCredential& operator=(const ScopedCredential&) = delete;
+    // no move
+    ScopedCredential(ScopedCredential&&) = delete;
+    ScopedCredential& operator=(ScopedCredential&&) = delete;
+
+    void commit()
+    {
+        m_storage = nullptr;
+    }
+
+private:
+    CredentialStorage* m_storage = nullptr;
+    PublicKey m_public_key;
+};
+
+} // namespace pki
+} // namespace vanetza